Balisage des ressources Amazon Bedrock - Amazon Bedrock
Utilisation de la consoleUtilisation de l’API

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

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.

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 que les ressources 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 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.

Utilisation de la console

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

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 Ressource créée avec l’opération d’API Agents Amazon Bedrock Ressource créée avec l’API d’automatisation de données Amazon Bedrock
Étiqueter une ressource

  • Si la ressource n’a pas encore été créée, utilisez le champ tags lors de la création de la ressource.

  • Si la ressource a déjà été créée, faites une TagResourcedemande auprès d'un point de terminaison Agents for Amazon Bedrock Build-time.

  • Si la ressource n’a pas encore été créée, utilisez le champ tags lors de la création de la ressource.

  • Si la ressource a déjà été créée, faites une TagResource demande auprès d'un point de terminaison Amazon Bedrock Data Automation Build Time.
Supprimer la balise d’une ressource Faites une UntagResourcedemande auprès d'un point de terminaison du plan de contrôle Amazon Bedrock. Faites une UntagResourcedemande auprès d'un point de terminaison Agents for Amazon Bedrock Build-time. 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 ListTagsForResourcedemande avec un point de terminaison du plan de contrôle Amazon Bedrock. Faites une ListTagsForResourcedemande auprès d'un point de terminaison Agents for Amazon Bedrock Build-time. 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')