Balisage des ressources

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

Voici les ressources Amazon Bedrock que vous pouvez baliser :

• Modèles personnalisés

• Tâches de personnalisation de modèles

• Modèles provisionnés

• Tâches d’inférence par lots (API uniquement)

• Agents

• Alias d’agent

• Bases de connaissances

• Évaluations de modèle (console uniquement)

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.

1. Les ressources suivantes utilisent Amazon Bedrock TagResourceet UntagResourceListTagsForResourceses opérations.

   • Modèles personnalisés

   • Tâches de personnalisation de modèles

   • Modèles provisionnés

   • Tâches d’inférence par lots

2. Les ressources suivantes utilisent les agents pour Amazon Bedrock TagResourceet ListTagsForResourceses opérations. UntagResource

   • Agents

   • Alias d’agent

   • Bases de connaissances

Pour ajouter des balises à une ressource, envoyez une demande Amazon Bedrock TagResourceou Agents for Amazon Bedrock TagResource.

Pour annuler le balisage d'une ressource, envoyez une UntagResourcedemande UntagResourceor.

Pour répertorier les balises d'une ressource, envoyez une ListTagsForResourcedemande ListTagsForResourceor.

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')

Bonnes pratiques et restrictions

Pour connaître les meilleures pratiques et les restrictions relatives au balisage, consultez la section Marquage de vos AWS ressources.