Etiquetar recursos

Para ayudarle a administrar los recursos de Amazon Bedrock, puede asignar sus propios metadatos a cada recurso como etiquetas. Una etiqueta es una etiqueta que se asigna a un AWS recurso. Cada etiqueta consta de una clave y un valor.

Las etiquetas te permiten clasificar AWS los recursos de diferentes maneras, por ejemplo, por propósito, propietario o aplicación. Las etiquetas le ayudan a hacer lo siguiente:

• Identifique y organice sus AWS recursos. Muchos AWS recursos admiten el etiquetado, por lo que puede asignar la misma etiqueta a los recursos de distintos servicios para indicar que son los mismos.

• Asignar costos. Las etiquetas se activan en el AWS Billing and Cost Management panel de control. AWS usa las etiquetas para clasificar los costos y entregarte un informe mensual de asignación de costos. Para obtener más información, consulte Uso de etiquetas de asignación de costes en la Guía del usuario de AWS Billing and Cost Management .

• Controle el acceso a los recursos. Puede usar etiquetas con Amazon Bedrock que le permiten crear políticas para controlar el acceso a los recursos de Amazon Bedrock. Estas políticas se pueden asociar a un rol o usuario de IAM para habilitar el control de acceso basado en etiquetas.

Los recursos de Amazon Bedrock que puede etiquetar son:

• Modelos personalizados

• Trabajos de personalización de modelos

• Modo aprovisionado

• Trabajos de inferencia por lotes (solo API)

• Agentes

• Alias de agente

• Bases de conocimientos

• Evaluaciones de modelo (solo consola)

Uso de la consola

Puede agregar, modificar y eliminar etiquetas en cualquier momento mientras crea o edita un recurso compatible.

Uso de la API

Para realizar operaciones de etiquetado, necesita el nombre de recurso de Amazon (ARN) para el recurso en el que desea realizar una operación de etiquetado. Hay dos conjuntos de operaciones de etiquetado, según el recurso para el que vaya a agregar o administrar etiquetas.

1. Los siguientes recursos utilizan Amazon Bedrock TagResourcey UntagResourceListTagsForResourcesus operaciones.

   • Modelos personalizados

   • Trabajos de personalización de modelos

   • Modo aprovisionado

   • Trabajos de inferencia por lotes

2. Los siguientes recursos utilizan los agentes para Amazon TagResourceUntagResource, Bedrock y ListTagsForResourcesus operaciones.

   • Agentes

   • Alias de agente

   • Bases de conocimientos

Para añadir etiquetas a un recurso, envía una solicitud de Amazon Bedrock TagResourceo Agents for Amazon Bedrock TagResource.

Para quitar la etiqueta de un recurso, envía una UntagResourcesolicitud or. UntagResource

Para enumerar las etiquetas de un recurso, envía una ListTagsForResourcesolicitud ListTagsForResourceo.

Seleccione una pestaña para ver ejemplos de código en una interfaz o lenguaje.

AWS CLI

Agregar dos etiquetas a un agente. Separar los pares clave/valor con un espacio.

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

Quitar las etiquetas del agente. Separar claves con un espacio.

aws bedrock-agent untag-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345" \
    --tag-keys key=department facing

Enumerar las etiquetas para el agente.

aws bedrock-agent list-tags-for-resource \
    --resource-arn "arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345"

Python (Boto)

Agregar dos etiquetas 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)

Quitar las etiquetas del agente.

bedrock.untag_resource(
    resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345', 
    tagKeys=['department', 'facing']
)

Enumerar las etiquetas para el agente.

bedrock.list_tags_for_resource(resourceArn='arn:aws:bedrock:us-east-1:123456789012:agent/AGENT12345')

Prácticas recomendadas y restricciones

Para conocer las prácticas recomendadas y las restricciones sobre el etiquetado, consulte Etiquetar AWS los recursos.