Etiquetado de los recursos de Amazon Bedrock - Amazon Bedrock
Uso de la consola Uso de la API

Etiquetado de los recursos de Amazon Bedrock

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

Las etiquetas le permiten clasificar los recursos de AWS de diversas maneras, por ejemplo, según su finalidad, propietario o aplicación. Para obtener información sobre las prácticas recomendadas y las restricciones sobre el etiquetado, consulte Etiquetado de los recursos de AWS.

Las etiquetas le ayudan a hacer lo siguiente:

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

  • Asignar costes. Las etiquetas se activan en el panel de Administración de facturación y costos de AWS. AWS usa las etiquetas para clasificar los costes y enviar 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 Administración de facturación y costos de AWS.

  • 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.

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.

En la siguiente tabla se indican los diferentes casos de uso y las operaciones de etiquetado que se deben utilizar en ellos:

Caso de uso Recurso creado con la operación de la API de Amazon Bedrock Recurso creado con la operación de la API de Agentes para Amazon Bedrock Recurso creado con la API de Automatización de Datos de Amazon Bedrock
Etiquetado de un recurso

  • Si el recurso aún no se ha creado, utilice el campo tags al crearlo.

  • Si el recurso ya se ha creado, realice una solicitud TagResource con un punto de conexión en tiempo de compilación de Automatización de Datos de Amazon Bedrock.
Eliminación de la etiqueta de un recurso Realice una solicitud UntagResource con un punto de conexión del plano de control de Amazon Bedrock. Envíe una solicitud UntagResource con un punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock. Envíe una solicitud UntagResource con un punto de conexión en tiempo de compilación de Automatización de Datos de Amazon Bedrock.
Enumera las etiquetas de un recurso Realice una solicitud ListTagsForResource con un punto de conexión del plano de control de Amazon Bedrock. Envíe una solicitud ListTagsForResource con un punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock. Envíe una solicitud ListTagsForResource con un punto de conexión en tiempo de compilación de Automatización de Datos de Amazon Bedrock.
nota

Al ver estas operaciones en CloudTrail, puede identificar el recurso específico que se está etiquetando comprobando los parámetros de la solicitud en los detalles del evento.

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