

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.

# Balisage des ressources Amazon Bedrock
<a name="tagging"></a>

Pour vous aider à gérer vos ressources Amazon Bedrock, vous pouvez attribuer des métadonnées à chaque ressource à l’aide de balises. Une étiquette est une étiquette que vous attribuez à une AWS ressource. Chaque balise se compose d’une clé et d’une valeur.

Les balises vous permettent de classer vos AWS ressources de différentes manières, par exemple par objectif, propriétaire ou application. Pour connaître les meilleures pratiques et les restrictions relatives au balisage, consultez la section [Marquage de vos AWS ressources](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html).

Elles vous permettent d’effectuer les actions suivantes :
+ Identifiez et organisez vos AWS ressources. De nombreuses AWS ressources prennent en charge le balisage. Vous pouvez donc attribuer le même tag aux ressources de différents services pour indiquer qu'elles sont identiques.
+ Répartir les coûts. Vous activez les tags 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 de répartition des coûts](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) dans le *Guide de l’utilisateur AWS Billing and Cost Management *.
+ Contrôler l’accès à vos ressources. Vous pouvez créer des politiques permettant de contrôler l’accès aux ressources Amazon Bedrock à l’aide de balises avec Amazon Bedrock. Ces politiques peuvent être attachées à un rôle ou à un utilisateur IAM pour activer le contrôle d'accès basé sur des balises.

**Topics**
+ [Utilisation de la console](#tagging-console)
+ [Utilisation de l’API](#tagging-api)

## Utilisation de la console
<a name="tagging-console"></a>

Vous pouvez ajouter, modifier et supprimer des balises à tout moment lors de la création ou de la modification d’une ressource prise en charge.

## Utilisation de l’API
<a name="tagging-api"></a>

Pour effectuer une opération de balisage d’une ressource, vous avez besoin de l’Amazon Resource Name (ARN) de cette dernière. Il existe deux ensembles d’opérations de balisage, selon la ressource pour laquelle vous ajoutez ou gérez des balises.

Le tableau suivant récapitule les différents cas d’utilisation et les opérations d’étiquetage à utiliser pour ceux-ci :


****  

| Cas d’utilisation | Ressource créée avec l’opération d’API [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) | Ressource créée avec l’opération d’API [Agents Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) | Ressource créée avec l’API d’automatisation de données Amazon Bedrock | 
| --- | --- | --- | --- | 
| Étiqueter une ressource |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/tagging.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/tagging.html)  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/bedrock/latest/userguide/tagging.html)  | 
| Supprimer la balise d’une ressource | Faites une [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UntagResource.html)demande auprès d'un point de [terminaison du plan de contrôle Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Faites une [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html)demande auprès d'un point de [terminaison Agents for Amazon Bedrock Build-time](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). | Faites une UntagResource demande auprès d'un point de terminaison Amazon Bedrock Data Automation Build Time. | 
| Répertorie les balises d'une ressource. | Faites une [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListTagsForResource.html)demande avec un point de [terminaison du plan de contrôle Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Faites une [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html)demande auprès d'un point de [terminaison Agents for Amazon Bedrock Build-time](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). | Faites une ListTagsForResource demande auprès d'un point de terminaison Amazon Bedrock Data Automation Build Time. | 

**Note**  
Lorsque vous visualisez ces opérations dans CloudTrail, vous pouvez identifier la ressource spécifique étiquetée en vérifiant les paramètres de la demande dans les détails de l'événement.

Sélectionnez un onglet pour voir des exemples de code dans une interface ou un langage donné.

------
#### [ AWS CLI ]

Ajoutez deux balises à un agent. Séparez les key/value paires par un espace.

```
aws bedrock-agent tag-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
    --tags key=department,value=billing key=facing,value=internal
```

Supprimez les balises de l’agent. Séparez les clés par un espace.

```
aws bedrock-agent untag-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
    --tag-keys key=department facing
```

Répertoriez les balises de l’agent.

```
aws bedrock-agent list-tags-for-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345"
```

------
#### [ Python (Boto) ]

Ajoutez deux balises à un agent.

```
import boto3

bedrock = boto3.client(service_name='bedrock-agent')

tags = [
    {
        'key': 'department',
        'value': 'billing'
    },
    {
        'key': 'facing',
        'value': 'internal'
    }
]

bedrock.tag_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345', tags=tags)
```

Supprimez les balises de l’agent.

```
bedrock.untag_resource(
    resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345', 
    tagKeys=['department', 'facing']
)
```

Répertoriez les balises de l’agent.

```
bedrock.list_tags_for_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345')
```

------