Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Index vectoriels
**Note**
Choisissez soigneusement les paramètres de configuration de votre index vectoriel. Après avoir créé un index vectoriel, vous ne pouvez pas mettre à jour le nom de l’index vectoriel, la dimension, la métrique de distance ou les clés de métadonnées non filtrables. Pour modifier l’une de ces valeurs, vous devez créer un nouvel index vectoriel.
Les index vectoriels sont des ressources au sein d’un compartiment de vecteur qui stockent et organisent les données vectorielles pour des opérations de recherche de similarité efficaces. Lorsque vous créez un index vectoriel, vous spécifiez la métrique de distance (`Cosine` ou `Euclidean`), le nombre de dimensions qu’un vecteur doit avoir et, éventuellement, une liste de champs de métadonnées que vous souhaitez exclure du filtrage lors des requêtes de similarité.
Pour plus d’informations sur les limites d’index vectoriel par compartiment, les limites vectorielles par index et les limites de dimension par vecteur, consultez [Limites et restrictions](s3-vectors-limitations.md).
Chaque index vectoriel possède un Amazon Resource Name (ARN) unique. Les ARNs index vectoriels suivent le format suivant :
```
arn:aws:s3vectors:region:account-id:bucket/bucket-name/index/index-name
```
## Exigences relatives à la dénomination des index vectoriels
+ Les noms d’index vectoriel doivent être uniques dans le compartiment de vecteur.
+ Les noms d’index vectoriel peuvent comporter entre 3 et 63 caractères.
+ Les caractères valides sont les lettres minuscules (a-z), les chiffres (0-9), les tirets (-) et les points (.).
+ Les noms d’index vectoriel doivent commencer et se terminer par une lettre ou un chiffre.
## Exigences relatives aux dimensions
Une dimension est le nombre de valeurs d’un vecteur. Tous les vecteurs ajoutés à l’index doivent avoir exactement ce nombre de valeurs.
+ Une dimension doit être un entier compris entre 1 et 4 096.
+ Une plus grande dimension nécessite plus d’espace de stockage.
## Options de métrique de distance
La métrique de distance spécifie le mode de calcul de la similitude entre les vecteurs. Lorsque vous créez des vectorisations, choisissez la métrique de distance recommandée pour votre modèle de vectorisation pour des résultats plus précis.
+ **Cosinus** : mesure le cosinus de l’angle entre les vecteurs. Idéal pour les vecteurs normalisés et lorsque la direction compte plus que la magnitude.
+ **Euclidien** : mesure la distance en ligne droite entre les vecteurs. Idéal lorsque la direction et la magnitude sont importantes.
## Clés de métadonnées non filtrables
Les clés de métadonnées vous permettent d’associer des informations supplémentaires à vos vecteurs sous forme de paires clé-valeur lors du stockage et de la récupération. Par défaut, toutes les métadonnées sont filtrables. Vous pouvez donc les utiliser pour filtrer les résultats des requêtes. Toutefois, vous pouvez désigner des clés de métadonnées spécifiques comme non filtrables lorsque vous souhaitez stocker des informations à l’aide de vecteurs sans les utiliser pour le filtrage.
Contrairement aux clés de métadonnées par défaut, ces clés ne peuvent pas être utilisées comme filtres de requête. Les clés de métadonnées non filtrables peuvent être récupérées mais ne peuvent pas être recherchées, interrogées ou filtrées. Vous ne pouvez y accéder qu’après avoir trouvé l’index.
Les clés de métadonnées non filtrables vous permettent d’enrichir les vecteurs avec du contexte supplémentaire que vous souhaitez récupérer avec les résultats de recherche sans avoir besoin de filtrer. Un exemple courant de clé de métadonnées non filtrable est lorsque vous incorporez du texte dans des vecteurs et que vous souhaitez inclure le texte original lui-même en tant que métadonnées non filtrables. Cela vous permet de renvoyer le texte source à côté des résultats de recherche vectorielle sans augmenter les limites de taille des métadonnées filtrables. D'autres exemples incluent le stockage des horodatages de création, de la source URLs ou des informations descriptives à des fins de référence uniquement. Les clés de métadonnées non filtrables sont accessibles lors de la récupération de vecteurs mais, contrairement aux clés de métadonnées par défaut, elles ne peuvent pas être utilisées comme filtres de requête.
Les exigences relatives aux clés de métadonnées non filtrables sont les suivantes.
+ Les clés de métadonnées non filtrables doivent être uniques dans l’index vectoriel.
+ Les clés de métadonnées non filtrables doivent comporter entre 1 et 63 caractères.
+ Les clés de métadonnées non filtrables ne peuvent pas être modifiées une fois que l’index vectoriel a été créé.
+ S3 Vectors prend en charge jusqu’à 10 clés de métadonnées non filtrables par index.
Pour plus d’informations sur les clés de métadonnées non filtrables, consultez [Métadonnées non filtrables](s3-vectors-metadata-filtering.md#s3-vectors-metadata-filtering-non-filterable).
**Topics**
+ [Exigences relatives à la dénomination des index vectoriels](#s3-vectors-indexes-naming)
+ [Exigences relatives aux dimensions](#s3-vectors-indexes-dimensions)
+ [Options de métrique de distance](#s3-vectors-indexes-distance-metrics)
+ [Clés de métadonnées non filtrables](#s3-vectors-indexes-metadata)
+ [Création d’un index vectoriel dans un compartiment de vecteur](s3-vectors-create-index.md)
+ [Création d’une liste des index vectoriels](s3-vectors-index-list.md)
+ [Suppression d’un index vectoriel](s3-vectors-index-delete.md)
+ [Utilisation de balises avec des index vectoriels S3](vector-index-tagging.md)
# Création d’un index vectoriel dans un compartiment de vecteur
**Note**
Choisissez soigneusement les paramètres de configuration de votre index vectoriel. Après avoir créé un index vectoriel, vous ne pouvez pas mettre à jour le nom de l’index vectoriel, la dimension, la métrique de distance ou les clés de métadonnées non filtrables. Pour modifier l’une de ces valeurs, vous devez créer un nouvel index vectoriel.
Un index vectoriel est une ressource au sein d’un compartiment de vecteur qui stocke et organise les données vectorielles pour une recherche de similarité efficace. Lorsque vous créez un index vectoriel, vous définissez les caractéristiques que tous les vecteurs de cet index doivent partager, telles que la dimension, la métrique de distance utilisée pour les calculs de similarité et, éventuellement, les clés de métadonnées non filtrables. Vous pouvez également configurer éventuellement des paramètres de chiffrement et des balises dédiés pour l'index vectoriel au moment de la création de l'index. Pour plus d’informations sur les exigences de dénomination des index vectoriels, les exigences de dimension, les options de métrique de distance et les clés de métadonnées non filtrables, consultez [Limites et restrictions](s3-vectors-limitations.md). Pour plus d'informations sur la définition de la configuration de chiffrement pour les index vectoriels, consultez[Protection et chiffrement des données dans S3 Vectors](s3-vectors-data-encryption.md). Pour plus d'informations sur la définition des balises, consultez[Utilisation de balises avec des compartiments vectoriels S3](s3-vectors-tags.md).
Les index vectoriels doivent être créés dans un compartiment de vecteur existant et nécessitent des paramètres de configuration spécifiques qui ne peuvent pas être modifiés après leur création.
## Utilisation de la console S3
**Pour créer un index vectoriel**
1. Ouvrez la console Amazon S3 à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation, choisissez **Compartiments de vecteur**.
1. Dans la liste de compartiments de vecteur, choisissez le nom du compartiment dans lequel vous souhaitez créer un index vectoriel.
1. Choisissez **Créer un index vectoriel**.
1. Dans **Nom de l’index vectoriel**, saisissez le nom de votre index vectoriel.
Les noms d’index vectoriel doivent être uniques dans le compartiment de vecteur. Le nom d’index doit comporter entre 3 et 63 caractères. Les caractères valides sont les lettres minuscules (a-z), les chiffres (0-9), les tirets (-) et les points (.). Pour plus d’informations sur les exigences relatives à la dénomination des index vectoriels, consultez [Limites et restrictions](s3-vectors-limitations.md).
1. Pour **Dimension**, entrez le nombre de valeurs dans chaque vecteur.
**Note**
La valeur de **Dimension** détermine le nombre de valeurs numériques que chaque vecteur contiendra.
Tous les vecteurs ajoutés à cet index doivent avoir exactement ce nombre de valeurs.
Une dimension doit être comprise entre 1 et 4 096.
Une plus grande dimension nécessite plus d’espace de stockage.
Choisissez en fonction des dimensions de sortie de votre modèle de vectorisation.
Pour plus d’informations sur les exigences relatives aux dimensions, consultez [Limites et restrictions](s3-vectors-limitations.md).
1. Pour **Métrique de distance**, choisissez l’une des options suivantes :
+ **Cosinus** : mesure le cosinus de l’angle entre les vecteurs. Idéal pour les vecteurs normalisés et lorsque la direction compte plus que la magnitude
+ **Euclidien** : mesure la distance en ligne droite entre les vecteurs. Idéal lorsque la direction et la magnitude sont importantes.
1. (Facultatif) Sous **Métadonnées non filtrables**, configurez les clés de métadonnées qui seront stockées mais non utilisées pour le filtrage :
Pour ajouter des clés de métadonnées non filtrables :
1. Sélectionnez **Ajouter une clé**.
1. Saisissez un nom de clé (1 à 63 caractères et unique dans cet index vectoriel).
1. Répétez l’opération pour ajouter des clés supplémentaires (10 clés au maximum).
**Note**
Vous pouvez attacher des métadonnées filtrables sous forme de paires clé-valeur à chaque vecteur lorsque vous insérez des données vectorielles après avoir créé un index vectoriel. Par défaut, toutes les clés de métadonnées attachées à des vecteurs sont filtrables et utilisables comme filtres dans une requête de similarité. Seules les clés de métadonnées spécifiées comme non filtrables lors de la création de l’index vectoriel sont exclues du filtrage. Pour plus d’informations sur les limites de taille des métadonnées par vecteur, y compris les contraintes de métadonnées totales et filtrables, consultez [Limites et restrictions](s3-vectors-limitations.md).
1. Vérifiez attentivement votre configuration.
**Note**
Ces paramètres ne peuvent pas être modifiés après la création.
1. Sous **Chiffrement**, choisissez **Spécifier le type de chiffrement**. Vous avez la possibilité d'**utiliser les paramètres du bucket pour le chiffrement** ou de remplacer les paramètres de chiffrement de l'index vectoriel. Si vous remplacez les paramètres au niveau du compartiment, vous avez la possibilité de spécifier le type de chiffrement pour l'index vectoriel : chiffrement **côté serveur avec des clés du service de gestion des AWS clés (SSE-KMS) ou chiffrement côté serveur avec des clés gérées par **Amazon S3 (SSE-S3**)**. Pour plus d'informations sur la définition de la configuration de chiffrement pour les index vectoriels, consultez[Protection et chiffrement des données dans S3 Vectors](s3-vectors-data-encryption.md).
1. Sous **Tags (facultatif)**, vous pouvez ajouter des balises sous forme de paires clé-valeur afin de suivre et d'organiser les coûts des indices vectoriels à l'aide de AWS Billing and Cost Management. Saisissez une **Key (Clé)** et une **Value (Valeur)**. Choisissez **Add Tag (Ajouter une balise)** pour ajouter une autre balise. Vous pouvez saisir jusqu'à 50 balises pour un index vectoriel. Pour de plus amples informations, veuillez consulter [Utilisation de balises avec des compartiments vectoriels S3](s3-vectors-tags.md).
1. Choisissez **Créer un index vectoriel**.
## À l'aide du AWS CLI
Pour créer un index vectoriel dans un compartiment de vecteur, utilisez les exemples de commandes suivants et remplacez les `user input placeholders` par vos propres informations.
**Exemple 1 : création d’un index vectoriel avec des clés de métadonnées non 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"]}'
```
**Exemple 2 : création d’un index vectoriel avec des clés de métadonnées non filtrables**
```
aws s3vectors create-index \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx2" \
--data-type "float32" \
--dimension 4096 \
--distance-metric "euclidean"
```
En outre, toutes les métadonnées (filtrables et non filtrables) sont récupérées de la même manière à l’aide des opérations de l’API `GetVectors`, `ListVectors` ou `QueryVectors`. La commande de l’interface de ligne de commande suivante montre comment récupérer des vecteurs avec des métadonnées (y compris des métadonnées non filtrables).
Exemple de demande :
```
aws s3vectors get-vectors \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx" \
--keys '["vec1", "vec3"]' \
--return-data \
--return-metadata \
```
Exemple de réponse :
```
{
"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 réponse inclura toutes les métadonnées associées au vecteur, qu’il ait été spécifié comme filtrable ou non filtrable lors de la création de l’index.
## À l'aide du AWS SDKs
------
#### [ 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"]}
)
```
------
# Création d’une liste des index vectoriels
Vous pouvez afficher tous les index vectoriels contenus dans un compartiment de vecteur. L’opération de liste prend en charge le filtrage basé sur les préfixes pour vous aider à rechercher des index spécifiques lorsqu’un compartiment contient de nombreux index. Pour plus d'informations sur `ListIndexes` les limites de préfixes et les limites de réponse, consultez le [ListIndexes](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListIndexes.html)manuel Amazon Simple Storage Service API Reference.
## Fonctionnalité de recherche de préfixe
La recherche par préfixe vous permet de répertorier les index commençant par un préfixe spécifique, ce qui facilite l’organisation et la recherche des index vectoriels associés. Cette fonctionnalité est particulièrement utile lorsque vous utilisez des conventions de dénomination qui regroupent des index connexes :
+ **Par type de données :** `text-embeddings-`, `image-features-`, `audio-vectors-`
+ **Par modèle :** `model1-embeddings-`, `model2-vectors-`, `custom-model-`
+ **Par cas d’utilisation :** `search-index-`, `recommendation-`, `similarity-`
+ **Par environnement :** `prod-vectors-`, `staging-vectors-`, `dev-vectors-`
### Utilisation de la console S3
**Pour répertorier les index de vecteur**
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez **Compartiments de vecteur**.
1. Dans la liste des compartiments de vecteur, choisissez le nom du compartiment qui contient les index que vous souhaitez afficher.
1. La console affiche une liste complète de tous les index de vecteur du compartiment, notamment :
+ **Nom** : nom de chaque index.
+ **Date de création** : date à laquelle l’index a été créé.
+ **Amazon Resource Name (ARN)** : ARN complet pour chaque index.
**Pour filtrer la liste**
1. Saisissez un nom ou un préfixe d’index dans le champ de recherche situé au-dessus de la liste d’index. Utilisez des préfixes pour rechercher des groupes d’index connexes.
1. La liste est mise à jour en temps réel à mesure que vous tapez.
### En utilisant le AWS CLI
Utilisez les exemples de commandes suivants et remplacez-les *user input placeholders* par vos propres informations.
**Pour répertorier les index dotés d’un préfixe spécifique dans un compartiment de vecteur**
Exemple de demande :
```
aws s3vectors list-indexes \
--vector-bucket-name "amzn-s3-demo-bucket" \
--prefix "idx" \
--max-results 1
```
Exemple de réponse :
```
{
"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"
}
]
}
```
**Pour répertorier les index avec pagination**
Exemple de demande :
```
aws s3vectors list-indexes \
--vector-bucket-name "amzn-s3-demo-bucket" \
--prefix "idx" \
--next-token "lObb29ZkzxMGtBXs97Rkbs26xdtKemu4brsnq2jX8DCocADkILv5cRphemXS3PXXFnQBihQBmESgEeKaGA"
```
Exemple de réponse :
```
{
"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"
}
]
}
```
### En utilisant le AWS SDKs
------
#### [ 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)
```
------
# Suppression d’un index vectoriel
Vous pouvez supprimer un index vectoriel si vous n’en avez plus besoin. Cette opération supprime définitivement l’index et tous les vecteurs qu’il contient.
**Important**
Lorsque vous supprimez un index vectoriel, vous devez connaître les points suivants :
Vous pouvez supprimer des index vectoriels même s’ils contiennent des vecteurs.
Tous les vecteurs enregistrés dans l’index sont définitivement supprimés
Toutes les métadonnées associées à ces vecteurs sont définitivement perdues
L’opération ne peut pas être annulée ou annulée
Toute opération en cours sur l’index échoue immédiatement
Les applications interrogeant l’index reçoivent des erreurs
Le nom de l’index peut être réutilisé dans le compartiment
## En utilisant le AWS CLI
Avant de supprimer un index vectoriel, vérifiez-le. Pour plus d'informations sur la façon de vérifier les détails de l'index, consultez [GetIndex](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetIndex.html)le manuel *Amazon S3 API Reference*. Pour plus d’informations sur la façon de répertorier les vecteurs dans l’index afin de voir ce qui sera supprimé, consultez [Création d’une liste des index vectoriels](s3-vectors-index-list.md).
Pour supprimer un index vectoriel, utilisez les exemples de commandes suivants. Remplacez les *user input placeholders* par vos propres informations.
```
aws s3vectors delete-index --vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx2"
```
Pour plus d’informations sur la vérification de la suppression de l’index, consultez [Création d’une liste des index vectoriels](s3-vectors-index-list.md).
## En utilisant le AWS SDKs
------
#### [ 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")
```
------
# Utilisation de balises avec des index vectoriels S3
Une AWS balise est une paire clé-valeur qui contient des métadonnées relatives aux ressources, en l'occurrence les index vectoriels Amazon S3. Vous pouvez baliser les index vectoriels S3 lorsque vous les créez ou gérer les balises sur les index vectoriels existants. Pour plus d’informations sur les balises, consultez [Balisage pour la répartition des coûts ou le contrôle d’accès par attributs (ABAC)](tagging.md).
**Note**
L'utilisation de balises sur des index vectoriels est gratuite, au-delà des taux de requêtes standard de l'API S3. Pour plus d’informations, consultez [Tarification Amazon S3](https://aws.amazon.com/s3/pricing/).
## Méthodes courantes d'utilisation de balises avec des index vectoriels
Utilisez des balises sur vos index vectoriels S3 pour :
+ **Allocation des coûts** — Suivez les coûts de stockage par balise d'index vectoriel dans AWS Billing and Cost Management. Pour de plus amples informations, veuillez consulter [Utilisation de balises pour la répartition des coûts](tagging.md#using-tags-for-cost-allocation).
+ **Contrôle d'accès basé sur les attributs (ABAC)** : échelonnez les autorisations d'accès et accordez l'accès aux index vectoriels S3 en fonction de leurs balises. Pour de plus amples informations, veuillez consulter [Utilisation de balises pour le contrôle d’accès par attributs (ABAC)](tagging.md#using-tags-for-abac).
**Note**
Vous pouvez utiliser les mêmes balises pour la répartition des coûts et le contrôle d’accès.
### ABAC pour les index vectoriels S3
Les index vectoriels Amazon S3 prennent en charge le contrôle d'accès basé sur les attributs (ABAC) à l'aide de balises. Utilisez des clés de condition basées sur des balises dans vos AWS organisations, IAM et les politiques d'index vectoriel S3. Pour les entreprises, ABAC dans Amazon S3 prend en charge l'autorisation sur plusieurs AWS comptes.
Dans vos politiques IAM, vous pouvez contrôler l'accès aux index vectoriels S3 en fonction des balises de l'index vectoriel à l'aide des clés de condition globales suivantes :
`aws:ResourceTag/key-name`
Utilisez cette clé pour comparer la paire valeur clé d'étiquette que vous spécifiez dans la politique avec la paire valeur clé attachée à la ressource. Par exemple, vous pouvez exiger que l'accès à une ressource soit autorisé uniquement si la clé de balise `Dept` est attachée à la ressource avec la valeur `Marketing`. Pour plus d'informations, consultez la section [Contrôle de l'accès aux AWS ressources](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).
`aws:RequestTag/key-name`
Utilisez cette clé pour comparer la paire clé-valeur de balise qui a été transmise dans la demande avec la paire de balises spécifiée dans la politique. Par exemple, vous pouvez vérifier que la demande comprend la clé de balise `Dept` et qu'elle a la valeur `Accounting`. Pour plus d'informations, consultez la section [Contrôle de l'accès lors AWS des demandes](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-requests). Vous pouvez utiliser cette clé de condition pour restreindre les paires clé-valeur de balise pouvant être transmises pendant les opérations d’API `TagResource` et `CreateIndex`.
`aws:TagKeys`
Utilisez cette clé pour comparer les clés de balise d’une demande avec celles spécifiées dans la politique. Nous vous recommandons, lorsque vous utilisez des politiques pour contrôler l'accès à l'aide de balises, d'utiliser la clé de condition `aws:TagKeys` pour définir quelles clés de balises sont autorisées. Pour des exemples de stratégies et plus d’informations, consultez [Contrôle de l’accès en fonction des clés de balise](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys). Vous pouvez créer un index vectoriel S3 avec des balises. Pour autoriser le balisage pendant l’opération d’API `CreateVectorBucket`, vous devez créer une stratégie qui inclut les actions `s3vectors:TagResource` et `s3vectors:CreateVectorBucket`. Vous pouvez ensuite utiliser la clé de condition `aws:TagKeys` pour imposer l’utilisation de clés de balise spécifiques dans la demande `CreateVectorBucket`.
### Exemples de politiques ABAC pour les index vectoriels
Consultez les exemples de politiques ABAC suivants pour les index vectoriels Amazon S3.
#### 1.1 - Politique IAM pour créer ou modifier des index vectoriels avec des balises spécifiques
Dans cette politique IAM, les utilisateurs ou les rôles soumis à cette politique ne peuvent créer des index vectoriels S3 que s'ils balisent l'index vectoriel avec la clé de balise `project` et la valeur de balise `Trinity` dans la demande de création d'index vectoriel. Ils peuvent également ajouter ou modifier des balises sur les index vectoriels S3 existants tant que la `TagResource` demande inclut la paire clé-valeur de la balise. `project:Trinity` Cette politique n'accorde aucune autorisation de lecture, d'écriture ou de suppression sur les index vectoriels ou leurs objets.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "CreateVectorIndexWithTags",
"Effect": "Allow",
"Action": [
"s3vectors:CreateIndex",
"s3vectors:TagResource"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:RequestTag/project": [
"Trinity"
]
}
}
}
]
}
```
#### 1.2 - Politique IAM visant à modifier les balises sur les ressources existantes tout en maintenant la gouvernance du balisage
Dans cette politique IAM, les principaux IAM (utilisateurs ou rôles) peuvent modifier les balises d'un index vectoriel uniquement si la valeur de la balise de l'index vectoriel correspond à la valeur de la `project` balise du principal. `project` Seules les quatre balises`project`, `environment``owner`, et `cost-center` spécifiées dans les clés de `aws:TagKeys` condition sont autorisées pour ces index vectoriels. Cela permet de renforcer la gouvernance des balises, d'empêcher les modifications non autorisées des balises et de garantir la cohérence du schéma de balisage dans tous vos index vectoriels.
```
{
"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"
]
}
}
}
]
}
```
# Gestion des balises pour les index vectoriels
Vous pouvez ajouter ou gérer des balises pour les index vectoriels S3 à l'aide de la console Amazon S3, du AWS Command Line Interface (AWS CLI) AWS SDKs, du ou à l'aide du S3 APIs : [TagResource[UntagResource](https://docs.aws.amazon.com/)](https://docs.aws.amazon.com/), et [ListTagsForResource](https://docs.aws.amazon.com/). Pour en savoir plus, consultez :
**Topics**
+ [Création d'index vectoriels à l'aide de balises](creating-vector-indexes-with-tags.md)
+ [Ajouter une balise à un index vectoriel](adding-tag-vector-index.md)
+ [Affichage des balises d'index vectoriels](viewing-vector-index-tags.md)
+ [Supprimer une balise d'un index vectoriel](deleting-tag-vector-index.md)
# Création d'index vectoriels à l'aide de balises
Vous pouvez baliser les index vectoriels Amazon S3 lorsque vous les créez. L'utilisation de balises sur des index vectoriels est gratuite, au-delà des taux de requêtes standard de l'API S3. Pour plus d’informations, consultez [Tarification Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Pour plus d'informations sur le balisage des index vectoriels, consultez. [Utilisation de balises avec des index vectoriels S3](vector-index-tagging.md)
## Permissions
Pour créer un index vectoriel avec des balises, vous devez disposer des autorisations suivantes :
+ `s3vectors:CreateIndex`
+ `s3vectors:TagResource`
## Résolution des erreurs
Si vous rencontrez une erreur lorsque vous tentez de créer un index vectoriel avec des balises, vous pouvez effectuer les opérations suivantes :
+ Vérifiez que vous disposez des [autorisations](#index-tags-permissions) requises pour créer l'index vectoriel et y ajouter une balise.
+ Vérifiez votre politique utilisateur IAM pour connaître les conditions du contrôle d’accès par attributs (ABAC). Il se peut que vous deviez étiqueter vos index vectoriels uniquement avec des clés et des valeurs de balise spécifiques. Pour de plus amples informations, veuillez consulter [Utilisation de balises pour le contrôle d’accès par attributs (ABAC)](tagging.md#using-tags-for-abac).
## Étapes
Vous pouvez créer un index vectoriel avec des balises appliquées à l'aide de la console Amazon S3, du AWS Command Line Interface (AWS CLI), de l'API REST Amazon S3 et AWS SDKs.
### Utilisation de la console S3
**Pour créer un index vectoriel avec des balises à l'aide de la console Amazon S3**
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez les **index vectoriels**.
1. Choisissez **créer un index vectoriel** pour créer un nouvel index vectoriel.
1. Créez un index vectoriel comme vous le feriez normalement ; voir[Création d’un index vectoriel dans un compartiment de vecteur](s3-vectors-create-index.md).
1. Sur la page **Créer un index vectoriel**, l'option **Tags** est disponible lors de la création d'un nouvel index vectoriel.
1. Entrez le nom de l'index vectoriel.
1. Choisissez **Ajouter une nouvelle balise** pour ouvrir l’éditeur Balises et saisissez une paire clé-valeur de balise. La clé de balise est obligatoire, mais la valeur est facultative.
1. Pour ajouter une autre balise, sélectionnez à nouveau **Ajouter une nouvelle balise**. Vous pouvez saisir jusqu’à 50 paires clé-valeur.
1. Après avoir défini les options pour votre nouvel index vectoriel, choisissez **Create vector index**.
### Utilisation de l'API REST
Pour plus d'informations sur la prise en charge de l'API REST Amazon S3 pour la création d'un index vectoriel avec des balises, consultez la section suivante du manuel *Amazon S3 Vectors API Reference* :
[CreateIndex](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_CreateIndex.html)
### À l'aide du AWS CLI
Pour l'installer AWS CLI, reportez-vous à la section [Installation du AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) dans le *guide de AWS Command Line Interface l'utilisateur*.
L'exemple de CLI suivant vous montre comment créer un index vectoriel avec des balises à l'aide du AWS CLI. Pour utiliser la commande, remplacez les *user input placeholders* par vos propres informations.
Lorsque vous créez un index vectoriel, vous devez fournir les détails de configuration et utiliser la convention de dénomination suivante : `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
```
# Ajouter une balise à un index vectoriel
Vous pouvez ajouter des balises aux index vectoriels Amazon S3 et modifier ces balises. L'utilisation de balises sur des index vectoriels est gratuite, au-delà des taux de requêtes standard de l'API S3. Pour plus d’informations, consultez [Tarification Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Pour plus d'informations sur le balisage des index vectoriels, consultez. [Utilisation de balises avec des index vectoriels S3](vector-index-tagging.md)
## Permissions
Pour ajouter une balise à un index vectoriel, vous devez disposer des autorisations suivantes :
+ `s3vectors:TagResource`
## Résolution des erreurs
Si vous rencontrez une erreur lorsque vous essayez d'ajouter une balise à un index vectoriel, vous pouvez effectuer les opérations suivantes :
+ Vérifiez que vous disposez des [autorisations](#add-index-tag-permissions) requises pour ajouter une balise à un index vectoriel.
+ Si vous avez essayé d'ajouter une clé de balise commençant par le préfixe AWS réservé`aws:`, modifiez la clé de balise et réessayez.
## Étapes
Vous pouvez ajouter des balises aux index vectoriels à l'aide de la console Amazon S3, du AWS Command Line Interface (AWS CLI), de l'API REST Amazon S3 et AWS SDKs.
### Utilisation de la console S3
**Pour ajouter des balises à un index vectoriel à l'aide de la console Amazon S3**
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez les **index vectoriels**.
1. Choisissez le nom de l'index vectoriel.
1. Choisissez l’onglet **Propriétés**.
1. Faites défiler la section **Balises** et choisissez **Ajouter une balise**.
1. La page **Ajouter des balises** s’ouvre. Vous pouvez saisir jusqu’à 50 paires clé-valeur de balise.
1. Si vous ajoutez une nouvelle balise portant le même nom de clé qu’une balise existante, la valeur de la nouvelle balise remplace celle de l’ancienne balise.
1. Vous pouvez également modifier les valeurs des clés existantes sur cette page.
1. Après avoir ajouté les balises, choisissez **Enregistrer les modifications**.
### Utilisation de l'API REST
Pour plus d'informations sur la prise en charge de l'API REST Amazon S3 pour l'ajout de balises à un index vectoriel, consultez la section suivante du manuel *Amazon S3 Vectors API Reference* :
[TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_TagResource.html)
### À l'aide du AWS CLI
Pour l'installer AWS CLI, reportez-vous à la section [Installation du AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) dans le *guide de AWS Command Line Interface l'utilisateur*.
L'exemple de CLI suivant montre comment ajouter des balises à un index vectoriel à l'aide du AWS CLI. Pour utiliser la commande, remplacez les *user input placeholders* par vos propres informations.
```
aws s3vectors tag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tags Stage=Prod,CostCenter=Marketing
```
# Affichage des balises d'index vectoriels
Vous pouvez afficher ou répertorier les balises appliquées aux index vectoriels Amazon S3. Pour plus d'informations sur le balisage des index vectoriels, consultez. [Utilisation de balises avec des index vectoriels S3](vector-index-tagging.md)
## Permissions
Pour afficher les balises appliquées à un index vectoriel, vous devez disposer des autorisations suivantes :
+ `s3vectors:ListTagsForResource`
## Résolution des erreurs
Si vous rencontrez une erreur lorsque vous tentez de répertorier ou d'afficher les balises d'un index vectoriel, vous pouvez effectuer les opérations suivantes :
+ Vérifiez que vous disposez des [autorisations](#view-index-tag-permissions) requises pour afficher ou répertorier les balises de l'index vectoriel.
## Étapes
Vous pouvez consulter les balises appliquées aux index vectoriels à l'aide de la console Amazon S3, du AWS Command Line Interface (AWS CLI), de l'API REST Amazon S3 et AWS SDKs.
### Utilisation de la console S3
**Pour afficher les balises appliquées à un index vectoriel à l'aide de la console Amazon S3**
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez les **index vectoriels**.
1. Choisissez le nom de l'index vectoriel.
1. Choisissez l’onglet **Propriétés**.
1. Accédez à la section **Tags** pour afficher toutes les balises appliquées à l'index vectoriel.
1. La section **Tags** affiche les tags définis par l'utilisateur par défaut. Vous pouvez sélectionner l'onglet balises AWS générées pour afficher les balises appliquées à votre index vectoriel par les AWS services.
### Utilisation de l'API REST
Pour plus d'informations sur la prise en charge de l'API REST Amazon S3 pour l'affichage des balises appliquées à un index vectoriel, consultez la section suivante du manuel Amazon Simple Vectors API Reference :
[ListTagsforResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListTagsForResource.html)
### À l'aide du AWS CLI
Pour l'installer AWS CLI, reportez-vous à la section [Installation du AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) dans le *guide de AWS Command Line Interface l'utilisateur*.
L'exemple de CLI suivant montre comment afficher les balises appliquées à un index vectoriel. Pour utiliser la commande, remplacez les *user input placeholders* par vos propres informations.
```
aws s3vectors list-tags-for-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index
```
# Supprimer une balise d'un index vectoriel
Vous pouvez supprimer des balises des index vectoriels S3. Une AWS balise est une paire clé-valeur qui contient des métadonnées relatives aux ressources, en l'occurrence les index vectoriels Amazon S3. Pour plus d'informations sur le balisage des index vectoriels, consultez. [Utilisation de balises avec des index vectoriels S3](vector-index-tagging.md)
**Note**
Si vous supprimez une balise et apprenez par la suite qu'elle était utilisée pour suivre les coûts ou pour contrôler l'accès, vous pouvez la réajouter à l'index vectoriel.
## Permissions
Pour supprimer une balise d'un index vectoriel, vous devez disposer des autorisations suivantes :
+ `s3vectors:UntagResource`
## Résolution des erreurs
Si vous rencontrez une erreur lorsque vous tentez de supprimer une balise d'un index vectoriel, vous pouvez effectuer les opérations suivantes :
+ Vérifiez que vous disposez des [autorisations](#delete-index-tag-permissions) requises pour supprimer une balise d'un index vectoriel.
## Étapes
Vous pouvez supprimer des balises d'index vectoriels à l'aide de la console Amazon S3, du AWS Command Line Interface (AWS CLI), de l'API REST Amazon S3 et AWS SDKs.
### Utilisation de la console S3
**Pour supprimer des balises d'un index vectoriel à l'aide de la console Amazon S3**
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez les **index vectoriels**.
1. Choisissez le nom de l'index vectoriel.
1. Choisissez l’onglet **Propriétés**.
1. Faites défiler la section **Balises** et cochez la case en regard de la ou des balises que vous souhaitez supprimer.
1. Sélectionnez **Delete (Supprimer)**.
1. La fenêtre contextuelle **Supprimer les balises définies par l’utilisateur** s’affiche et vous demande de confirmer la suppression de la ou des balises que vous avez sélectionnées.
1. Choisissez **Supprimer** pour confirmer.
### Utilisation de l'API REST
Pour plus d'informations sur la prise en charge de l'API REST Amazon S3 pour la suppression de balises d'un index vectoriel, consultez la section suivante du manuel *Amazon S3 Vectors API Reference* :
[UntagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_UntagResource.html)
### À l'aide du AWS CLI
Pour l'installer AWS CLI, reportez-vous à la section [Installation du AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) dans le *guide de AWS Command Line Interface l'utilisateur*.
L'exemple de CLI suivant montre comment supprimer des balises d'un index vectoriel à l'aide du AWS CLI. Pour utiliser la commande, remplacez les *user input placeholders* par vos propres informations.
```
aws s3vectors untag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tag-keys CostCenter Department
```