# Índices de vetores
**nota**
Escolha cuidadosamente os parâmetros de configuração do índice de vetores. Após a criação de um índice de vetores, não é possível atualizar o respectivo nome, dimensão, métrica de distância ou chaves de metadados não filtráveis. Para alterar qualquer um desses valores, você deve criar outro índice de vetores.
Índice de vetores são recursos dentro de buckets de vetores que armazenam e organizam os dados vetoriais para possibilitar operações eficientes de pesquisa por similaridade. Ao criar um índice de vetores, você especifica a métrica de distância (`Cosine` ou `Euclidean`), o número de dimensões que um vetor deve ter e, opcionalmente, uma lista de campos de metadados que você deseja excluir da filtragem durante consultas de similaridade.
Para ter mais informações sobre limites de índice de vetores por bucket, limites de vetores por índice e limites de dimensão por vetor, consulte [Limitações e restrições](s3-vectors-limitations.md).
Cada índice de vetores tem um nome de recurso da Amazon (ARN) exclusivo. O ARN dos índices de vetores segue o seguinte formato:
```
arn:aws:s3vectors:region:account-id:bucket/bucket-name/index/index-name
```
## Requisitos de nomenclatura de índices de vetores
+ O nome dos índices de vetores deve ser exclusivo dentro do bucket de vetores.
+ Os nomes de índice de vetores devem ter entre 3 e 63 caracteres.
+ Os caracteres válidos são letras minúsculas (a-z), números (0-9), hifens (-) e pontos (.).
+ Os nomes de índice de vetores devem começar e terminar com uma letra ou um número.
## Requisitos de dimensão
Dimensão é o número de valores em um vetor. Todos os vetores adicionados ao índice devem ter exatamente esse número de valores.
+ Uma dimensão deve ser um número inteiro entre 1 e 4.096.
+ Uma dimensão maior requer maior espaço de armazenamento.
## Opções de métrica de distância
A métrica de distância especifica como a similaridade entre vetores é calculada. Ao criar incorporações de vetores, escolha a métrica de distância recomendada do seu modelo de incorporação para obter resultados mais precisos.
+ **Cosseno**: mede o cosseno do ângulo entre os vetores. Ideal para vetores normalizados e quando a direção é mais importante do que a magnitude.
+ **Euclidiano**: mede a distância em linha reta entre os vetores. Ideal quando a direção e a magnitude são importantes.
## Chaves de metadados não filtráveis
As chaves de metadados permitem que você anexe informações adicionais aos vetores como pares de chave-valor durante o armazenamento e a recuperação. Por padrão, todos os metadados são filtráveis, então você pode usá-los para filtrar os resultados da consulta. No entanto, você pode designar chaves de metadados específicas como não filtráveis quando quiser armazenar informações com vetores sem usá-las para filtragem.
Diferentemente das chaves de metadados padrão, essas chaves não podem ser usadas como filtros de consulta. As chaves de metadados não filtráveis podem ser recuperadas, mas não podem ser pesquisadas, consultadas ou filtradas. Você só pode acessá-las depois que encontrar o índice.
As chaves de metadados não filtráveis permitem enriquecer vetores com contexto adicional que você deseja recuperar com os resultados da pesquisa, mas do qual não precisa para filtragem. Um exemplo comum do uso de chave de metadados não filtráveis é quando você incorpora texto em vetores e deseja incluir o texto original em si como metadados não filtráveis. Isso permite que você exiba o texto de origem com os resultados da pesquisa vetorial sem aumentar os limites de tamanho de metadados filtráveis. Outros exemplos incluem armazenar carimbos de data/hora de criação, URLs de origem ou informações descritivas apenas para referência. As chaves de metadados não filtráveis podem ser acessadas ao recuperar vetores, mas, diferentemente das chaves de metadados padrão, elas não podem ser usadas como filtros de consulta.
Os requisitos para chaves de metadados não filtráveis são apresentados a seguir.
+ As chaves de metadados não filtráveis devem ser exclusivas dentro do índice de vetores.
+ As chaves de metadados não filtráveis devem ter de 1 a 63 caracteres.
+ As chaves de metadados não filtráveis não podem ser modificadas após a criação do índice de vetores.
+ O S3 Vectors oferecem permite até dez chaves de metadados não filtráveis por índice.
Para ter mais informações sobre chaves de metadados não filtráveis, consulte [Metadados não filtráveis](s3-vectors-metadata-filtering.md#s3-vectors-metadata-filtering-non-filterable).
**Topics**
+ [Requisitos de nomenclatura de índices de vetores](#s3-vectors-indexes-naming)
+ [Requisitos de dimensão](#s3-vectors-indexes-dimensions)
+ [Opções de métrica de distância](#s3-vectors-indexes-distance-metrics)
+ [Chaves de metadados não filtráveis](#s3-vectors-indexes-metadata)
+ [Criar um índice de vetores em um bucket de vetores](s3-vectors-create-index.md)
+ [Listagem de índices de vetores](s3-vectors-index-list.md)
+ [Excluir um índice de vetores](s3-vectors-index-delete.md)
+ [Usar tags com índices de vetores do S3](vector-index-tagging.md)
# Criar um índice de vetores em um bucket de vetores
**nota**
Escolha cuidadosamente os parâmetros de configuração do índice de vetores. Após a criação de um índice de vetores, não é possível atualizar o respectivo nome, dimensão, métrica de distância ou chaves de metadados não filtráveis. Para alterar qualquer um desses valores, você deve criar outro índice de vetores.
Índice de vetores é um recurso dentro de um bucket de vetores que armazena e organiza os dados vetoriais para possibilitar uma pesquisa por similaridade eficiente. Ao criar um índice de vetores, você define as características que todos os vetores desse índice devem ter em comum, como dimensão, métrica de distância usada para cálculos de similaridade e, opcionalmente, chaves de metadados não filtráveis. Se preferir, também é possível definir configurações de criptografia e tags dedicadas para o índice de vetores ao criar o índice. Para ter mais informações sobre os requisitos de nomenclatura, os requisitos de dimensão, as opções de métrica de distância e as chaves de metadados não filtráveis dos índices de vetores, consulte [Limitações e restrições](s3-vectors-limitations.md). Para ter mais informações sobre como definir a configuração de criptografia para índices de vetores, consulte [Proteção e criptografia de dados no S3 Vectors](s3-vectors-data-encryption.md). Para ter mais informações sobre como configurar tags, consulte [Usar tags com buckets de vetores do S3](s3-vectors-tags.md).
Os índices de vetores devem ser criados em um bucket de vetores existente e exigem parâmetros de configuração específicos que não podem ser modificados após a criação.
## Usar o console do S3
**Como criar um índice de vetores**
1. Abra o console do Amazon S3, em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação, escolha **Buckets de vetores**.
1. Na lista de buckets de vetores, escolha o nome do bucket em que você deseja criar um índice de vetores.
1. Escolha **Criar índice de vetores**.
1. Em **Nome do índice de vetores**, insira um nome para o índice de vetores.
O nome dos índices de vetores deve ser exclusivo dentro do bucket de vetores. O nome do índice deve ter entre 3 e 63 caracteres. Os caracteres válidos são letras minúsculas (a-z), números (0-9), hifens (-) e pontos (.). Para ter mais informações sobre os requisitos de nomenclatura de índices de vetores, consulte [Limitações e restrições](s3-vectors-limitations.md).
1. Em **Dimensão**, insira o número de valores em cada vetor.
**nota**
O valor para **Dimensão** determina quantos valores numéricos cada vetor conterá.
Todos os vetores adicionados a esse índice devem ter exatamente esse número de valores.
A dimensão deve ser entre 1 e 4096.
Uma dimensão maior requer maior espaço de armazenamento.
Escolha com base nas dimensões de saída do seu modelo de incorporação.
Para ter mais informações sobre os requisitos de dimensão, consulte [Limitações e restrições](s3-vectors-limitations.md).
1. Em **Métrica de distância**, escolha uma das seguintes opções:
+ **Cosseno**: mede o cosseno do ângulo entre os vetores. Ideal para vetores normalizados e quando a direção é mais importante do que a magnitude.
+ **Euclidiano**: mede a distância em linha reta entre os vetores. Ideal quando a direção e a magnitude são importantes.
1. (Opcional) Em **Metadados não filtráveis**, configure as chaves de metadados que serão armazenadas, mas não usadas para filtragem:
Para adicionar chaves de metadados não filtráveis:
1. Escolha **Adicionar chave**.
1. Insira um nome de chave (de 1 a 63 caracteres e exclusivo nesse índice de vetores).
1. Repita o procedimento para adicionar mais chaves (no máximo dez chaves).
**nota**
Depois de criar um índice de vetores, você pode anexar metadados filtráveis como pares de chave-valor a cada vetor ao inserir dados vetoriais. Por padrão, todas as chaves de metadados anexadas aos vetores são filtráveis e podem ser usadas como filtros em uma consulta de similaridade. Somente as chaves de metadados especificadas como não filtráveis durante a criação do índice de vetores são excluídas da filtragem. Para ter mais informações sobre limites de tamanho de metadados por vetor, bem como restrições de metadados totais e filtráveis, consulte [Limitações e restrições](s3-vectors-limitations.md).
1. Analise sua configuração cuidadosamente.
**nota**
Essas configurações não podem ser alteradas após a criação.
1. Em **Criptografia**, escolha **Especificar tipo de criptografia**. Você tem a opção de **usar configurações de bucket para criptografia** ou substituir as configurações de criptografia para o índice de vetores. Se você substituir as configurações em nível de bucket, existe a opção de especificar o tipo de criptografia para índice de vetores como **criptografia do lado do servidor com chaves do AWS Key Management Service (SSE-KMS)** ou a **criptografia do lado do servidor com chaves gerenciadas pelo Amazon S3 (SSE-S3)**. Para ter mais informações sobre como definir a configuração de criptografia para índices de vetores, consulte [Proteção e criptografia de dados no S3 Vectors](s3-vectors-data-encryption.md).
1. Em **Tags (opcional)**, é possível adicionar tags como pares de chave-valor para ajudar a monitorar e organizar os custos do índice de vetores usando o Gerenciamento de Faturamento e Custos da AWS. Insira uma **Key (Chave)** e um **Value (Valor)**. Para adicionar outra tag, escolha **Add Tag (Adicionar tag)**. É possível inserir até cinquenta tags a um índice de vetores. Para obter mais informações, consulte [Usar tags com buckets de vetores do S3](s3-vectors-tags.md).
1. Escolha **Criar índice de vetores**.
## Como usar o AWS CLI
Para criar um índice de vetores em um bucket de vetores, use os comandos de exemplo a seguir e substitua os `user input placeholders` pelas suas próprias informações.
**Exemplo 1: criar um índice de vetores com chaves de metadados não filtráveis**
```
aws s3vectors create-index \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx" \
--data-type "float32" \
--dimension 1 \
--distance-metric "cosine" \
--metadata-configuration '{"nonFilterableMetadataKeys":["nonFilterableKey1"]}'
```
**Exemplo 2: criar um índice de vetores sem chaves de metadados não filtráveis**
```
aws s3vectors create-index \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx2" \
--data-type "float32" \
--dimension 4096 \
--distance-metric "euclidean"
```
Além disso, todos os metadados (filtráveis e não filtráveis) são recuperados da mesma forma usando as operações de API `GetVectors`, `ListVectors` ou `QueryVectors`. O comando da CLI a seguir mostra como recuperar vetores com metadados (inclusive metadados não filtráveis).
Exemplo de solicitação:
```
aws s3vectors get-vectors \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx" \
--keys '["vec1", "vec3"]' \
--return-data \
--return-metadata \
```
Exemplo de resposta:
```
{
"vectors": [
{
"key": "vec1",
"data": {
"float32": [
0.10000000149011612,
0.20000000298023224,
0.30000001192092896,
0.4000000059604645,
0.5
]
},
"metadata": {
"category": "test",
"text": "First vector"
}
},
{
"key": "vec3",
"data": {
"float32": [
0.6000000238418579,
0.699999988079071,
0.800000011920929,
0.8999999761581421,
1.0
]
},
"metadata": {
"text": "Third vector",
"category": "test"
}
}
]
}
```
A resposta incluirá todos os metadados associados ao vetor, independentemente de terem sido especificados como filtráveis ou não filtráveis durante a criação do índice.
## Usar SDKs da AWS
------
#### [ SDK for Python ]
```
import boto3
# Create a S3 Vectors client in the AWS Region of your choice.
s3vectors = boto3.client("s3vectors", region_name="us-west-2")
#Create a vector index "movies" in the vector bucket "media-embeddings" without non-filterable metadata keys
s3vectors.create_index(
vectorBucketName="media-embeddings",
indexName="movies",
dimension=3,
distanceMetric="cosine",
dataType = "float32"
)
#Create a vector index "movies" in the vector bucket "media-embeddings" with non-filterable metadata keys
s3vectors.create_index(
vectorBucketName="media-embeddings",
indexName="movies",
dimension=3,
distanceMetric="cosine",
dataType = "float32",
metadataConfiguration= {"nonFilterableMetadataKeys": ["nonFilterableMetadataKey1"]}
)
```
------
# Listagem de índices de vetores
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](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListIndexes.html) 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-`
### Usar o console do S3
**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/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, escolha **Buckets de vetores**.
1. Na lista de buckets de vetores, escolha o nome do bucket que contém os índices que você deseja visualizar.
1. 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.
1. A lista é atualizada em tempo real enquanto você digita.
### Como usar o AWS CLI
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"
}
]
}
```
### Usar SDKs da AWS
------
#### [ SDK for Python ]
```
import boto3
# Create a S3 Vectors client in the AWS Region of your choice.
s3vectors = boto3.client("s3vectors", region_name="us-west-2")
#List vector indexes in your vector bucket
response = s3vectors.list_indexes(vectorBucketName="media-embeddings")
indexes = response["indexes"]
print(indexes)
```
------
# Excluir um índice de vetores
Você poderá excluir um índice de vetores quando não precisar mais dele. Essa operação remove permanentemente o índice e todos os vetores armazenados nele.
**Importante**
Ao excluir um índice de vetores, você precisa saber o seguinte:
Você pode excluir índices de vetores mesmo quando eles contiverem vetores.
Todos os vetores armazenados no índice são excluídos permanentemente.
Todos os metadados associados a esses vetores são perdidos permanentemente.
A operação não pode ser desfeita ou revertida.
Qualquer operação em andamento no índice falhará imediatamente.
As aplicações que consultarem o índice receberão erros.
O nome do índice fica disponível para reutilização no bucket.
## Como usar o AWS CLI
Antes de excluir um índice de vetores, verifique-o. Para ter mais informações sobre como verificar os detalhes do índice, consulte [GetIndex](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetIndex.html) na *Referência de API do Amazon S3*. Para ter mais informações sobre como listar vetores dentro do índice para ver o que será excluído, consulte [Listagem de índices de vetores](s3-vectors-index-list.md).
Para excluir um índice de vetores, use os comandos de exemplo a seguir. Substitua os *espaços reservados para entrada do usuário* por suas próprias informações.
```
aws s3vectors delete-index --vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx2"
```
Para ter mais informações sobre como verificar se o índice foi excluído, consulte [Listagem de índices de vetores](s3-vectors-index-list.md).
## Usar SDKs da AWS
------
#### [ SDK for Python ]
```
import boto3
# Create a S3 Vectors client in the AWS Region of your choice.
s3vectors = boto3.client("s3vectors", region_name="us-west-2")
#Delete a vector index
response = s3vectors.delete_index(
vectorBucketName="media-embeddings",
indexName="movies")
```
------
# Usar tags com índices de vetores do S3
Uma tag da AWS é um par de chave-valor que contém metadados sobre recursos; neste caso, índices de vetores do Amazon S3. É possível marcar índices de vetores do S3 ao criá-los ou gerenciar tags em índices de vetores existentes. Para ter informações gerais sobre tags, consulte [Atribuir tags para alocação de custos ou controle de acesso por atributo (ABAC)](tagging.md).
**nota**
Não há cobrança adicional para usar tags em índices de vetores além das taxas de solicitação padrão da API do S3. Para obter mais informações, consulte [Preço do Amazon S3](https://aws.amazon.com/s3/pricing/).
## Maneiras comuns de usar tags com índices de vetores
Use tags em índices de vetores do S3 para:
+ **Alocação de custos**: acompanhe os custos de armazenamento por tag de índice de vetores no Gerenciamento de Faturamento e Custos da AWS. Para obter mais informações, consulte [Usar tags para alocação de custos](tagging.md#using-tags-for-cost-allocation).
+ **Controle de acesso por atributo (ABAC)**: amplie as permissões de acesso e conceda acesso aos índices de vetores do S3 com base nas respectivas tags. Para obter mais informações, consulte [Usar tags para controle de acesso por atributo (ABAC)](tagging.md#using-tags-for-abac).
**nota**
Você pode usar as mesmas tags para alocação de custos e controle de acesso.
### ABAC para índices de vetores do S3
Os índices de vetores do Amazon S3 permitem utilizar o controle de acesso por atributo (ABAC) usando tags. Use chaves de condição baseadas em tags em políticas de índice de vetores do S3, de suas organizações na AWS e do IAM. Para empresas, o ABAC no Amazon S3 permite a autorização em várias contas da AWS.
Nas suas políticas do IAM, você pode controlar o acesso aos índices de vetores do S3 com base nas tags do índice de vetores usando as seguintes chaves de condição globais:
`aws:ResourceTag/key-name`
Use essa chave para comparar o par chave-valor da etiqueta especificado na política com o par chave-valor anexado ao recurso. Por exemplo, é possível exigir que o acesso a um recurso seja permitido somente se o recurso tiver a chave de tag `Dept` anexada com o valor `Marketing`. Para obter mais informações, consulte [Controle de acesso aos recursos do AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).
`aws:RequestTag/key-name`
Use essa chave para comparar o par de chave/valor da tag que foi passado na solicitação com o par de tags especificado na política. Por exemplo, é possível verificar se a solicitação inclui a chave de tag `Dept` e se ela tem o valor `Accounting`. Para ter mais informações, consulte [Controlar o acesso durante solicitações da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-requests). Você pode usar essa chave de condição para restringir quais pares de chave-valor de tag podem ser transmitidos durante as operações de API `TagResource` e `CreateIndex`.
`aws:TagKeys`
Use essa chave para comparar as chaves de tag em uma solicitação com as chaves especificadas na política. Ao usar políticas para controlar o acesso usando etiquetas, recomendamos o uso da chave de condição `aws:TagKeys` para definir quais chaves de etiquetas serão permitidas. Para ver exemplos de política e ter mais informações, consulte [Controlar o acesso com base em chaves de tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys). É possível criar um índice de vetores do S3 com tags. Para permitir a marcação durante a operação de API `CreateVectorBucket`, você deve criar uma política que inclua as ações `s3vectors:TagResource` e `s3vectors:CreateVectorBucket`. Em seguida, você pode usar a chave de condição `aws:TagKeys` para impor o uso de tags específicas na solicitação `CreateVectorBucket`.
### Exemplos de política de ABAC para índices de vetores
Veja a seguir exemplos de política de ABAC para índices de vetores do Amazon S3.
#### 1.1 Política do IAM para criar ou modificar índices de vetores com tags específicas
Nessa política do IAM, usuários ou perfis com essa política só podem criar índices de vetores do S3 se marcarem o índice de vetores com a chave de tag `project` e o valor de tag `Trinity` na solicitação de criação do índice de vetores. Eles também podem adicionar ou modificar tags em índices de vetores existentes do S3, desde que a solicitação `TagResource` inclua o par de chave-valor de tag `project:Trinity`. Essa política não concede permissões de leitura, gravação ou exclusão nos índices de vetores ou nos respectivos objetos.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "CreateVectorIndexWithTags",
"Effect": "Allow",
"Action": [
"s3vectors:CreateIndex",
"s3vectors:TagResource"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:RequestTag/project": [
"Trinity"
]
}
}
}
]
}
```
#### 1.2 Política do IAM para modificar tags em recursos existentes, mantendo a governança de marcação
Nessa política do IAM, as entidades principais do IAM (usuários e perfis) poderão modificar tags em um índice de vetores somente se o valor da tag `project` do índice de vetores corresponder ao valor da tag `project` da entidade principal. Somente as quatro tags (`project`, `environment`, `owner` e `cost-center`) especificadas nas chaves de condição `aws:TagKeys` são permitidas para esses índices de vetores. Isso ajuda a impor a governança de tags, evita modificações não autorizadas nas tags e mantém o esquema de marcação consistente em todos os índices de vetores.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "EnforceTaggingRulesOnModification",
"Effect": "Allow",
"Action": [
"s3vectors:TagResource"
],
"Resource": "arn:aws::s3vectors:us-west-2:111122223333:bucket/*",
"Condition": {
"StringEquals": {
"aws:ResourceTag/project": "${aws:PrincipalTag/project}"
},
"ForAllValues:StringEquals": {
"aws:TagKeys": [
"project",
"environment",
"owner",
"cost-center"
]
}
}
}
]
}
```
# Gerenciar tags para índices de vetores
É possível adicionar ou gerenciar tags para índices de vetores do S3 usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), os SDKs da AWS ou as APIs [TagResource](https://docs.aws.amazon.com/), [UntagResource](https://docs.aws.amazon.com/) e [ListTagsForResource](https://docs.aws.amazon.com/) do S3. Para obter mais informações, consulte:
**Topics**
+ [Criar índices de vetores com tags](creating-vector-indexes-with-tags.md)
+ [Adicionar uma tag a um índice de vetores](adding-tag-vector-index.md)
+ [Visualizar tags de índice de vetores](viewing-vector-index-tags.md)
+ [Excluir uma tag de um índice de vetores](deleting-tag-vector-index.md)
# Criar índices de vetores com tags
É possível marcar índices de vetores do Amazon S3 ao criá-los. Não há cobrança adicional para usar tags em índices de vetores além das taxas de solicitação padrão da API do S3. Para obter mais informações, consulte [Preço do Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Para ter mais informações sobre como marcar índices de vetores, consulte [Usar tags com índices de vetores do S3](vector-index-tagging.md).
## Permissões
Para criar um índice de vetores com tags, é necessário ter as seguintes permissões:
+ `s3vectors:CreateIndex`
+ `s3vectors:TagResource`
## Solucionar de problemas de erros
Se você encontrar um erro ao tentar criar um índice de vetores com tags, é possível fazer o seguinte:
+ Verifique se você tem as [permissões](#index-tags-permissions) necessárias para criar o índice de vetores e adicionar uma tag a ele.
+ Confira sua política de usuário do IAM para ver se existe alguma condição de controle de acesso por atributo (ABAC). Pode ser necessário rotular os índices de vetores somente com chaves e valores de tag específicos. Para obter mais informações, consulte [Usar tags para controle de acesso por atributo (ABAC)](tagging.md#using-tags-for-abac).
## Etapas
É possível criar um índice de vetores com tags aplicadas usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 e SDKs da AWS.
### Usar o console do S3
**Como criar um índice de vetores com tags usando o console do Amazon S3**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação, escolha **Índices de vetores**.
1. Escolha **Criar índice de vetores** para criar um índice de vetores.
1. Crie um índice de vetores como você faria normalmente. Consulte [Criar um índice de vetores em um bucket de vetores](s3-vectors-create-index.md).
1. Na página **Criar índice de vetores**, **Tags** é uma opção ao criar um índice de vetores.
1. Insira um nome para o índice de vetores.
1. Escolha **Adicionar nova tag** para abrir o editor de tags e inserir um par de chave-valor de tag. A chave de tag é necessária, mas o valor é opcional.
1. Para adicionar outra tag, selecione novamente **Adicionar nova tag**. É possível adicionar até cinquenta pares de chave-valor de tag.
1. Ao concluir a especificação das opções para seu novo índice de vetores, escolha **Criar índice de vetores**.
### Uso da API REST
Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para criar um índice de vetores com tags, consulte a seguinte seção na *Referência de API do Amazon S3 Vectors*:
[CreateIndex](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_CreateIndex.html)
### Como usar o AWS CLI
Para instalar a AWS CLI, consulte [Instalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia do usuário da AWS Command Line Interface*.
O exemplo da CLI a seguir mostra como criar um índice de vetores com tags usando a AWS CLI. Para usar o comando, substitua os *espaços reservados para entrada do usuário* por suas próprias informações.
Ao criar um índice de vetores, você deve fornecer detalhes de configuração e usar a seguinte convenção de nomenclatura: `example-vector-index`.
```
aws s3vectors create-index --vector-bucket-name acc-bucket --data-type "float32" \
--index-name accounts-index --dimension 1024 --distance-metric euclidean \
--tags Department=Accounting,Stage=Prod
```
# Adicionar uma tag a um índice de vetores
É possível adicionar tags a índices de vetores do Amazon S3 e modificá-las. Não há cobrança adicional para usar tags em índices de vetores além das taxas de solicitação padrão da API do S3. Para obter mais informações, consulte [Preço do Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Para ter mais informações sobre como marcar índices de vetores, consulte [Usar tags com índices de vetores do S3](vector-index-tagging.md).
## Permissões
Para adicionar uma tag a um índice de vetores, é necessário ter a seguinte permissão:
+ `s3vectors:TagResource`
## Solucionar de problemas de erros
Se você encontrar um erro ao tentar adicionar uma tag a um índice de vetores, é possível fazer o seguinte:
+ Verifique se você tem as [permissões](#add-index-tag-permissions) necessárias para adicionar uma tag a um índice de vetores.
+ Se você tentou adicionar uma chave de tag que começa com o prefixo reservado `aws:` da AWS, altere-a e tente novamente.
## Etapas
É possível adicionar tags a índices de vetores usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 e SDKs da AWS.
### Usar o console do S3
**Como adicionar tags a um índice de vetores usando o console do Amazon S3**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação, escolha **Índices de vetores**.
1. Escolha o nome do índice de vetores.
1. Escolha a guia **Properties (Propriedades)**.
1. Role até a seção **Tags** e escolha **Adicionar nova tag**.
1. Isso abre a página **Adicionar tags**. É possível adicionar até cinquenta pares de chave-valor de tag.
1. Se você adicionar uma nova tag com a mesma chave de uma tag existente, o valor da nova sobrescreverá o valor da tag existente.
1. Nessa página, também é possível editar os valor das tags existentes.
1. Depois de adicionar as tags, escolha **Salvar alterações**.
### Uso da API REST
Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para adicionar tags a um índice de vetores, consulte a seguinte seção na *Referência de API do Amazon S3 Vectors*:
[TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_TagResource.html)
### Como usar o AWS CLI
Para instalar a AWS CLI, consulte [Instalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia do usuário da AWS Command Line Interface*.
O exemplo da CLI a seguir mostra como adicionar tags a um índice de vetores usando a AWS CLI. Para usar o comando, substitua os *espaços reservados para entrada do usuário* por suas próprias informações.
```
aws s3vectors tag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tags Stage=Prod,CostCenter=Marketing
```
# Visualizar tags de índice de vetores
É possível visualizar ou listar as tags aplicadas aos índices de vetores do Amazon S3. Para ter mais informações sobre como marcar índices de vetores, consulte [Usar tags com índices de vetores do S3](vector-index-tagging.md).
## Permissões
Para visualizar as tags aplicadas a um índice de vetores, é necessário ter a seguinte permissão:
+ `s3vectors:ListTagsForResource`
## Solucionar de problemas de erros
Se você encontrar um erro ao tentar listar ou visualizar as tags de um índice de vetores, é possível fazer o seguinte:
+ Verifique se você tem as [permissões](#view-index-tag-permissions) necessárias para visualizar ou listar as tags do índice de vetores.
## Etapas
É possível visualizar as tags aplicadas a índices de vetores usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 e os SDKs da AWS.
### Usar o console do S3
**Como visualizar as tags aplicadas a um índice de vetores usando o console do Amazon S3**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação, escolha **Índices de vetores**.
1. Escolha o nome do índice de vetores.
1. Escolha a guia **Properties (Propriedades)**.
1. Role até a seção **Tags** para visualizar todas as tags aplicadas ao índice de vetores.
1. Por padrão, a seção **Tags** mostra as tags definidas elo usuário. Você pode selecionar a guia “Tags geradas pela AWS” para visualizar as tags aplicadas pelos serviços da AWS ao índice de vetores.
### Uso da API REST
Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para visualizar as tags aplicadas a um índice de vetores, consulte a seguinte seção na “Referência de API do Amazon S3 Vectors”:
[ListTagsforResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListTagsForResource.html)
### Como usar o AWS CLI
Para instalar a AWS CLI, consulte [Instalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia do usuário da AWS Command Line Interface*.
O exemplo de CLI a seguir mostra como visualizar as tags aplicadas a um índice de vetores. Para usar o comando, substitua os *espaços reservados para entrada do usuário* por suas próprias informações.
```
aws s3vectors list-tags-for-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index
```
# Excluir uma tag de um índice de vetores
É possível remover tags de índices de vetores do S3. Uma tag da AWS é um par de chave-valor que contém metadados sobre recursos; neste caso, índices de vetores do Amazon S3. Para ter mais informações sobre como marcar índices de vetores, consulte [Usar tags com índices de vetores do S3](vector-index-tagging.md).
**nota**
Se você excluir uma tag e depois descobrir que ela estava sendo usada para monitorar custos ou controlar o acesso, poderá adicionar a tag novamente índice de vetores.
## Permissões
Para excluir uma tag de um índice de vetores, é necessário ter a seguinte permissão:
+ `s3vectors:UntagResource`
## Solucionar de problemas de erros
Se você encontrar um erro ao tentar excluir uma tag de um índice de vetores, é possível fazer o seguinte:
+ Verifique se você tem as [permissões](#delete-index-tag-permissions) necessárias para excluir uma tag de um índice de vetores.
## Etapas
É possível excluir tags de índices de vetores usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), a API REST do Amazon S3 e SDKs da AWS.
### Usar o console do S3
**Como excluir tags de um índice de vetores usando o console do Amazon S3**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação, escolha **Índices de vetores**.
1. Escolha o nome do índice de vetores.
1. Escolha a guia **Properties (Propriedades)**.
1. Role até a seção **Tags** e marque a caixa de seleção ao lado das tags que você gostaria de excluir.
1. Escolha **Excluir**.
1. O pop-up **Excluir etiquetas definidas pelo usuário** é exibido e solicita que você confirme a exclusão das tags selecionadas.
1. Escolha **Delete** para confirmar.
### Uso da API REST
Para ter informações sobre a compatibilidade oferecida pela API REST do Amazon S3 para excluir tags de um índice de vetores, consulte a seguinte seção na *Referência de API do Amazon S3 Vectors*:
[UntagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_UntagResource.html)
### Como usar o AWS CLI
Para instalar a AWS CLI, consulte [Instalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia do usuário da AWS Command Line Interface*.
O exemplo da CLI a seguir mostra como excluir tags de um índice de vetores usando a AWS CLI. Para usar o comando, substitua os *espaços reservados para entrada do usuário* por suas próprias informações.
```
aws s3vectors untag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tag-keys CostCenter Department
```