# Índices vectoriales
**nota**
Elija con cuidado los parámetros de configuración del índice vectorial. Después de crear un índice vectorial, no puede actualizar el nombre, la dimensión, la métrica de distancia ni las claves de metadatos no filtrables del índice vectorial. Para cambiar cualquiera de estos valores, debe crear un nuevo índice vectorial.
Los índices vectoriales son recursos en los buckets vectoriales que almacenan y organizan datos vectoriales para realizar operaciones de búsqueda de similitud eficientes. Cuando crea un índice vectorial, especifica la métrica de distancia (`Cosine` o `Euclidean`), el número de dimensiones que debe tener un vector y, opcionalmente, una lista de campos de metadatos que desea excluir del filtrado durante las consultas de similitud.
Para obtener más información sobre los límites de índices vectoriales por bucket, los límites vectoriales por índice y los límites de dimensiones por vector, consulte [Restricciones y limitaciones](s3-vectors-limitations.md).
Cada índice vectorial tiene un nombre de recurso de Amazon (ARN) único. Los ARN de los índices vectoriales se ajustan al formato siguiente:
```
arn:aws:s3vectors:region:account-id:bucket/bucket-name/index/index-name
```
## Requisitos de nomenclatura de índices vectoriales
+ Los nombres de los índices vectoriales deben ser únicos en el bucket vectorial.
+ Los nombres de los índices vectoriales deben tener entre 3 y 63 caracteres.
+ Los caracteres válidos son letras minúsculas (a-z), números (0-9), guiones (-) y puntos (.).
+ Los nombres de índice vectorial deben comenzar y terminar con una letra o un número.
## Requisitos de las dimensiones
Una dimensión es el número de valores de un vector. Todos los vectores agregados al índice deben tener exactamente este número de valores.
+ Una dimensión debe ser un entero entre 1 y 4096.
+ Una dimensión mayor requiere más espacio de almacenamiento.
## Opciones de métrica de distancia
La métrica de distancia especifica cómo se calcula la similitud entre vectores. Al crear incrustaciones vectoriales, elija la métrica de distancia recomendada para el modelo de incrustación a fin de obtener resultados más precisos.
+ **Coseno**: mide el coseno del ángulo entre vectores. Ideal para vectores normalizados y cuando la dirección es más importante que la magnitud.
+ **Euclidiano**: mide la distancia en línea recta entre vectores. Ideal cuando tanto la dirección como la magnitud son importantes.
## Claves de metadatos no filtrables
Las claves de metadatos le permiten asociar información adicional a los vectores como pares clave-valor durante el almacenamiento y la recuperación. De forma predeterminada, todos los metadatos se pueden filtrar, por lo que puede utilizarlos para filtrar los resultados de las consultas. No obstante, puede designar claves de metadatos específicas como no filtrables cuando desee almacenar información con vectores sin utilizarla para filtrar.
A diferencia de las claves de metadatos predeterminadas, estas claves no se pueden utilizar como filtros de consulta. Las claves de metadatos no filtrables se pueden recuperar, pero no se pueden buscar, consultar ni filtrar. Solo puede acceder a ellos después de buscar en el índice.
Las claves de metadatos no filtrables le permiten enriquecer los vectores con contexto adicional que desea recuperar con los resultados de la búsqueda, pero que no necesita para el filtrado. Un ejemplo común de una clave de metadatos no filtrables se presenta cuando se incrusta texto en vectores y se desea incluir el texto original como metadatos no filtrables. Esto le permite devolver el texto de origen junto con los resultados de la búsqueda vectorial sin aumentar los límites de tamaño de los metadatos filtrables. Otros ejemplos incluyen el almacenamiento de marcas temporales de creación, direcciones URL de origen o información descriptiva únicamente para referencia. Se puede acceder a las claves de metadatos no filtrables al recuperar vectores pero, a diferencia de las claves de metadatos predeterminadas, estas claves no se pueden utilizar como filtros de consulta.
Los requisitos para las claves de metadatos no filtrables son los siguientes.
+ Las claves de metadatos no filtrables deben ser únicas en el índice vectorial.
+ Las claves de metadatos no filtrables deben tener entre 1 y 63 caracteres.
+ Las claves de metadatos no filtrables no se pueden modificar después de crear el índice vectorial.
+ S3 Vectors admite hasta diez claves de metadatos no filtrables por índice.
Para obtener más información sobre las claves de metadatos no filtrables, consulte [Metadatos no filtrables](s3-vectors-metadata-filtering.md#s3-vectors-metadata-filtering-non-filterable).
**Topics**
+ [Requisitos de nomenclatura de índices vectoriales](#s3-vectors-indexes-naming)
+ [Requisitos de las dimensiones](#s3-vectors-indexes-dimensions)
+ [Opciones de métrica de distancia](#s3-vectors-indexes-distance-metrics)
+ [Claves de metadatos no filtrables](#s3-vectors-indexes-metadata)
+ [Creación de un índice vectorial en un bucket vectorial](s3-vectors-create-index.md)
+ [Enumeración de índices vectoriales](s3-vectors-index-list.md)
+ [Eliminación de un índice vectorial](s3-vectors-index-delete.md)
+ [Uso de etiquetas con índices vectoriales de S3](vector-index-tagging.md)
# Creación de un índice vectorial en un bucket vectorial
**nota**
Elija con cuidado los parámetros de configuración del índice vectorial. Después de crear un índice vectorial, no puede actualizar el nombre, la dimensión, la métrica de distancia ni las claves de metadatos no filtrables del índice vectorial. Para cambiar cualquiera de estos valores, debe crear un nuevo índice vectorial.
Un índice vectorial es un recurso dentro de un bucket vectorial que almacena y organiza datos vectoriales para realizar búsquedas de similitud de forma eficiente. Al crear un índice vectorial, se definen las características que deben compartir todos los vectores de ese índice, como la dimensión, la métrica de distancia utilizada para los cálculos de similitud y, opcionalmente, las claves de metadatos no filtrables. Si lo desea, también puede configurar ajustes y etiquetas de cifrado dedicados para el índice vectorial en el momento de la creación del índice. Para obtener más información sobre los requisitos de nomenclatura de los índices vectoriales, los requisitos de dimensión, las opciones de métricas de distancia y las claves de metadatos no filtrables, consulte [Restricciones y limitaciones](s3-vectors-limitations.md). Para obtener más información sobre cómo establecer la configuración de cifrado para índices vectoriales, consulte [Protección y cifrado de datos en S3 Vectors](s3-vectors-data-encryption.md). Para obtener más información acerca de las etiquetas de configuración, consulte [Uso de etiquetas con buckets vectoriales de S3](s3-vectors-tags.md).
Los índices vectoriales deben crearse en un bucket vectorial existente y requieren parámetros de configuración específicos que no se pueden modificar después de la creación.
## Uso de la consola de S3
**Creación de un índice vectorial**
1. Abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3](https://console.aws.amazon.com/s3/).
1. En el panel de navegación, elija **Buckets vectoriales**.
1. En la lista de buckets vectoriales, elija el nombre del bucket en el que desea crear un índice vectorial.
1. Elija **Crear índice vectorial**.
1. En **Nombre del índice vectorial**, introduzca un nombre para el índice vectorial.
Los nombres de los índices vectoriales deben ser únicos en el bucket vectorial. El nombre de índice tener entre 3 y 63 caracteres. Los caracteres válidos son letras minúsculas (a-z), números (0-9), guiones (-) y puntos (.). Para obtener más información sobre los requisitos de nomenclatura de los índices vectoriales, consulte [Restricciones y limitaciones](s3-vectors-limitations.md).
1. En **Dimensión**, introduzca el número de valores de cada vector.
**nota**
El valor de **Dimensión** determina cuántos valores numéricos contendrá cada vector.
Todos los vectores agregados a este índice deben tener exactamente este número de valores.
Una dimensión debe estar entre 1 y 4096.
Una dimensión mayor requiere más espacio de almacenamiento.
Elija en función de las dimensiones de salida del modelo de incrustación.
Para obtener más información sobre los requisitos de dimensión, consulte [Restricciones y limitaciones](s3-vectors-limitations.md).
1. En **Métrica de distancia**, elija una de las siguientes opciones:
+ **Coseno**: mide el coseno del ángulo entre vectores. Ideal para vectores normalizados y cuando la dirección es más importante que la magnitud.
+ **Euclidiano**: mide la distancia en línea recta entre vectores. Ideal cuando tanto la dirección como la magnitud son importantes.
1. (Opcional) En **Metadatos no filtrables**, configure las claves de metadatos que se almacenarán pero no se utilizarán para filtrar:
Para agregar claves de metadatos no filtrables:
1. Elija **Agregar clave**.
1. Introduzca un nombre de clave (debe tener de 1 a 63 caracteres y debe ser único en este índice vectorial).
1. Repita el proceso para agregar claves adicionales (máximo diez claves).
**nota**
Puede asociar metadatos filtrables como pares clave-valor a cada vector al insertar datos vectoriales después de crear un índice vectorial. De forma predeterminada, todas las claves de metadatos asociadas a vectores son filtrables y se pueden utilizar como filtros en una consulta de similitud. Solo las claves de metadatos que se especifican como no filtrables durante la creación del índice vectorial se excluyen del filtrado. Para obtener más información sobre los límites de tamaño de metadatos por vector, incluidas las restricciones de metadatos totales y filtrables, consulte [Restricciones y limitaciones](s3-vectors-limitations.md).
1. Revise la configuración cuidadosamente.
**nota**
Esta configuración no se puede cambiar después de la creación.
1. En **Cifrado**, elija **Especificar tipo de cifrado**. Tiene la opción de **Utilizar la configuración de bucket para el cifrado** o invalidar la configuración de cifrado del índice vectorial. Si invalida la configuración por bucket, tiene la opción de especificar el tipo de cifrado para el índice vectorial como **Cifrado del servidor con claves de AWS Key Management Service (SSE-KMS)** o el **Cifrado del servidor con claves administradas por Amazon S3 (SSE-S3)**. Para obtener más información sobre cómo establecer la configuración de cifrado para índices vectoriales, consulte [Protección y cifrado de datos en S3 Vectors](s3-vectors-data-encryption.md).
1. En **Etiquetas (Opcional)**, puede agregar etiquetas como pares clave-valor para ayudar a rastrear y organizar los costos del índice vectorial mediante Administración de facturación y costo de AWS. Introduzca la información pertinente en **Key (Clave)** y **Value (Valor)**. Para agregar otra etiqueta, elija **Add Tag (Añadir etiqueta)**. Puede ingresar un máximo de 50 etiquetas para un índice vectorial. Para obtener más información, consulte [Uso de etiquetas con buckets vectoriales de S3](s3-vectors-tags.md).
1. Elija **Crear índice vectorial**.
## Uso de AWS CLI
Para crear un índice vectorial en un bucket vectorial, utilice los siguientes comandos de ejemplo y reemplace los `user input placeholders` por información propia.
**Ejemplo 1: creación de un índice vectorial con claves de metadatos no filtrables**
```
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"]}'
```
**Ejemplo 2: creación de un índice vectorial sin claves de metadatos no filtrables**
```
aws s3vectors create-index \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx2" \
--data-type "float32" \
--dimension 4096 \
--distance-metric "euclidean"
```
Además, todos los metadatos (tanto filtrables como no filtrables) se recuperan de la misma manera mediante las operaciones de la API `GetVectors`, `ListVectors` o `QueryVectors`. En el siguiente comando de la CLI se muestra cómo recuperar vectores con metadatos (incluidos los metadatos no filtrables).
Ejemplo de solicitud:
```
aws s3vectors get-vectors \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx" \
--keys '["vec1", "vec3"]' \
--return-data \
--return-metadata \
```
Respuesta de ejemplo:
```
{
"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"
}
}
]
}
```
La respuesta incluirá todos los metadatos asociados al vector, independientemente de si se especificaron como filtrables o no filtrables durante la creación del índice.
## Uso de los AWS SDK
------
#### [ 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"]}
)
```
------
# Enumeración de índices vectoriales
Puede ver todos los índices vectoriales de un bucket vectorial. La operación de enumeración admite el filtrado basado en prefijos para ayudarlo a encontrar índices específicos cuando tiene muchos índices en un bucket. Para obtener más información sobre `ListIndexes`, los límites de prefijos y los límites de respuesta, consulte [ListIndexes](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListIndexes.html) en la Referencia de la API de Amazon Simple Storage Service.
## Capacidad de búsqueda de prefijos
La búsqueda de prefijos le permite enumerar índices que comienzan por un prefijo específico, lo que facilita la organización y la búsqueda de índices vectoriales relacionados. Esto resulta especialmente útil cuando se utilizan convenciones de nomenclatura que agrupan índices relacionados:
+ **Por tipo de datos:** `text-embeddings-`, `image-features-` y `audio-vectors-`
+ **Por modelo:** `model1-embeddings-`, `model2-vectors-` y `custom-model-`
+ **Por caso de uso:** `search-index-`, `recommendation-` y `similarity-`
+ **Por entorno:** `prod-vectors-`, `staging-vectors-` y `dev-vectors-`
### Uso de la consola de S3
**Enumeración de índices vectoriales**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En el panel de navegación izquierdo, elija **Buckets vectoriales**.
1. En la lista de buckets vectoriales, elija el nombre del bucket que contiene los índices que desea visualizar.
1. La consola muestra una lista completa de todos los índices vectoriales en el bucket, incluido lo siguiente:
+ **Nombre**: el nombre de cada índice.
+ **Fecha de creación**: fecha en que se creó el índice.
+ **Nombre de recurso de Amazon (ARN)**: ARN completo de cada índice.
**Filtrado de la lista**
1. Introduzca un nombre o prefijo de índice en el cuadro de búsqueda situado encima de la lista de índices. Utiliza prefijos para buscar grupos de índices relacionados.
1. La lista se actualiza en tiempo real a medida que escribe.
### Uso de AWS CLI
Utilice los siguientes comandos de ejemplo y reemplace los *marcadores de posición de entrada del usuario* por información propia.
**Enumeración de índices con un prefijo determinado en un bucket vectorial**
Ejemplo de solicitud:
```
aws s3vectors list-indexes \
--vector-bucket-name "amzn-s3-demo-bucket" \
--prefix "idx" \
--max-results 1
```
Respuesta de ejemplo:
```
{
"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"
}
]
}
```
**Enumeración de índices con paginación**
Ejemplo de solicitud:
```
aws s3vectors list-indexes \
--vector-bucket-name "amzn-s3-demo-bucket" \
--prefix "idx" \
--next-token "lObb29ZkzxMGtBXs97Rkbs26xdtKemu4brsnq2jX8DCocADkILv5cRphemXS3PXXFnQBihQBmESgEeKaGA"
```
Respuesta de ejemplo:
```
{
"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"
}
]
}
```
### Uso de los AWS SDK
------
#### [ 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)
```
------
# Eliminación de un índice vectorial
Puede eliminar un índice vectorial cuando ya no lo necesite. Esta operación elimina permanentemente el índice y todos los vectores que están almacenados en él.
**importante**
Cuando elimina un índice vectorial, necesita saber lo siguiente:
Puede eliminar índices vectoriales incluso cuando estos contengan vectores.
Todos los vectores almacenados en el índice se eliminan de forma permanente
Todos los metadatos asociados a esos vectores se pierden permanentemente
La operación no se puede deshacer ni revertir
Cualquier operación en curso sobre el índice fallará de manera inmediata
Las aplicaciones que consulten el índice recibirán errores
El nombre del índice queda disponible para reutilizarlo en el bucket
## Uso de AWS CLI
Antes de eliminar un índice vectorial, verifíquelo. Para obtener más información sobre cómo verificar los detalles del índice, consulte [GetIndex](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetIndex.html) en la *Referencia de la API de Amazon S3*. Para obtener más información sobre cómo enumerar vectores dentro del índice para ver qué se eliminará, consulte [Enumeración de índices vectoriales](s3-vectors-index-list.md).
Para eliminar un índice vectorial, utilice los siguientes comandos de ejemplo. Reemplace los *marcadores de posición de entrada del usuario* por información propia.
```
aws s3vectors delete-index --vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx2"
```
Para obtener más información sobre cómo verificar si el índice se ha eliminado, consulte [Enumeración de índices vectoriales](s3-vectors-index-list.md).
## Uso de los AWS SDK
------
#### [ 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")
```
------
# Uso de etiquetas con índices vectoriales de S3
Una etiqueta de AWS es un par clave-valor que contiene metadatos acerca de los recursos, en este caso índices vectoriales de Amazon S3. Puede etiquetar los índices vectoriales de S3 al crearlos o administrar las etiquetas de los índices vectoriales existentes. Para obtener información general sobre las etiquetas, consulte [Etiquetado para la asignación de costos o el control de acceso basado en atributos (ABAC)](tagging.md).
**nota**
No se aplican cargos adicionales por el uso de etiquetas en índices vectoriales más allá de las tarifas estándar de solicitud de API de S3. Para obtener más información, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/).
## Formas habituales de utilizar etiquetas con índices vectoriales
Utilice etiquetas en los índices vectoriales de S3 para:
+ **Asignación de costos**: realice un seguimiento de los costos de almacenamiento por etiqueta de índice vectorial en Administración de facturación y costos de AWS. Para obtener más información, consulte [Uso de etiquetas para la asignación de costos](tagging.md#using-tags-for-cost-allocation).
+ **Control de acceso basado en atributos (ABAC)**: escale los permisos de acceso y conceda acceso a los índices vectoriales de S3 en función de las etiquetas. Para obtener más información, consulte [Uso de etiquetas para el control de acceso basado en atributos (ABAC)](tagging.md#using-tags-for-abac).
**nota**
Puede usar las mismas etiquetas para la asignación de costos y para el control de acceso.
### ABAC para índices vectoriales de S3
Los índices vectoriales de Amazon S3 admiten el control de acceso basado en atributos (ABAC) mediante etiquetas. Utilice claves de condición basadas en etiquetas en las políticas de índice de organizaciones, IAM y vectoriales de S3 de AWS. Para las empresas, ABAC en Amazon S3 admite la autorización en varias cuentas de AWS.
En las políticas de IAM, puede controlar el acceso a los índices vectoriales de S3 en función de las etiquetas del índice vectorial mediante las siguientes claves de condición globales:
`aws:ResourceTag/key-name`
Utilice esta clave para comparar el par clave-valor de etiqueta que especifique en la política con el par clave-valor asociado al recurso. Por ejemplo, puede requerir que el acceso a un recurso solo se permita si el recurso tiene la clave de etiqueta `Dept` adjunta con el valor `Marketing`. Para obtener más información, consulte [Control del acceso a los recursos de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).
`aws:RequestTag/key-name`
Utilice esta clave para comparar el par clave-valor de etiqueta que se transfirió en la solicitud con el par de etiquetas especificado en la política. Por ejemplo, podría comprobar si la solicitud incluya la clave de etiqueta `Dept` y que tenga el valor `Accounting`. Para obtener más información, consulte [Control del acceso durante solicitudes de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-requests). Puede utilizar esta clave de condición para restringir qué pares de clave-valor de etiqueta se pueden pasar durante las operaciones de API `TagResource` y `CreateIndex`.
`aws:TagKeys`
Utilice esta clave para comparar las claves de etiqueta de una solicitud con las claves que especifique en la política. Como práctica recomendada cuando utilice políticas para controlar el acceso mediante etiquetas, utilice la clave de condición `aws:TagKeys` para definir lo que se permite realizar a las claves de etiqueta. Para obtener más información y políticas de ejemplo, consulte [Control del acceso en función de las claves de etiqueta](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys). Puede crear un índice vectorial de S3 con etiquetas. Para permitir el etiquetado durante la operación de API `CreateVectorBucket`, debe crear una política que incluya las acciones `s3vectors:TagResource` y `s3vectors:CreateVectorBucket`. A continuación, puede utilizar la clave de condición `aws:TagKeys` para imponer el uso de etiquetas específicas en la solicitud `CreateVectorBucket`.
### Políticas de ABAC de ejemplo para índices vectoriales
Consulte las políticas de ABAC de ejemplo siguientes para índices vectoriales de Amazon S3.
#### 1.1: Política de IAM para crear o modificar índices vectoriales con etiquetas específicas
En esta política de IAM, los usuarios o roles con esta política solo pueden crear índices vectoriales de S3 si etiquetan el índice vectorial con la clave de etiqueta `project` y el valor de etiqueta `Trinity` en la solicitud de creación del índice vectorial. También pueden agregar o modificar etiquetas en los índices vectoriales de S3 existentes, siempre que la solicitud de `TagResource` incluya el par clave-valor de etiqueta `project:Trinity`. Esta política no concede permisos de lectura, escritura o eliminación en los índices vectoriales ni en sus 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 de IAM para modificar las etiquetas de los recursos existentes manteniendo la gobernanza del etiquetado
En esta política de IAM, las entidades principales de IAM (usuarios o roles) solo pueden modificar las etiquetas de un índice vectorial si el valor de la etiqueta `project` del índice vectorial coincide con el valor de la etiqueta `project` de la entidad principal. Solo se permiten las cuatro etiquetas `project`, `environment`, `owner` y `cost-center` especificadas en las claves de condición `aws:TagKeys` para estos índices vectoriales. Esto ayuda a reforzar la gobernanza de las etiquetas, evita las modificaciones no autorizadas de las etiquetas y mantiene la coherencia del esquema de etiquetado en todos los índices vectoriales.
```
{
"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"
]
}
}
}
]
}
```
# Administración de etiquetas para índices vectoriales
Puede agregar o administrar etiquetas para los índices vectoriales de S3 mediante la consola de Amazon S3, la AWS Command Line Interface (AWS CLI), los AWS SDK o usar las API de S3: [TagResource](https://docs.aws.amazon.com/), [UntagResource](https://docs.aws.amazon.com/) y [ListTagsForResource](https://docs.aws.amazon.com/). Para obtener más información, consulte:
**Topics**
+ [Creación de índices vectoriales con etiquetas](creating-vector-indexes-with-tags.md)
+ [Agregación de una etiqueta a un índice vectorial](adding-tag-vector-index.md)
+ [Visualización de etiquetas de índice vectorial](viewing-vector-index-tags.md)
+ [Eliminación de una etiqueta de un índice vectorial](deleting-tag-vector-index.md)
# Creación de índices vectoriales con etiquetas
Puede etiquetar índices vectoriales de Amazon S3 al crearlos. No se aplican cargos adicionales por el uso de etiquetas en índices vectoriales más allá de las tarifas estándar de solicitud de API de S3. Para obtener más información, consulte [Precios de Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Para obtener más información sobre el etiquetado de índices vectoriales, consulte [Uso de etiquetas con índices vectoriales de S3](vector-index-tagging.md).
## Permisos
Para crear un índice vectorial con etiquetas, debe contar con los siguientes permisos:
+ `s3vectors:CreateIndex`
+ `s3vectors:TagResource`
## Solución de errores
Si se produce un error al intentar crear un índice vectorial con etiquetas, puede hacer lo siguiente:
+ Compruebe que dispone de los [Permisos](#index-tags-permissions) necesarios para crear el índice vectorial y agregarle una etiqueta.
+ Compruebe la política de usuario de IAM para ver si hay condiciones de control de acceso basado en atributos (ABAC). Es posible que deba etiquetar los índices vectoriales solo con claves y valores de etiqueta específicos. Para obtener más información, consulte [Uso de etiquetas para el control de acceso basado en atributos (ABAC)](tagging.md#using-tags-for-abac).
## Steps
Puede crear un índice vectorial con etiquetas aplicadas mediante la consola de Amazon S3, la AWS Command Line Interface (AWS CLI), la API de REST de Amazon S3 y los AWS SDK.
### Uso de la consola de S3
**Creación de un índice vectorial con etiquetas mediante la consola de Amazon S3**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En el panel de navegación izquierdo, elija **Índices vectoriales**.
1. Elija **Crear índice vectorial** para crear un nuevo índice vectorial.
1. Cree un índice vectorial como lo haría normalmente; consulte [Creación de un índice vectorial en un bucket vectorial](s3-vectors-create-index.md).
1. En la página **Crear índice vectorial**, **Etiquetas** es una opción para crear un nuevo índice vectorial.
1. Ingrese un nombre para el índice vectorial.
1. Elija **Agregar nueva etiqueta** para abrir el editor de etiquetas e ingresar un par clave-valor de etiqueta. Se requiere la clave de la etiqueta, pero el valor es opcional.
1. Para agregar otra etiqueta, vuelva a seleccionar **Agregar nueva etiqueta**. Puede ingresar hasta 50 pares de clave-valor de etiquetas.
1. Cuando haya terminado de especificar las opciones para el nuevo índice vectorial, elija **Crear índice vectorial**.
### Uso de la API de REST
Para obtener información sobre la compatibilidad con la API de REST de Amazon S3 para crear un índice vectorial con etiquetas, consulte la siguiente sección en la *Referencia de la API de Amazon S3 Vectors*:
[CreateIndex](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_CreateIndex.html)
### Uso de AWS CLI
Para instalar AWS CLI, consulte [Instalación de AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) en la *Guía del usuario de AWS Command Line Interface*.
En el ejemplo de la CLI siguiente, se muestra cómo crear un índice vectorial con etiquetas mediante la AWS CLI. Para usar el comando, sustituya los *marcadores de posición de entrada del usuario* con su propia información.
Al crear un índice vectorial, debe proporcionar los detalles de configuración y utilizar la siguiente convención 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
```
# Agregación de una etiqueta a un índice vectorial
Puede agregar etiquetas a los índices vectoriales de Amazon S3 y modificar estas etiquetas. No se aplican cargos adicionales por el uso de etiquetas en índices vectoriales más allá de las tarifas estándar de solicitud de API de S3. Para obtener más información, consulte [Precios de Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Para obtener más información sobre el etiquetado de índices vectoriales, consulte [Uso de etiquetas con índices vectoriales de S3](vector-index-tagging.md).
## Permisos
Para agregar una etiqueta a un índice vectorial, debe contar con el siguiente permiso:
+ `s3vectors:TagResource`
## Solución de errores
Si se produce un error al intentar agregar una etiqueta a un índice vectorial, puede hacer lo siguiente:
+ Compruebe que dispone de los [Permisos](#add-index-tag-permissions) necesarios para agregar una etiqueta a un índice vectorial.
+ Si ha intentado agregar una clave de etiqueta que comience con el prefijo reservado de AWS `aws:`, cámbiela e inténtelo de nuevo.
## Steps
Puede agregar etiquetas a índices vectoriales mediante la consola de Amazon S3, la AWS Command Line Interface (AWS CLI), la API de REST de Amazon S3 y los AWS SDK.
### Uso de la consola de S3
**Agregación de etiquetas a un índice vectorial con la consola de Amazon S3**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En el panel de navegación izquierdo, elija **Índices vectoriales**.
1. Elija el nombre del índice vectorial.
1. Elija la pestaña **Propiedades**.
1. Desplácese hasta la sección **Etiquetas** y elija **Agregar nueva etiqueta**.
1. Esto abre la página **Agregar etiquetas**. Puede ingresar hasta 50 pares de clave valor de etiquetas.
1. Si agrega una nueva etiqueta con el mismo nombre de clave que una etiqueta existente, el valor de la nueva etiqueta invalida el valor de la etiqueta existente.
1. Puede editar también los valores de las etiquetas existentes en esta página.
1. Una vez que haya agregado las etiquetas, elija **Guardar cambios**.
### Uso de la API de REST
Para obtener información sobre la compatibilidad con la API de REST de Amazon S3 para agregar etiquetas a un índice vectorial, consulte la siguiente sección en la *Referencia de la API de Amazon S3 Vectors*:
[TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_TagResource.html)
### Uso de AWS CLI
Para instalar AWS CLI, consulte [Instalación de AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) en la *Guía del usuario de AWS Command Line Interface*.
En el ejemplo de la CLI siguiente, se muestra cómo agregar etiquetas a un índice vectorial mediante la AWS CLI. Para usar el comando, sustituya los *marcadores de posición de entrada del usuario* con su propia información.
```
aws s3vectors tag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tags Stage=Prod,CostCenter=Marketing
```
# Visualización de etiquetas de índice vectorial
Puede ver o mostrar las etiquetas aplicadas a los índices vectoriales de Amazon S3. Para obtener más información sobre el etiquetado de índices vectoriales, consulte [Uso de etiquetas con índices vectoriales de S3](vector-index-tagging.md).
## Permisos
Para ver etiquetas aplicadas a un índice vectorial, debe contar con el siguiente permiso:
+ `s3vectors:ListTagsForResource`
## Solución de errores
Si se produce un error al intentar mostrar o ver las etiquetas de un índice vectorial, puede hacer lo siguiente:
+ Compruebe que dispone de los [Permisos](#view-index-tag-permissions) necesarios para ver o mostrar las etiquetas del índice vectorial.
## Steps
Puede ver las etiquetas aplicadas a los índices vectoriales mediante la consola de Amazon S3, la AWS Command Line Interface (AWS CLI), la API de REST de Amazon S3 y los AWS SDK.
### Uso de la consola de S3
**Visualización de las etiquetas aplicadas a un índice vectorial mediante la consola de Amazon S3**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En el panel de navegación izquierdo, elija **Índices vectoriales**.
1. Elija el nombre del índice vectorial.
1. Elija la pestaña **Propiedades**.
1. Desplácese hasta la sección **Etiquetas** para ver todas las etiquetas aplicadas al índice vectorial.
1. La sección **Etiquetas** muestra las etiquetas definidas por el usuario de forma predeterminada. Puede seleccionar la pestaña de etiquetas generada por AWS para ver las etiquetas aplicadas al índice vectorial de los servicios de AWS.
### Uso de la API de REST
Para obtener información sobre la compatibilidad con la API de REST de Amazon S3 para visualizar las etiquetas aplicadas a un índice vectorial, consulte la siguiente sección en la Referencia de la API de Amazon Simple Vectors:
[ListTagsforResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListTagsForResource.html)
### Uso de AWS CLI
Para instalar AWS CLI, consulte [Instalación de AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) en la *Guía del usuario de AWS Command Line Interface*.
En el ejemplo de la CLI siguiente, se muestra cómo ver las etiquetas aplicadas a un índice vectorial. Para usar el comando, sustituya los *marcadores de posición de entrada del usuario* con su propia información.
```
aws s3vectors list-tags-for-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index
```
# Eliminación de una etiqueta de un índice vectorial
Puede eliminar etiquetas de índices vectoriales de S3. Una etiqueta de AWS es un par clave-valor que contiene metadatos acerca de los recursos, en este caso índices vectoriales de Amazon S3. Para obtener más información sobre el etiquetado de índices vectoriales, consulte [Uso de etiquetas con índices vectoriales de S3](vector-index-tagging.md).
**nota**
Si elimina una etiqueta y más adelante descubre que se estaba utilizando para realizar un seguimiento de los costos o para el control de acceso, puede volver a agregar la etiqueta al índice vectorial.
## Permisos
Para eliminar una etiqueta de un índice vectorial, debe tener el siguiente permiso:
+ `s3vectors:UntagResource`
## Solución de errores
Si se produce un error al intentar eliminar una etiqueta de un índice vectorial, puede hacer lo siguiente:
+ Compruebe que dispone de los [Permisos](#delete-index-tag-permissions) necesarios para eliminar una etiqueta de un índice vectorial.
## Steps
Puede eliminar etiquetas de los índices vectoriales mediante la consola de Amazon S3, la AWS Command Line Interface (AWS CLI), la API de REST de Amazon S3 y los AWS SDK.
### Uso de la consola de S3
**Eliminación de etiquetas de un índice vectorial con la consola de Amazon S3**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En el panel de navegación izquierdo, elija **Índices vectoriales**.
1. Elija el nombre del índice vectorial.
1. Elija la pestaña **Propiedades**.
1. Desplácese hasta la sección **Etiquetas** y seleccione la casilla de verificación situada junto a la etiqueta o etiquetas que desee eliminar.
1. Elija **Eliminar**.
1. Aparece la ventana emergente **Eliminar etiquetas definidas por el usuario** y le pide que confirme la eliminación de la etiqueta o etiquetas que ha seleccionado.
1. Elija **Eliminar** para confirmar.
### Uso de la API de REST
Para obtener información sobre la compatibilidad con la API de REST de Amazon S3 para eliminar etiquetas de un índice vectorial, consulte la siguiente sección en la *Referencia de la API de Amazon S3 Vectors*:
[UntagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_UntagResource.html)
### Uso de AWS CLI
Para instalar AWS CLI, consulte [Instalación de AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) en la *Guía del usuario de AWS Command Line Interface*.
En el ejemplo de la CLI siguiente, se muestra cómo eliminar etiquetas de un índice vectorial mediante la AWS CLI. Para usar el comando, sustituya los *marcadores de posición de entrada del usuario* con su propia información.
```
aws s3vectors untag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tag-keys CostCenter Department
```