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 :

Marquer les ressources sur le point de terminaison Bedrock-Runtime

Les ressources créées via le plan de bedrock-runtime contrôle (telles que les agents, les bases de connaissances, les modèles personnalisés, le débit provisionné et les flux) sont balisées à l'aide d'opérations d'API de balisage dédiées.

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 :

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

Étiquetez les ressources sur le point de terminaison Bedrock-Mantle

Le bedrock-mantle point de terminaison prend en charge le balisage des projets, des modèles personnalisés et des réservations. Contrairement au plan bedrock-runtime de contrôle, bedrock-mantle il n'expose pas TagResource les UntagResource opérations dédiées ou ListTagsForResource d'API. Au lieu de cela, vous définissez et lisez les balises en ligne via les API de ressources.

Définition des balises

Les balises sont renvoyées en ligne dans les réponses Get et List pour ces ressources.

Actions IAM

Bien qu'il n'existe aucun point de terminaison de balisage dédié, les actions IAM suivantes sont évaluées lorsque vous définissez, modifiez ou lisez des balises sur des ressources. bedrock-mantle Vous pouvez écrire des politiques IAM à l'aide de ces noms d'action et des clés de aws:RequestTag condition et des clés de aws:ResourceTag condition pour contrôler l'accès basé sur des balises. aws:TagKeys

Exemple

L'exemple suivant crée un projet avec deux balises en utilisant curl :

curl -X POST https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects \
    -H "Authorization: Bearer $BEDROCK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "billing-experiments",
      "tags": {
        "department": "billing",
        "facing": "internal"
      }
    }'

L'exemple suivant ajoute une balise et en supprime une autre dans un projet existant :

curl -X POST https://bedrock-mantle.us-east-1.api.aws/v1/organization/projects/proj_abc123 \
    -H "Authorization: Bearer $BEDROCK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "add_tags": { "owner": "alice" },
      "remove_tag_keys": ["facing"]
    }'