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](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html). AWS
I tag consentono di:
+ Identifica e organizza le tue risorse. AWS Molte AWS risorse supportano l'etichettatura, quindi puoi assegnare lo stesso tag a risorse di servizi diversi per indicare che le risorse sono le stesse.
+ Assegnare i costi. Puoi attivare i tag nella dashboard. Gestione costi e fatturazione AWS AWS utilizza i tag per classificare i costi e fornirti un rapporto mensile sull'allocazione dei costi. Per ulteriori informazioni, consulta la pagina sull'[utilizzo dei tag per l'allocazione dei costi](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) nella *Gestione costi e fatturazione AWS Guida per l'utente*.
+ Controllare l'accesso alle risorse. È possibile utilizzare i tag con Amazon Bedrock al fine di creare policy per controllare l’accesso alle risorse di Amazon Bedrock. Queste policy possono essere collegate a un ruolo IAM o a un utente per abilitare il controllo dell’accesso basato su tag.
**Topics**
+ [`Contrassegna le risorse sull'endpoint bedrock-runtime`](#tagging-runtime)
+ [Etichetta le risorse sull'endpoint `bedrock-mantle`](#tagging-mantle)
## `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:
****
| Caso d’uso | Risorsa creata con l’operazione API [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) | Risorsa creata con l’operazione API [Agent per Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) | Risorsa creata con l’API Amazon Bedrock Data Automation |
| --- | --- | --- | --- |
| Applicazione di tag a una risorsa | [See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/tagging.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/tagging.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/tagging.html) |
| Rimozione di tag da una risorsa | Effettua una [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UntagResource.html)richiesta con un [endpoint del piano di controllo Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Invia una [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html)richiesta a un endpoint in fase di [costruzione di Agents for Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) | Effettua una UntagResource richiesta con un endpoint Amazon Bedrock Data Automation Build time. |
| Elencare i tag associati a una risorsa | Effettua una [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListTagsForResource.html)richiesta con un [endpoint del piano di controllo Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Invia una [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html)richiesta a un endpoint in fase di [costruzione di Agents for Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) | Effettua una ListTagsForResource richiesta con un endpoint Amazon Bedrock Data Automation Build time. |
**Nota**
Quando visualizzi queste operazioni in CloudTrail, puoi identificare la risorsa specifica da etichettare controllando i parametri della richiesta nei dettagli dell'evento.
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-mantle`endpoint 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
****
| Azione | Chiamata API | Campi per tag |
| --- | --- | --- |
| Crea un progetto con tag | POST /v1/organization/projects | tags |
| Aggiungi o rimuovi tag su un progetto esistente | POST /v1/organization/projects/{project\_id} | add\_tags, remove\_tag\_keys, tags |
| Crea un modello personalizzato con tag | Customized-model creare un endpoint | tags |
| Aggiorna i tag su un modello personalizzato | Customized-model aggiorna endpoint | add\_tags, remove\_tag\_keys |
| Crea una prenotazione con tag | Prenotazione: crea un endpoint | tags |
| Aggiorna i tag su una prenotazione | Endpoint di aggiornamento della prenotazione | add\_tags, remove\_tag\_keys |
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:RequestTag``aws:TagKeys`, e `aws:ResourceTag` condition per controllare l'accesso basato su tag.
+ `bedrock-mantle:TagResource`
+ `bedrock-mantle:UntagResource`
+ `bedrock-mantle:ListTagsForResource`
### Esempio
L'esempio seguente crea un progetto con due tag utilizzando`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'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"]
}'
```