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.

# Marquage des collections Amazon OpenSearch Serverless
<a name="tag-collection"></a>

Les balises vous permettent d'attribuer des informations arbitraires à une collection Amazon OpenSearch Serverless afin que vous puissiez les classer et les filtrer en fonction de ces informations. Une *balise* est une étiquette de métadonnées que vous attribuez ou attribuez à une AWS ressource. AWS 

Chaque balise se compose d’une *clé* et d’une *valeur*. Pour les balises que vous attribuez, vous définissez la clé et la valeur. Par exemple, vous pouvez définir la clé sur `stage` et la valeur pour une ressource sur `test`.

Les balises vous permettent d'identifier et d'organiser vos AWS ressources. De nombreux AWS services prennent en charge le balisage. Vous pouvez donc attribuer le même tag aux ressources de différents services pour indiquer que les ressources sont liées. Par exemple, vous pouvez attribuer la même balise à une collection OpenSearch sans serveur que celle que vous attribuez à un domaine Amazon OpenSearch Service.

Dans OpenSearch Serverless, la ressource principale est une collection. Vous pouvez utiliser la console de OpenSearch service AWS CLI, les opérations de l'API OpenSearch Serverless ou AWS SDKs pour ajouter, gérer et supprimer des balises dans une collection.

## Autorisations nécessaires
<a name="collection-tag-permissions"></a>

OpenSearch Serverless utilise les autorisations AWS Identity and Access Management Access Analyzer (IAM) suivantes pour baliser les collections :
+ `aoss:TagResource`
+ `aoss:ListTagsForResource`
+ `aoss:UntagResource`

# Balisage des collections (console)
<a name="tag-collection-console"></a>

La console constitue le moyen le plus simple de baliser une collection.

****Pour créer une identification (console)****

1. Connectez-vous à la console Amazon OpenSearch Service à la [https://console.aws.amazon.com/aos/maison](https://console.aws.amazon.com/aos/home ).

1. Développez **Serverless** (Sans serveur) dans le panneau de navigation de gauche et choisissez **Collections**.

1. Sélectionnez la collection à laquelle vous souhaitez ajouter des balises et accédez à l'onglet **Tags** (Balises).

1. Choisissez **Manage (Gérer)** et **Add new tag (Ajouter une nouvelle balise)**.

1. Saisissez une clé de balise et une valeur de balise facultative.

1. Choisissez **Save (Enregistrer)**.

Pour supprimer une balise, suivez les mêmes étapes et choisissez **Remove (Supprimer)** sur la page **Manage tags (Gérer les balises)**.

Pour plus d'informations sur l'utilisation de la console avec des identifications, veuillez consulter [Éditeur d'identification](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/tag-editor.html) dans le *Guide de démarrage de la console de gestion AWS *.

# Balisage de collections ()AWS CLI
<a name="tag-collection-cli"></a>

Pour étiqueter une collection à l'aide du AWS CLI, envoyez une [TagResource](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_TagResource.html)demande : 

```
aws opensearchserverless tag-resource
  --resource-arn arn:aws:aoss:us-east-1:123456789012:collection/my-collection 
  --tags Key=service,Value=aoss Key=source,Value=logs
```

Affichez les balises existantes pour une collection à l'aide de la [ListTagsForResource](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_ListTagsForResource.html)commande :

```
aws opensearchserverless list-tags-for-resource
  --resource-arn arn:aws:aoss:us-east-1:123456789012:collection/my-collection
```

Supprimez les tags d'une collection à l'aide de la [UntagResource](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_UntagResource.html)commande :

```
aws opensearchserverless untag-resource
  --resource-arn arn:aws:aoss:us-east-1:123456789012:collection/my-collection
  --tag-keys service
```