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 pipelines Amazon OpenSearch Ingestion
<a name="tag-pipeline"></a>

Les balises vous permettent d'attribuer des informations arbitraires à un pipeline Amazon OpenSearch Ingestion 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 que vous AWS attribuez à une AWS ressource. 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’effectuer les actions suivantes :
+ Identifiez et organisez 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 à un pipeline d' OpenSearch ingestion que celle que vous attribuez à un domaine Amazon OpenSearch Service.
+ Suivez vos AWS coûts. Vous activez ces balises sur le AWS Billing and Cost Management tableau de bord. AWS utilise les balises pour classer vos coûts et vous fournir un rapport mensuel de répartition des coûts. Pour plus d’informations, consultez [Utilisation des balises d’allocation des coûts](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) dans le [Guide de l’utilisateur AWS Billing](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/).
+ Limitez l'accès aux pipelines à l'aide d'un contrôle d'accès basé sur les attributs. Pour plus d'informations, veuillez consulter [Contrôle de l'accès en fonction des clés de balises](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys) dans le Guide de l'utilisateur IAM.

Dans OpenSearch Ingestion, la ressource principale est un pipeline. Vous pouvez utiliser la console de OpenSearch service, la AWS CLI OpenSearch APIs, Ingestion ou le AWS SDKs pour ajouter, gérer et supprimer des balises d'un pipeline.

**Topics**
+ [Autorisations nécessaires](#pipeline-tag-permissions)
+ [Utilisation des balises (console)](#tag-pipeline-console)
+ [Utilisation des balises (AWS CLI)](#tag-pipeline-cli)

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

OpenSearch L'ingestion utilise les autorisations AWS Identity and Access Management Access Analyzer (IAM) suivantes pour le balisage des pipelines :
+ `osis:TagResource`
+ `osis:ListTagsForResource`
+ `osis:UntagResource`

Pour plus d'informations sur chaque autorisation, consultez la section [Actions, ressources et clés de condition pour OpenSearch l'ingestion](https://docs.aws.amazon.com/service-authorization/latest/reference/list_opensearchingestionservice.html) dans la *référence d'autorisation de service*.

## Utilisation des balises (console)
<a name="tag-pipeline-console"></a>

La console est le moyen le plus simple de baliser un pipeline.

****Pour créer un tag****

1. Connectez-vous à la console Amazon OpenSearch Service sur [https://console.aws.amazon.com/aos/osis/home](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines). Vous serez sur la page Pipelines.

1. Sélectionnez le pipeline auquel vous souhaitez ajouter des balises et accédez à l'onglet **Tags**.

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 *.

## Utilisation des balises (AWS CLI)
<a name="tag-pipeline-cli"></a>

Pour baliser un pipeline à l'aide du AWS CLI, envoyez une `TagResource` demande : 

```
aws osis tag-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline 
  --tags Key=service,Value=osis Key=source,Value=otel
```

Supprimez les balises d'un pipeline à l'aide de la `UntagResource` commande :

```
aws osis untag-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline
  --tag-keys service
```

Affichez les balises existantes pour un pipeline à l'aide de la `ListTagsForResource` commande :

```
aws osis list-tags-for-resource
  --arn arn:aws:osis:us-east-1:123456789012:pipeline/my-pipeline
```