Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Assegnazione di tag alle risorse Amazon Bedrock

Per semplificare la gestione delle risorse Amazon Bedrock, puoi assegnare metadati personalizzati a ciascuna risorsa sotto forma di tag. Un tag è un'etichetta che si assegna a una AWS risorsa. Ciascun tag è formato da una chiave e da un valore,

I tag consentono di classificare le AWS risorse in diversi modi, ad esempio per scopo, proprietario o applicazione. Per le migliori pratiche e le restrizioni relative all'etichettatura, consulta Etichettare le risorse. AWS

I tag consentono di:

Contrassegna le risorse sull'endpoint bedrock-runtime

Le risorse create tramite il piano di bedrock-runtime controllo (ad esempio agenti, knowledge base, modelli personalizzati, throughput assegnato e flussi) vengono etichettate utilizzando operazioni API di tagging dedicate.

Eliminare con la console

Puoi aggiungere, modificare e rimuovere tag in qualsiasi momento durante la creazione o la modifica di una risorsa supportata.

Eliminare con l’API

Per eseguire operazioni di tagging, hai bisogno del nome della risorsa Amazon (ARN) su cui vuoi eseguire l'operazione. A seconda della risorsa per la quale desideri aggiungere o gestire tag, sono disponibili due serie di operazioni di tagging.

La tabella seguente riepiloga i diversi casi d’uso e le relative operazioni di assegnazione di tag:

Seleziona una scheda per visualizzare esempi di codice in un’interfaccia o in un linguaggio.

AWS CLI

Aggiungi due tag a un agente. key/value Separa le coppie con uno spazio.

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

Rimuovi i tag dall'agente. Separa le chiavi con uno spazio.

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

Elenca i tag per l'agente.

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

Python (Boto)

Aggiungi due tag a un agente.

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)

Rimuovi i tag dall'agente.

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

Elenca i tag per l'agente.

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

Etichetta le risorse sull'endpoint bedrock-mantle

L'bedrock-mantleendpoint supporta l'etichettatura di progetti, modelli personalizzati e prenotazioni. A differenza del piano di bedrock-runtime controllo, bedrock-mantle non espone operazioni dedicate TagResource o UntagResource ListTagsForResource API. Invece, si impostano e si leggono i tag in linea tramite le API delle risorse.

Impostazione dei tag

I tag vengono restituiti in linea nelle risposte Get and List per queste risorse.

Azioni di IAM

Sebbene non esistano endpoint di tagging dedicati, le seguenti azioni IAM vengono valutate quando si impostano, modificano o leggono i tag sulle risorse. bedrock-mantle Puoi scrivere policy IAM utilizzando questi nomi di azioni e le chiavi aws:RequestTagaws:TagKeys, e aws:ResourceTag condition per controllare l'accesso basato su tag.

Esempio

L'esempio seguente crea un progetto con due tag utilizzandocurl:

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'esempio seguente aggiunge un tag e ne rimuove un altro da un progetto esistente:

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"]
    }'