Marcação de recursos do Amazon Bedrock

Para ajudar a gerenciar os recursos do Amazon Bedrock, você pode atribuir metadados a cada recurso usando etiquetas. 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.

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 AWS Billing and Cost Management 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 no Guia do Usuário AWS Billing and Cost Management .

• Controle o acesso aos seus recursos. Você pode usar tags com o Amazon Bedrock para criar políticas do para controlar o acesso aos recursos do Amazon Bedrock. Essas políticas podem ser anexadas a uma IAM função ou usuário para permitir o controle de acesso baseado em tags.

Os recursos do Amazon Bedrock que você pode marcar são:

• Modelos personalizados

• Trabalhos de personalização de modelos

• Trabalhos de duplicação de modelos

• Modo provisionado

• Trabalhos de inferência em lote (APIsomente)

• Atendentes

• Aliases de agentes

• Bases de conhecimento

• Avaliações de modelos (somente console)

• Solicitações no gerenciamento de alertas

• Fluxos

• Aliases de fluxo

Usar o console do

Você pode adicionar, modificar e remover etiquetas a qualquer momento durante a criação ou edição de um recurso compatível.

Use o API

Para realizar operações de marcação, você precisa do Amazon Resource Name (ARN) do recurso no qual 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.

1. Os recursos a seguir usam as ListTagsForResourceoperações Amazon Bedrock TagResourceUntagResource, e.

   • Modelos personalizados

   • Trabalhos de personalização de modelos

   • Trabalhos de duplicação de modelos

   • Modelos provisionados

   • Trabalhos de inferência em lote

2. Os seguintes recursos usam os Amazon Bedrock Agents TagResource, UntagResource, e ListTagsForResourceas operações.

   • Atendentes

   • Aliases de agentes

   • Bases de conhecimento

   • Solicitações no gerenciamento de alertas

   • Fluxos

   • Aliases de fluxo

Para adicionar tags a um recurso, envie uma solicitação do Amazon Bedrock TagResourceou do Amazon Bedrock Agents TagResource.

Para desmarcar um recurso, envie uma UntagResourcesolicitação UntagResourceou.

Para listar as tags de um recurso, envie uma ListTagsForResourcesolicitação ListTagsForResourceou.

Selecione uma guia para ver exemplos de código em uma interface ou linguagem.

AWS CLI

Adicione duas etiquetas 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')