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

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 balise est une étiquette que vous affectez à une ressource AWS. Chaque balise se compose d’une clé et d’une valeur.

Les balises vous permettent de classer vos ressources AWS de différentes manières, par exemple par objectif, par propriétaire ou par application. Pour connaître les bonnes pratiques et les restrictions relatives au balisage, consultez Balisage de vos ressources AWS.

Elles vous permettent d’effectuer les actions suivantes :

  • Identifier et organiser vos ressources AWS. De nombreuses ressources AWS prennent en charge le balisage. Vous pouvez donc attribuer la même balise à des ressources de différents services pour indiquer qu’elles sont liées.

  • Répartir les coûts. Vous activez ces balises sur le tableau de bord AWS Billing and Cost Management. AWS utilise les balises pour classer vos coûts et pour 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 utiliser des balises avec Amazon Bedrock afin de créer des politiques permettant de contrôler l’accès aux ressources 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, envoyez une demande TagResource avec un point de terminaison de compilation pour l’automatisation des données Amazon Bedrock.
Supprimer la balise d’une ressource Faites une demande UntagResource avec un point de terminaison du plan de contrôle Amazon Bedrock. Faites une demande UntagResource avec un point de terminaison de compilation pour agents Amazon Bedrock. Faites une demande UntagResource avec un point de terminaison de compilation pour l’automatisation des données Amazon Bedrock.
Répertorie les balises d'une ressource. Faites une demande ListTagsForResource avec un point de terminaison du plan de contrôle Amazon Bedrock. Faites une demande ListTagsForResource avec un point de terminaison de compilation pour agents Amazon Bedrock. Faites une demande ListTagsForResource avec un point de terminaison de compilation pour l’automatisation des données Amazon Bedrock.
Note

Lorsque vous consultez ces opérations dans CloudTrail, vous pouvez identifier la ressource spécifique étiquetée en vérifiant les paramètres de 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 paires clé/valeur 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')