Google Cloud v8.21.0 published on Wednesday, Mar 5, 2025 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)
public static Output<GetAiIndexResult> getAiIndex(GetAiIndexArgs args, InvokeOptions options)
fn::invoke:
  function: gcp:vertex/getAiIndex:getAiIndex
  arguments:
    # arguments dictionaryThe following arguments are supported:
getAiIndex Result
The following output properties are available:
- CreateTime string
- DeployedIndexes List<GetAi Index Deployed Index> 
- Description string
- DisplayName string
- EffectiveLabels Dictionary<string, string>
- Etag string
- Id string
- The provider-assigned unique ID for this managed resource.
- IndexStats List<GetAi Index Index Stat> 
- IndexUpdate stringMethod 
- Labels Dictionary<string, string>
- MetadataSchema stringUri 
- Metadatas
List<GetAi Index Metadata> 
- Name string
- PulumiLabels Dictionary<string, string>
- Region string
- UpdateTime string
- Project string
- CreateTime string
- DeployedIndexes []GetAi Index Deployed Index 
- Description string
- DisplayName string
- EffectiveLabels map[string]string
- Etag string
- Id string
- The provider-assigned unique ID for this managed resource.
- IndexStats []GetAi Index Index Stat 
- IndexUpdate stringMethod 
- Labels map[string]string
- MetadataSchema stringUri 
- Metadatas
[]GetAi Index Metadata 
- Name string
- PulumiLabels map[string]string
- Region string
- UpdateTime string
- Project string
- createTime String
- deployedIndexes List<GetAi Index Deployed Index> 
- description String
- displayName String
- effectiveLabels Map<String,String>
- etag String
- id String
- The provider-assigned unique ID for this managed resource.
- indexStats List<GetAi Index Index Stat> 
- indexUpdate StringMethod 
- labels Map<String,String>
- metadataSchema StringUri 
- metadatas
List<GetAi Index Metadata> 
- name String
- pulumiLabels Map<String,String>
- region String
- updateTime String
- project String
- createTime string
- deployedIndexes GetAi Index Deployed Index[] 
- description string
- displayName string
- effectiveLabels {[key: string]: string}
- etag string
- id string
- The provider-assigned unique ID for this managed resource.
- indexStats GetAi Index Index Stat[] 
- indexUpdate stringMethod 
- labels {[key: string]: string}
- metadataSchema stringUri 
- metadatas
GetAi Index Metadata[] 
- name string
- pulumiLabels {[key: string]: string}
- region string
- updateTime 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[GetAi Index Metadata] 
- name str
- pulumi_labels Mapping[str, str]
- region str
- update_time str
- project str
- createTime String
- deployedIndexes List<Property Map>
- description String
- displayName String
- effectiveLabels Map<String>
- etag String
- id String
- The provider-assigned unique ID for this managed resource.
- indexStats List<Property Map>
- indexUpdate StringMethod 
- labels Map<String>
- metadataSchema StringUri 
- metadatas List<Property Map>
- name String
- pulumiLabels Map<String>
- region String
- updateTime String
- project String
Supporting Types
GetAiIndexDeployedIndex    
- DeployedIndex stringId 
- The ID of the DeployedIndex in the above IndexEndpoint.
- IndexEndpoint string
- A resource name of the IndexEndpoint.
- DeployedIndex stringId 
- The ID of the DeployedIndex in the above IndexEndpoint.
- IndexEndpoint string
- A resource name of the IndexEndpoint.
- deployedIndex StringId 
- The ID of the DeployedIndex in the above IndexEndpoint.
- indexEndpoint String
- A resource name of the IndexEndpoint.
- deployedIndex stringId 
- The ID of the DeployedIndex in the above IndexEndpoint.
- indexEndpoint 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.
- deployedIndex StringId 
- The ID of the DeployedIndex in the above IndexEndpoint.
- indexEndpoint String
- A resource name of the IndexEndpoint.
GetAiIndexIndexStat    
- int
- The number of shards in the Index.
- VectorsCount string
- The number of vectors in the Index.
- int
- The number of shards in the Index.
- VectorsCount string
- The number of vectors in the Index.
- Integer
- The number of shards in the Index.
- vectorsCount String
- The number of vectors in the Index.
- number
- The number of shards in the Index.
- vectorsCount 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.
- vectorsCount String
- The number of vectors in the Index.
GetAiIndexMetadata   
- Configs
List<GetAi Index Metadata Config> 
- The configuration of the Matching Engine Index.
- ContentsDelta 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
- IsComplete 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
[]GetAi Index Metadata Config 
- The configuration of the Matching Engine Index.
- ContentsDelta 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
- IsComplete 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<GetAi Index Metadata Config> 
- The configuration of the Matching Engine Index.
- contentsDelta 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
- isComplete 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
GetAi Index Metadata Config[] 
- The configuration of the Matching Engine Index.
- contentsDelta 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
- isComplete 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[GetAi 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.
- contentsDelta 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
- isComplete 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    
- AlgorithmConfigs List<GetAi Index Metadata Config Algorithm Config> 
- The configuration with regard to the algorithms used for efficient search.
- ApproximateNeighbors 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.
- DistanceMeasure 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
 
- FeatureNorm 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)
 
- AlgorithmConfigs []GetAi Index Metadata Config Algorithm Config 
- The configuration with regard to the algorithms used for efficient search.
- ApproximateNeighbors 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.
- DistanceMeasure 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
 
- FeatureNorm 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)
 
- algorithmConfigs List<GetAi Index Metadata Config Algorithm Config> 
- The configuration with regard to the algorithms used for efficient search.
- approximateNeighbors 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.
- distanceMeasure 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
 
- featureNorm 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)
 
- algorithmConfigs GetAi Index Metadata Config Algorithm Config[] 
- The configuration with regard to the algorithms used for efficient search.
- approximateNeighbors 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.
- distanceMeasure 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
 
- featureNorm 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)
 
- algorithmConfigs List<Property Map>
- The configuration with regard to the algorithms used for efficient search.
- approximateNeighbors 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.
- distanceMeasure 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
 
- featureNorm 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      
- BruteForce 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.
- TreeAh 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
- BruteForce []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.
- TreeAh []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
- bruteForce 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.
- treeAh 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
- bruteForce 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.
- treeAh 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
- bruteForce List<Property Map>Configs 
- Configuration options for using brute force search, which simply implements the standard linear search in the database for each query.
- treeAh 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         
- LeafNode intEmbedding Count 
- Number of embeddings on each leaf node. The default value is 1000 if not set.
- LeafNodes 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.
- LeafNode intEmbedding Count 
- Number of embeddings on each leaf node. The default value is 1000 if not set.
- LeafNodes 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.
- leafNode IntegerEmbedding Count 
- Number of embeddings on each leaf node. The default value is 1000 if not set.
- leafNodes 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.
- leafNode numberEmbedding Count 
- Number of embeddings on each leaf node. The default value is 1000 if not set.
- leafNodes 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.
- leafNode NumberEmbedding Count 
- Number of embeddings on each leaf node. The default value is 1000 if not set.
- leafNodes 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-betaTerraform Provider.