:doc:`S3Vectors <../../s3vectors>` / Client / get_index

*********
get_index
*********



.. py:method:: 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 <https://docs.aws.amazon.com/goto/WebAPI/s3vectors-2025-07-15/GetIndex>`_  


  **Request Syntax**
  ::

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

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

    

  
  :type indexName: string
  :param indexName: 

    The name of the vector index.

    

  
  :type indexArn: string
  :param indexArn: 

    The ARN of the vector index.

    

  
  
  :rtype: 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 <https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-vectors-vectors.html>`__ and `Limitations and restrictions <https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-vectors-limitations.html>`__ 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**
  
  *   :py:class:`S3Vectors.Client.exceptions.ValidationException`

  
  *   :py:class:`S3Vectors.Client.exceptions.ServiceUnavailableException`

  
  *   :py:class:`S3Vectors.Client.exceptions.TooManyRequestsException`

  
  *   :py:class:`S3Vectors.Client.exceptions.InternalServerException`

  
  *   :py:class:`S3Vectors.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`S3Vectors.Client.exceptions.RequestTimeoutException`

  
  *   :py:class:`S3Vectors.Client.exceptions.NotFoundException`

  