Marcação de recursos do Amazon Bedrock - Amazon Bedrock
Usar o consoleUsar a API

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 atribuído a um recurso da AWS. Cada tag consiste em uma chave e um valor.

As tags permitem categorizar os recursos da AWS de diferentes formas, por exemplo, por finalidade, por proprietário ou por aplicação. Para conferir as práticas recomendadas e restrições de marcação, consulte Marcar recursos da AWS.

As tags ajudam você a fazer o seguinte:

  • Identificar e organizar seus recursos da AWS. Muitos recursos da AWS oferecem suporte à marcação, portanto, é possível atribuir a mesma tag a recursos em diferentes serviços para indicar que os recursos são iguais.

  • Alocar custos. É possível ativar as tags no painel do Gerenciamento de Faturamento e Custos da AWS. A 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 no Guia do Usuário do Gerenciamento de Faturamento e Custos da AWS.

  • Controle o acesso aos seus recursos. É 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.

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 Recurso criado com a operação de API de Agentes do Amazon Bedrock Recurso criado com a API de Automação de Dados do Amazon Bedrock
Marcar um recurso

  • Se o recurso ainda não tiver sido criado, use o campo tags ao criá-lo.

  • Se o recurso já tiver sido criado, faça uma solicitação TagResource com um endpoint de tempo de compilação do recurso Automação de Dados do Amazon Bedrock.
Desmarcar um recurso Faça uma solicitação UntagResource com um endpoint de ambiente de gerenciamento do Amazon Bedrock. Faça uma solicitação UntagResource com um endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock. Faça uma solicitação UntagResource com um endpoint de tempo de compilação do recurso Automação de Dados do Amazon Bedrock.
Listar as tags para um recurso Faça uma solicitação ListTagsForResource com um endpoint de ambiente de gerenciamento do Amazon Bedrock. Faça uma solicitação ListTagsForResource com um endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock. Faça uma solicitação ListTagsForResource com um endpoint de tempo de compilação do recurso Automação de Dados do Amazon Bedrock.
nota

Ao visualizar essas operações no 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 pares de chave e valor com espaços.

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