Listagem de índices de vetores - Amazon Simple Storage Service
Recurso de pesquisa de prefixo

Listagem de índices de vetores

nota

O Amazon S3 Vectors está na versão prévia para o Amazon Simple Storage Service e está sujeito a alterações.

Você pode visualizar todos os índices de vetores em um bucket de vetores. A operação de listagem permite a filtragem baseada em prefixo para ajudar você a encontrar índices específicos quando houver muitos índices em um bucket. Para ter mais informações sobre ListIndexes, limites de prefixo e limites de resposta, consulte ListIndexes na “Referência de API do Amazon Simple Storage Service”.

Recurso de pesquisa de prefixo

A pesquisa de prefixo permite listar índices que começam com um prefixo específico, o que facilita a organização e a localização de índices de vetores relacionados. Isso é especialmente útil quando você usa convenções de nomenclatura que agrupam índices relacionados:

  • Por tipo de dados: text-embeddings-, image-features-, audio-vectors-

  • Por modelo: model1-embeddings-, model2-vectors-, custom-model-

  • Por caso de uso: search-index-, recommendation-, similarity-

  • Por ambiente: prod-vectors-, staging-vectors-, dev-vectors-

Como listar índices de vetores

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. No painel de navegação à esquerda, escolha Buckets de vetores.

  3. Na lista de buckets de vetores, escolha o nome do bucket que contém os índices que você deseja visualizar.

  4. O console exibe uma lista abrangente de todos os índices de vetores no bucket, incluindo:

    • Nome: o nome de cada índice.

    • Data de criação: quando o índice foi criado.

    • Nome do recurso da Amazon (ARN): o ARN completo para cada índice.

Como filtrar a lista

  1. Insira um nome ou prefixo de índice na caixa de pesquisa acima da lista de índices. Use prefixos para encontrar grupos de índices relacionados.

  2. A lista é atualizada em tempo real enquanto você digita.

Use os comandos de exemplo a seguir e substitua os espaços reservados para entrada do usuário por suas próprias informações.

Como listar índices com um prefixo específico em um bucket de vetores

Exemplo de solicitação:


aws s3vectors list-indexes \
  --vector-bucket-name "amzn-s3-demo-bucket" \
  --prefix "idx" \
  --max-results 1

Exemplo de resposta:

{
    "nextToken": "lObb29ZkzxMGtBXs97Rkbs26xdtKemu4brsnq2jX8DCocADkILv5cRphemXS3PXXFnQBihQBmESgEeKaGA",
    "indexes": [
        {
            "vectorBucketName": "amzn-s3-demo-bucket",
            "indexName": "idx",
            "indexArn": "arn:aws:s3vectors:aws-region:111122223333:bucket/amzn-s3-demo-vector-bucket/index/idx",
            "creationTime": "2025-06-12T15:50:23+00:00"
        }
    ]
}

Como listar índices com paginação

Exemplo de solicitação:

aws s3vectors list-indexes \
  --vector-bucket-name "amzn-s3-demo-bucket" \
  --prefix "idx" \
  --next-token "lObb29ZkzxMGtBXs97Rkbs26xdtKemu4brsnq2jX8DCocADkILv5cRphemXS3PXXFnQBihQBmESgEeKaGA"

Exemplo de resposta: 

{
    "indexes": [
        {
            "vectorBucketName": "amzn-s3-demo-bucket",
            "indexName": "idx2",
            "indexArn": "arn:aws:s3vectors:aws-region:111122223333:bucket/amzn-s3-demo-vector-bucket/index/idx2",
            "creationTime": "2025-06-12T15:45:37+00:00"
        }
    ]
}