As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Marcação de recursos do Amazon Bedrock
Para ajudar a gerenciar os recursos do Amazon Bedrock, você pode atribuir metadados a cada recurso usando tags. Uma tag é um rótulo que você atribui a um AWS recurso. Cada tag consiste em uma chave e um valor.
As tags permitem que você categorize seus AWS recursos de maneiras diferentes, por exemplo, por finalidade, proprietário ou aplicativo. Para ver as melhores práticas e restrições de marcação, consulte Como [marcar seus AWS recursos](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html).
As tags ajudam você a fazer o seguinte:
+ Identifique e organize seus AWS recursos. Muitos AWS recursos oferecem suporte à marcação, então você pode atribuir a mesma tag a recursos em serviços diferentes para indicar que os recursos são os mesmos.
+ Alocar custos. Você ativa as tags no Gerenciamento de Faturamento e Custos da AWS painel. AWS usa as tags para categorizar seus custos e entregar um relatório mensal de alocação de custos para você. Para obter mais informações, consulte [Usar etiquetas de alocação de custos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) no *Guia do Usuário do Gerenciamento de Faturamento e Custos da AWS *.
+ Controle o acesso aos recursos da . É possível usar tags com o Amazon Bedrock para criar políticas para controlar o acesso aos recursos do Amazon Bedrock. Essas políticas podem ser anexadas a um perfil do IAM ou um usuário para habilitar o controle de acesso baseado em tags.
**Topics**
+ [Usar o console](#tagging-console)
+ [Usar a API](#tagging-api)
## Usar o console
É possível adicionar, modificar e remover tags a qualquer momento durante a criação ou a edição de um recurso compatível.
## Usar a API
Para realizar operações de marcação, é necessário o nome do recurso da Amazon (ARN) do recurso em que você deseja realizar uma operação de marcação. Há dois conjuntos de operações de marcação, dependendo do recurso para o qual você está adicionando ou gerenciando etiquetas.
A seguinte tabela resume os diferentes casos de uso e as operações de atribuição de tags a serem usadas para eles:
****
| Caso de uso | Recurso criado com a operação de API do [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) | Recurso criado com a operação de API de [Agentes do Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) | Recurso criado com a API de Automação de Dados do Amazon Bedrock |
| --- | --- | --- | --- |
| Marcar um recurso | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/tagging.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/tagging.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/tagging.html) |
| Desmarcar um recurso | Faça uma [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UntagResource.html)solicitação com um [endpoint do plano de controle Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Faça uma [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html)solicitação com um endpoint de tempo de [construção do Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). | Faça uma UntagResource solicitação com um endpoint de tempo de construção do Amazon Bedrock Data Automation. |
| Lista de tags para um recurso | Faça uma [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListTagsForResource.html)solicitação com um [endpoint do plano de controle Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Faça uma [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html)solicitação com um endpoint de tempo de [construção do Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). | Faça uma ListTagsForResource solicitação com um endpoint de tempo de construção do Amazon Bedrock Data Automation. |
**nota**
Ao visualizar essas operações em CloudTrail, você pode identificar o recurso específico que está sendo marcado verificando os parâmetros da solicitação nos detalhes do evento.
Escolha uma guia para ver exemplos de código em uma interface ou linguagem.
------
#### [ AWS CLI ]
Adicione duas tags a um agente. Separe key/value os pares com um espaço.
```
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
```
Remova as etiquetas do agente. Separe as chaves com espaços.
```
aws bedrock-agent untag-resource \
--resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
--tag-keys key=department facing
```
Liste as etiquetas do agente.
```
aws bedrock-agent list-tags-for-resource \
--resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345"
```
------
#### [ Python (Boto) ]
Adicione duas etiquetas a um 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)
```
Remova as etiquetas do agente.
```
bedrock.untag_resource(
resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345',
tagKeys=['department', 'facing']
)
```
Liste as etiquetas do agente.
```
bedrock.list_tags_for_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345')
```
------