Google Cloud Classic v7.29.0 published on Wednesday, Jun 26, 2024 by Pulumi
gcp.vertex.getAiIndex
Explore with Pulumi AI
A representation of a collection of database items organized in a way that allows for approximate nearest neighbor (a.k.a ANN) algorithms search.
Using getAiIndex
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getAiIndex(args: GetAiIndexArgs, opts?: InvokeOptions): Promise<GetAiIndexResult>
function getAiIndexOutput(args: GetAiIndexOutputArgs, opts?: InvokeOptions): Output<GetAiIndexResult>
def get_ai_index(name: Optional[str] = None,
project: Optional[str] = None,
region: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetAiIndexResult
def get_ai_index_output(name: Optional[pulumi.Input[str]] = None,
project: Optional[pulumi.Input[str]] = None,
region: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetAiIndexResult]
func LookupAiIndex(ctx *Context, args *LookupAiIndexArgs, opts ...InvokeOption) (*LookupAiIndexResult, error)
func LookupAiIndexOutput(ctx *Context, args *LookupAiIndexOutputArgs, opts ...InvokeOption) LookupAiIndexResultOutput
> Note: This function is named LookupAiIndex
in the Go SDK.
public static class GetAiIndex
{
public static Task<GetAiIndexResult> InvokeAsync(GetAiIndexArgs args, InvokeOptions? opts = null)
public static Output<GetAiIndexResult> Invoke(GetAiIndexInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetAiIndexResult> getAiIndex(GetAiIndexArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: gcp:vertex/getAiIndex:getAiIndex
arguments:
# arguments dictionary
The following arguments are supported:
getAiIndex Result
The following output properties are available:
- Create
Time string - Deployed
Indexes List<GetAi Index Deployed Index> - Description string
- Display
Name string - Effective
Labels Dictionary<string, string> - Etag string
- Id string
- The provider-assigned unique ID for this managed resource.
- Index
Stats List<GetAi Index Index Stat> - Index
Update stringMethod - Labels Dictionary<string, string>
- Metadata
Schema stringUri - Metadatas
List<Get
Ai Index Metadata> - Name string
- Pulumi
Labels Dictionary<string, string> - Region string
- Update
Time string - Project string
- Create
Time string - Deployed
Indexes []GetAi Index Deployed Index - Description string
- Display
Name string - Effective
Labels map[string]string - Etag string
- Id string
- The provider-assigned unique ID for this managed resource.
- Index
Stats []GetAi Index Index Stat - Index
Update stringMethod - Labels map[string]string
- Metadata
Schema stringUri - Metadatas
[]Get
Ai Index Metadata - Name string
- Pulumi
Labels map[string]string - Region string
- Update
Time string - Project string
- create
Time String - deployed
Indexes List<GetAi Index Deployed Index> - description String
- display
Name String - effective
Labels Map<String,String> - etag String
- id String
- The provider-assigned unique ID for this managed resource.
- index
Stats List<GetAi Index Index Stat> - index
Update StringMethod - labels Map<String,String>
- metadata
Schema StringUri - metadatas
List<Get
Ai Index Metadata> - name String
- pulumi
Labels Map<String,String> - region String
- update
Time String - project String
- create
Time string - deployed
Indexes GetAi Index Deployed Index[] - description string
- display
Name string - effective
Labels {[key: string]: string} - etag string
- id string
- The provider-assigned unique ID for this managed resource.
- index
Stats GetAi Index Index Stat[] - index
Update stringMethod - labels {[key: string]: string}
- metadata
Schema stringUri - metadatas
Get
Ai Index Metadata[] - name string
- pulumi
Labels {[key: string]: string} - region string
- update
Time string - project string
- create_
time str - deployed_
indexes Sequence[GetAi Index Deployed Index] - description str
- display_
name str - effective_
labels Mapping[str, str] - etag str
- id str
- The provider-assigned unique ID for this managed resource.
- index_
stats Sequence[GetAi Index Index Stat] - index_
update_ strmethod - labels Mapping[str, str]
- metadata_
schema_ struri - metadatas
Sequence[Get
Ai Index Metadata] - name str
- pulumi_
labels Mapping[str, str] - region str
- update_
time str - project str
- create
Time String - deployed
Indexes List<Property Map> - description String
- display
Name String - effective
Labels Map<String> - etag String
- id String
- The provider-assigned unique ID for this managed resource.
- index
Stats List<Property Map> - index
Update StringMethod - labels Map<String>
- metadata
Schema StringUri - metadatas List<Property Map>
- name String
- pulumi
Labels Map<String> - region String
- update
Time String - project String
Supporting Types
GetAiIndexDeployedIndex
- Deployed
Index stringId - The ID of the DeployedIndex in the above IndexEndpoint.
- Index
Endpoint string - A resource name of the IndexEndpoint.
- Deployed
Index stringId - The ID of the DeployedIndex in the above IndexEndpoint.
- Index
Endpoint string - A resource name of the IndexEndpoint.
- deployed
Index StringId - The ID of the DeployedIndex in the above IndexEndpoint.
- index
Endpoint String - A resource name of the IndexEndpoint.
- deployed
Index stringId - The ID of the DeployedIndex in the above IndexEndpoint.
- index
Endpoint string - A resource name of the IndexEndpoint.
- deployed_
index_ strid - The ID of the DeployedIndex in the above IndexEndpoint.
- index_
endpoint str - A resource name of the IndexEndpoint.
- deployed
Index StringId - The ID of the DeployedIndex in the above IndexEndpoint.
- index
Endpoint String - A resource name of the IndexEndpoint.
GetAiIndexIndexStat
- int
- The number of shards in the Index.
- Vectors
Count string - The number of vectors in the Index.
- int
- The number of shards in the Index.
- Vectors
Count string - The number of vectors in the Index.
- Integer
- The number of shards in the Index.
- vectors
Count String - The number of vectors in the Index.
- number
- The number of shards in the Index.
- vectors
Count string - The number of vectors in the Index.
- int
- The number of shards in the Index.
- vectors_
count str - The number of vectors in the Index.
- Number
- The number of shards in the Index.
- vectors
Count String - The number of vectors in the Index.
GetAiIndexMetadata
- Configs
List<Get
Ai Index Metadata Config> - The configuration of the Matching Engine Index.
- Contents
Delta stringUri - Allows inserting, updating or deleting the contents of the Matching Engine Index. The string must be a valid Cloud Storage directory path. If this field is set when calling IndexService.UpdateIndex, then no other Index field can be also updated as part of the same call. The expected structure and format of the files this URI points to is described at https://cloud.google.com/vertex-ai/docs/matching-engine/using-matching-engine#input-data-format
- Is
Complete boolOverwrite - If this field is set together with contentsDeltaUri when calling IndexService.UpdateIndex, then existing content of the Index will be replaced by the data from the contentsDeltaUri.
- Configs
[]Get
Ai Index Metadata Config - The configuration of the Matching Engine Index.
- Contents
Delta stringUri - Allows inserting, updating or deleting the contents of the Matching Engine Index. The string must be a valid Cloud Storage directory path. If this field is set when calling IndexService.UpdateIndex, then no other Index field can be also updated as part of the same call. The expected structure and format of the files this URI points to is described at https://cloud.google.com/vertex-ai/docs/matching-engine/using-matching-engine#input-data-format
- Is
Complete boolOverwrite - If this field is set together with contentsDeltaUri when calling IndexService.UpdateIndex, then existing content of the Index will be replaced by the data from the contentsDeltaUri.
- configs
List<Get
Ai Index Metadata Config> - The configuration of the Matching Engine Index.
- contents
Delta StringUri - Allows inserting, updating or deleting the contents of the Matching Engine Index. The string must be a valid Cloud Storage directory path. If this field is set when calling IndexService.UpdateIndex, then no other Index field can be also updated as part of the same call. The expected structure and format of the files this URI points to is described at https://cloud.google.com/vertex-ai/docs/matching-engine/using-matching-engine#input-data-format
- is
Complete BooleanOverwrite - If this field is set together with contentsDeltaUri when calling IndexService.UpdateIndex, then existing content of the Index will be replaced by the data from the contentsDeltaUri.
- configs
Get
Ai Index Metadata Config[] - The configuration of the Matching Engine Index.
- contents
Delta stringUri - Allows inserting, updating or deleting the contents of the Matching Engine Index. The string must be a valid Cloud Storage directory path. If this field is set when calling IndexService.UpdateIndex, then no other Index field can be also updated as part of the same call. The expected structure and format of the files this URI points to is described at https://cloud.google.com/vertex-ai/docs/matching-engine/using-matching-engine#input-data-format
- is
Complete booleanOverwrite - If this field is set together with contentsDeltaUri when calling IndexService.UpdateIndex, then existing content of the Index will be replaced by the data from the contentsDeltaUri.
- configs
Sequence[Get
Ai Index Metadata Config] - The configuration of the Matching Engine Index.
- contents_
delta_ struri - Allows inserting, updating or deleting the contents of the Matching Engine Index. The string must be a valid Cloud Storage directory path. If this field is set when calling IndexService.UpdateIndex, then no other Index field can be also updated as part of the same call. The expected structure and format of the files this URI points to is described at https://cloud.google.com/vertex-ai/docs/matching-engine/using-matching-engine#input-data-format
- is_
complete_ booloverwrite - If this field is set together with contentsDeltaUri when calling IndexService.UpdateIndex, then existing content of the Index will be replaced by the data from the contentsDeltaUri.
- configs List<Property Map>
- The configuration of the Matching Engine Index.
- contents
Delta StringUri - Allows inserting, updating or deleting the contents of the Matching Engine Index. The string must be a valid Cloud Storage directory path. If this field is set when calling IndexService.UpdateIndex, then no other Index field can be also updated as part of the same call. The expected structure and format of the files this URI points to is described at https://cloud.google.com/vertex-ai/docs/matching-engine/using-matching-engine#input-data-format
- is
Complete BooleanOverwrite - If this field is set together with contentsDeltaUri when calling IndexService.UpdateIndex, then existing content of the Index will be replaced by the data from the contentsDeltaUri.
GetAiIndexMetadataConfig
- Algorithm
Configs List<GetAi Index Metadata Config Algorithm Config> - The configuration with regard to the algorithms used for efficient search.
- Approximate
Neighbors intCount - The default number of neighbors to find via approximate search before exact reordering is performed. Exact reordering is a procedure where results returned by an approximate search algorithm are reordered via a more expensive distance computation. Required if tree-AH algorithm is used.
- Dimensions int
- The number of dimensions of the input vectors.
- Distance
Measure stringType - The distance measure used in nearest neighbor search. The value must be one of the followings:
- SQUARED_L2_DISTANCE: Euclidean (L_2) Distance
- L1_DISTANCE: Manhattan (L_1) Distance
- COSINE_DISTANCE: Cosine Distance. Defined as 1 - cosine similarity.
- DOT_PRODUCT_DISTANCE: Dot Product Distance. Defined as a negative of the dot product
- Feature
Norm stringType - Type of normalization to be carried out on each vector. The value must be one of the followings:
- UNIT_L2_NORM: Unit L2 normalization type
- NONE: No normalization type is specified.
- string
- Index data is split into equal parts to be processed. These are called "shards".
The shard size must be specified when creating an index. The value must be one of the followings:
- SHARD_SIZE_SMALL: Small (2GB)
- SHARD_SIZE_MEDIUM: Medium (20GB)
- SHARD_SIZE_LARGE: Large (50GB)
- Algorithm
Configs []GetAi Index Metadata Config Algorithm Config - The configuration with regard to the algorithms used for efficient search.
- Approximate
Neighbors intCount - The default number of neighbors to find via approximate search before exact reordering is performed. Exact reordering is a procedure where results returned by an approximate search algorithm are reordered via a more expensive distance computation. Required if tree-AH algorithm is used.
- Dimensions int
- The number of dimensions of the input vectors.
- Distance
Measure stringType - The distance measure used in nearest neighbor search. The value must be one of the followings:
- SQUARED_L2_DISTANCE: Euclidean (L_2) Distance
- L1_DISTANCE: Manhattan (L_1) Distance
- COSINE_DISTANCE: Cosine Distance. Defined as 1 - cosine similarity.
- DOT_PRODUCT_DISTANCE: Dot Product Distance. Defined as a negative of the dot product
- Feature
Norm stringType - Type of normalization to be carried out on each vector. The value must be one of the followings:
- UNIT_L2_NORM: Unit L2 normalization type
- NONE: No normalization type is specified.
- string
- Index data is split into equal parts to be processed. These are called "shards".
The shard size must be specified when creating an index. The value must be one of the followings:
- SHARD_SIZE_SMALL: Small (2GB)
- SHARD_SIZE_MEDIUM: Medium (20GB)
- SHARD_SIZE_LARGE: Large (50GB)
- algorithm
Configs List<GetAi Index Metadata Config Algorithm Config> - The configuration with regard to the algorithms used for efficient search.
- approximate
Neighbors IntegerCount - The default number of neighbors to find via approximate search before exact reordering is performed. Exact reordering is a procedure where results returned by an approximate search algorithm are reordered via a more expensive distance computation. Required if tree-AH algorithm is used.
- dimensions Integer
- The number of dimensions of the input vectors.
- distance
Measure StringType - The distance measure used in nearest neighbor search. The value must be one of the followings:
- SQUARED_L2_DISTANCE: Euclidean (L_2) Distance
- L1_DISTANCE: Manhattan (L_1) Distance
- COSINE_DISTANCE: Cosine Distance. Defined as 1 - cosine similarity.
- DOT_PRODUCT_DISTANCE: Dot Product Distance. Defined as a negative of the dot product
- feature
Norm StringType - Type of normalization to be carried out on each vector. The value must be one of the followings:
- UNIT_L2_NORM: Unit L2 normalization type
- NONE: No normalization type is specified.
- String
- Index data is split into equal parts to be processed. These are called "shards".
The shard size must be specified when creating an index. The value must be one of the followings:
- SHARD_SIZE_SMALL: Small (2GB)
- SHARD_SIZE_MEDIUM: Medium (20GB)
- SHARD_SIZE_LARGE: Large (50GB)
- algorithm
Configs GetAi Index Metadata Config Algorithm Config[] - The configuration with regard to the algorithms used for efficient search.
- approximate
Neighbors numberCount - The default number of neighbors to find via approximate search before exact reordering is performed. Exact reordering is a procedure where results returned by an approximate search algorithm are reordered via a more expensive distance computation. Required if tree-AH algorithm is used.
- dimensions number
- The number of dimensions of the input vectors.
- distance
Measure stringType - The distance measure used in nearest neighbor search. The value must be one of the followings:
- SQUARED_L2_DISTANCE: Euclidean (L_2) Distance
- L1_DISTANCE: Manhattan (L_1) Distance
- COSINE_DISTANCE: Cosine Distance. Defined as 1 - cosine similarity.
- DOT_PRODUCT_DISTANCE: Dot Product Distance. Defined as a negative of the dot product
- feature
Norm stringType - Type of normalization to be carried out on each vector. The value must be one of the followings:
- UNIT_L2_NORM: Unit L2 normalization type
- NONE: No normalization type is specified.
- string
- Index data is split into equal parts to be processed. These are called "shards".
The shard size must be specified when creating an index. The value must be one of the followings:
- SHARD_SIZE_SMALL: Small (2GB)
- SHARD_SIZE_MEDIUM: Medium (20GB)
- SHARD_SIZE_LARGE: Large (50GB)
- algorithm_
configs Sequence[GetAi Index Metadata Config Algorithm Config] - The configuration with regard to the algorithms used for efficient search.
- approximate_
neighbors_ intcount - The default number of neighbors to find via approximate search before exact reordering is performed. Exact reordering is a procedure where results returned by an approximate search algorithm are reordered via a more expensive distance computation. Required if tree-AH algorithm is used.
- dimensions int
- The number of dimensions of the input vectors.
- distance_
measure_ strtype - The distance measure used in nearest neighbor search. The value must be one of the followings:
- SQUARED_L2_DISTANCE: Euclidean (L_2) Distance
- L1_DISTANCE: Manhattan (L_1) Distance
- COSINE_DISTANCE: Cosine Distance. Defined as 1 - cosine similarity.
- DOT_PRODUCT_DISTANCE: Dot Product Distance. Defined as a negative of the dot product
- feature_
norm_ strtype - Type of normalization to be carried out on each vector. The value must be one of the followings:
- UNIT_L2_NORM: Unit L2 normalization type
- NONE: No normalization type is specified.
- str
- Index data is split into equal parts to be processed. These are called "shards".
The shard size must be specified when creating an index. The value must be one of the followings:
- SHARD_SIZE_SMALL: Small (2GB)
- SHARD_SIZE_MEDIUM: Medium (20GB)
- SHARD_SIZE_LARGE: Large (50GB)
- algorithm
Configs List<Property Map> - The configuration with regard to the algorithms used for efficient search.
- approximate
Neighbors NumberCount - The default number of neighbors to find via approximate search before exact reordering is performed. Exact reordering is a procedure where results returned by an approximate search algorithm are reordered via a more expensive distance computation. Required if tree-AH algorithm is used.
- dimensions Number
- The number of dimensions of the input vectors.
- distance
Measure StringType - The distance measure used in nearest neighbor search. The value must be one of the followings:
- SQUARED_L2_DISTANCE: Euclidean (L_2) Distance
- L1_DISTANCE: Manhattan (L_1) Distance
- COSINE_DISTANCE: Cosine Distance. Defined as 1 - cosine similarity.
- DOT_PRODUCT_DISTANCE: Dot Product Distance. Defined as a negative of the dot product
- feature
Norm StringType - Type of normalization to be carried out on each vector. The value must be one of the followings:
- UNIT_L2_NORM: Unit L2 normalization type
- NONE: No normalization type is specified.
- String
- Index data is split into equal parts to be processed. These are called "shards".
The shard size must be specified when creating an index. The value must be one of the followings:
- SHARD_SIZE_SMALL: Small (2GB)
- SHARD_SIZE_MEDIUM: Medium (20GB)
- SHARD_SIZE_LARGE: Large (50GB)
GetAiIndexMetadataConfigAlgorithmConfig
- Brute
Force List<GetConfigs Ai Index Metadata Config Algorithm Config Brute Force Config> - Configuration options for using brute force search, which simply implements the standard linear search in the database for each query.
- Tree
Ah List<GetConfigs Ai Index Metadata Config Algorithm Config Tree Ah Config> - Configuration options for using the tree-AH algorithm (Shallow tree + Asymmetric Hashing). Please refer to this paper for more details: https://arxiv.org/abs/1908.10396
- Brute
Force []GetConfigs Ai Index Metadata Config Algorithm Config Brute Force Config - Configuration options for using brute force search, which simply implements the standard linear search in the database for each query.
- Tree
Ah []GetConfigs Ai Index Metadata Config Algorithm Config Tree Ah Config - Configuration options for using the tree-AH algorithm (Shallow tree + Asymmetric Hashing). Please refer to this paper for more details: https://arxiv.org/abs/1908.10396
- brute
Force List<GetConfigs Ai Index Metadata Config Algorithm Config Brute Force Config> - Configuration options for using brute force search, which simply implements the standard linear search in the database for each query.
- tree
Ah List<GetConfigs Ai Index Metadata Config Algorithm Config Tree Ah Config> - Configuration options for using the tree-AH algorithm (Shallow tree + Asymmetric Hashing). Please refer to this paper for more details: https://arxiv.org/abs/1908.10396
- brute
Force GetConfigs Ai Index Metadata Config Algorithm Config Brute Force Config[] - Configuration options for using brute force search, which simply implements the standard linear search in the database for each query.
- tree
Ah GetConfigs Ai Index Metadata Config Algorithm Config Tree Ah Config[] - Configuration options for using the tree-AH algorithm (Shallow tree + Asymmetric Hashing). Please refer to this paper for more details: https://arxiv.org/abs/1908.10396
- brute_
force_ Sequence[Getconfigs Ai Index Metadata Config Algorithm Config Brute Force Config] - Configuration options for using brute force search, which simply implements the standard linear search in the database for each query.
- tree_
ah_ Sequence[Getconfigs Ai Index Metadata Config Algorithm Config Tree Ah Config] - Configuration options for using the tree-AH algorithm (Shallow tree + Asymmetric Hashing). Please refer to this paper for more details: https://arxiv.org/abs/1908.10396
- brute
Force List<Property Map>Configs - Configuration options for using brute force search, which simply implements the standard linear search in the database for each query.
- tree
Ah List<Property Map>Configs - Configuration options for using the tree-AH algorithm (Shallow tree + Asymmetric Hashing). Please refer to this paper for more details: https://arxiv.org/abs/1908.10396
GetAiIndexMetadataConfigAlgorithmConfigTreeAhConfig
- Leaf
Node intEmbedding Count - Number of embeddings on each leaf node. The default value is 1000 if not set.
- Leaf
Nodes intTo Search Percent - The default percentage of leaf nodes that any query may be searched. Must be in range 1-100, inclusive. The default value is 10 (means 10%) if not set.
- Leaf
Node intEmbedding Count - Number of embeddings on each leaf node. The default value is 1000 if not set.
- Leaf
Nodes intTo Search Percent - The default percentage of leaf nodes that any query may be searched. Must be in range 1-100, inclusive. The default value is 10 (means 10%) if not set.
- leaf
Node IntegerEmbedding Count - Number of embeddings on each leaf node. The default value is 1000 if not set.
- leaf
Nodes IntegerTo Search Percent - The default percentage of leaf nodes that any query may be searched. Must be in range 1-100, inclusive. The default value is 10 (means 10%) if not set.
- leaf
Node numberEmbedding Count - Number of embeddings on each leaf node. The default value is 1000 if not set.
- leaf
Nodes numberTo Search Percent - The default percentage of leaf nodes that any query may be searched. Must be in range 1-100, inclusive. The default value is 10 (means 10%) if not set.
- leaf_
node_ intembedding_ count - Number of embeddings on each leaf node. The default value is 1000 if not set.
- leaf_
nodes_ intto_ search_ percent - The default percentage of leaf nodes that any query may be searched. Must be in range 1-100, inclusive. The default value is 10 (means 10%) if not set.
- leaf
Node NumberEmbedding Count - Number of embeddings on each leaf node. The default value is 1000 if not set.
- leaf
Nodes NumberTo Search Percent - The default percentage of leaf nodes that any query may be searched. Must be in range 1-100, inclusive. The default value is 10 (means 10%) if not set.
Package Details
- Repository
- Google Cloud (GCP) Classic pulumi/pulumi-gcp
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
google-beta
Terraform Provider.