S3Vectors / Client / get_index

get_index

S3Vectors.Client.get_index(**kwargs)

Returns vector index attributes. To specify the vector index, you can either use both the vector bucket name and the vector index name, or use the vector index Amazon Resource Name (ARN).

Permissions

You must have the s3vectors:GetIndex permission to use this operation.

See also: AWS API Documentation

Request Syntax

response = client.get_index(
    vectorBucketName='string',
    indexName='string',
    indexArn='string'
)
Parameters:

  • vectorBucketName (string) – The name of the vector bucket that contains the vector index.

  • indexName (string) – The name of the vector index.

  • indexArn (string) – The ARN of the vector index.

Return type:

dict

Returns:

Response Syntax

{
    'index': {
        'vectorBucketName': 'string',
        'indexName': 'string',
        'indexArn': 'string',
        'creationTime': datetime(2015, 1, 1),
        'dataType': 'float32',
        'dimension': 123,
        'distanceMetric': 'euclidean'|'cosine',
        'metadataConfiguration': {
            'nonFilterableMetadataKeys': [
                'string',
            ]
        },
        'encryptionConfiguration': {
            'sseType': 'AES256'|'aws:kms',
            'kmsKeyArn': 'string'
        }
    }
}

Response Structure

  • (dict) –

    • index (dict) –

      The attributes of the vector index.

      • vectorBucketName (string) –

        The name of the vector bucket that contains the vector index.

      • indexName (string) –

        The name of the vector index.

      • indexArn (string) –

        The Amazon Resource Name (ARN) of the vector index.

      • creationTime (datetime) –

        Date and time when the vector index was created.

      • dataType (string) –

        The data type of the vectors inserted into the vector index.

      • dimension (integer) –

        The number of values in the vectors that are inserted into the vector index.

      • distanceMetric (string) –

        The distance metric to be used for similarity search.

      • metadataConfiguration (dict) –

        The metadata configuration for the vector index.

        • nonFilterableMetadataKeys (list) –

          Non-filterable metadata keys allow you to enrich vectors with additional context during storage and retrieval. Unlike default metadata keys, these keys can’t be used as query filters. Non-filterable metadata keys can be retrieved but can’t be searched, queried, or filtered. You can access non-filterable metadata keys of your vectors after finding the vectors. For more information about non-filterable metadata keys, see Vectors and Limitations and restrictions in the Amazon S3 User Guide.

          • (string) –

      • encryptionConfiguration (dict) –

        The encryption configuration for a vector index. By default, if you don’t specify, all new vectors in the vector index will use the encryption configuration of the vector bucket.

        • sseType (string) –

          The server-side encryption type to use for the encryption configuration of the vector bucket. By default, if you don’t specify, all new vectors in Amazon S3 vector buckets use server-side encryption with Amazon S3 managed keys (SSE-S3), specifically AES256.

        • kmsKeyArn (string) –

          Amazon Web Services Key Management Service (KMS) customer managed key ID to use for the encryption configuration. This parameter is allowed if and only if sseType is set to aws:kms.

          To specify the KMS key, you must use the format of the KMS key Amazon Resource Name (ARN).

          For example, specify Key ARN in the following format: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

Exceptions