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](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html) los recursos. AWS
Las etiquetas le ayudan a hacer lo siguiente:
+ Identifique y organice sus recursos. AWS 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 Administración de facturación y costos de AWS panel de control. AWS utiliza las etiquetas para clasificar los costes y entregarle un informe mensual de asignación de costes. Para obtener más información, consulte [Uso de etiquetas de asignación](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) en la *guía del usuario de Administración de facturación y costos de AWS *.
+ Controlar el acceso a los recursos de . 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.
**Topics**
+ [Etiquete los recursos en el punto final de tiempo de `ejecución básico`](#tagging-runtime)
+ [Etiquete los recursos en el punto final del `manto rocoso`](#tagging-mantle)
## 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:
****
| Caso de uso | Recurso creado con la operación de la API de [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Amazon_Bedrock.html) | Recurso creado con la operación de la API de [Agentes para Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_Operations_Agents_for_Amazon_Bedrock.html) | Recurso creado con la API de Automatización de Datos de Amazon Bedrock |
| --- | --- | --- | --- |
| Etiquetado de un recurso | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/tagging.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/tagging.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/tagging.html) |
| Eliminación de la etiqueta de un recurso | Realice una [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_UntagResource.html)solicitud con un [punto final del plano de control de Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Haga una [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html)solicitud a un punto final de tiempo de [construcción de Agents for Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) | Realice una UntagResource solicitud con un punto final de tiempo de compilación de Amazon Bedrock Data Automation. |
| Enumerar las etiquetas de un recurso | Realice una [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_ListTagsForResource.html)solicitud con un [punto final del plano de control de Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-cp). | Haga una [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html)solicitud a un punto final de tiempo de [construcción de Agents for Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) | Realice una ListTagsForResource solicitud con un punto final de tiempo de compilación de Amazon Bedrock Data Automation. |
**nota**
Al ver estas operaciones 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. 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
****
| Action | Llamada a la API | Etiquetar campos |
| --- | --- | --- |
| Crea un proyecto con etiquetas | POST /v1/organization/projects | tags |
| Agrega o elimina etiquetas en un proyecto existente | POST /v1/organization/projects/{project\_id} | add\_tags, remove\_tag\_keys, tags |
| Crea un modelo personalizado con etiquetas | Customized-model crear punto final | tags |
| Actualizar las etiquetas en un modelo personalizado | Customized-model actualizar el punto final | add\_tags, remove\_tag\_keys |
| Crea una reserva con etiquetas | Reserva: crear punto final | tags |
| Actualizar las etiquetas de una reserva | Punto final de actualización de reservas | add\_tags, remove\_tag\_keys |
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:RequestTag``aws:TagKeys`, para controlar el acceso basado en etiquetas.
+ `bedrock-mantle:TagResource`
+ `bedrock-mantle:UntagResource`
+ `bedrock-mantle:ListTagsForResource`
### 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"]
}'
```