Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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 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. Para conocer las prácticas recomendadas y las restricciones sobre el etiquetado, consulte Etiquetar los recursos. AWS

Las etiquetas le ayudan a hacer lo siguiente:

Etiquete los recursos en el punto final de tiempo de ejecución básico

Los recursos creados a través del plano de bedrock-runtime control (como los agentes, las bases de conocimiento, los modelos personalizados, el rendimiento aprovisionado y los flujos) se etiquetan mediante operaciones de API de etiquetado específicas.

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:

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

AWS CLI

Agregar dos etiquetas a un agente. Separe key/value los pares 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')

Etiquete los recursos en el punto final del manto rocoso

El bedrock-mantle punto final permite etiquetar proyectos, modelos personalizados y reservas. A diferencia del plano de bedrock-runtime control, bedrock-mantle no expone las operaciones dedicadas TagResource o de ListTagsForResource API. UntagResource En su lugar, configura y lee las etiquetas en línea a través de las API de recursos.

Configuración de etiquetas

Las etiquetas se muestran en línea en las respuestas de Get y List de estos recursos.

Acciones de IAM

Aunque no hay puntos de enlace específicos para el etiquetado, las siguientes acciones de IAM se evalúan al configurar, cambiar o leer las etiquetas de los recursos. bedrock-mantle Puede escribir políticas de IAM con estos nombres de acción y las claves de aws:ResourceTag condición y aws:RequestTagaws:TagKeys, para controlar el acceso basado en etiquetas.

Ejemplo

En el siguiente ejemplo, se crea un proyecto con dos etiquetas mediante: curl

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

En el siguiente ejemplo, se agrega una etiqueta y se elimina otra de un proyecto 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"]
    }'