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.

As tags ajudam você a fazer o seguinte:

Marque recursos no endpoint bedrock-runtime

Os recursos criados por meio do plano de bedrock-runtime controle (como agentes, bases de conhecimento, modelos personalizados, taxa de transferência provisionada e fluxos) são marcados usando operações de API de marcação dedicadas.

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:

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

Marque recursos no endpoint bedrock-mantle

O bedrock-mantle endpoint oferece suporte à marcação de projetos, modelos personalizados e reservas. Ao contrário do plano de bedrock-runtime controle, bedrock-mantle não expõe operações TagResource UntagResource dedicadas ou de ListTagsForResource API. Em vez disso, você define e lê as tags em linha por meio das APIs de recursos.

Definindo tags

As tags são retornadas em linha nas respostas Get e List desses recursos.

Ações do IAM

Embora não haja endpoints de marcação dedicados, as ações do IAM a seguir são avaliadas quando você define, altera ou lê tags em bedrock-mantle recursos. Você pode escrever políticas do IAM usando esses nomes de ação e as chaves de aws:ResourceTag condição aws:RequestTagaws:TagKeys, e para controlar o acesso baseado em tags.

Exemplo

O exemplo a seguir cria um projeto com duas tags usandocurl:

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

O exemplo a seguir adiciona uma tag e remove outra de um projeto existente:

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