

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 Braket
<a name="braket-tagging-resources"></a>

Una *etiqueta* es una etiqueta de atributo personalizada que se asigna o que se AWS asigna a un AWS recurso. Una etiqueta es un *metadato* que proporciona más información sobre su recurso. Cada etiqueta consta de una *clave* y un *valor*. En conjunto, se conocen como *pares clave-valor*. En el caso de etiquetas que usted asigna, debe definir la clave y el valor.

En la consola de Amazon Braket, puede ir a una tarea cuántica o un cuaderno y ver la lista de etiquetas asociadas. Puede añadir una etiqueta, eliminarla o modificarla. Puede etiquetar una tarea cuántica o un cuaderno al crearla y, a continuación, administrar las etiquetas asociadas a través de la consola AWS CLI, oAPI.

**Más información sobre AWS y etiquetas**
+ Para obtener información general sobre el etiquetado, incluidas las convenciones de nomenclatura y uso, consulta [¿Qué es el editor de etiquetas?](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html) en la Guía del usuario de * AWS los recursos de etiquetado y del editor de etiquetas*.
+ Para obtener información sobre las restricciones del etiquetado, consulte [los límites y requisitos de denominación de las etiquetas](https://docs.aws.amazon.com/tag-editor/latest/userguide/best-practices-and-strats.html#id_tags_naming_best_practices) en la Guía del usuario de *Tagging AWS Resources y Tag Editor*.
+ Para obtener información sobre las prácticas recomendadas y las estrategias de etiquetado, consulte [Prácticas recomendadas para el etiquetado de los recursos de AWS](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html).
+ Para obtener una lista de los servicios que admiten el uso de etiquetas, consulte [https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html).

En las siguientes secciones, se ofrece más información sobre las etiquetas de Amazon Braket.

**Topics**
+ [Uso de etiquetas](#tags)
+ [Recursos compatibles para el etiquetado en Amazon Braket](#tag-supported-resources)
+ [Etiquetado con la Amazon Braket API](#braket-cli-tagging)
+ [Restricciones de etiquetado](tag-restrictions.md)
+ [Administración de etiquetas en Amazon Braket](tag-managing.md)
+ [Ejemplo de AWS CLI etiquetado en Amazon Braket](braket-tags-example.md)

## Uso de etiquetas
<a name="tags"></a>

Las etiquetas pueden organizar sus recursos en categorías que le resulten útiles. Por ejemplo, puede asignar una etiqueta «Departamento» para especificar el departamento al que pertenece este recurso.

Cada etiqueta de tiene dos partes:
+ Una clave de etiqueta (por ejemplo *CostCenter*, *entorno* o *proyecto*). Las claves de etiquetas distinguen entre mayúsculas y minúsculas.
+ Un campo opcional conocido como valor de etiqueta (por ejemplo, 1*11122223333 *o *Production*). Omitir el valor de etiqueta es lo mismo que utilizar una cadena vacía. Al igual que las claves de etiquetas, los valores de las etiquetas distinguen mayúsculas de minúsculas.

Las etiquetas le ayudan a hacer lo siguiente:
+  **Identifique y organice sus AWS recursos.** Muchos Servicios de AWS admiten el etiquetado, por lo que puede asignar la misma etiqueta a los recursos de diferentes servicios para indicar que los recursos están relacionados.
+  **Realice un seguimiento de sus AWS costes.** Estas 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 *](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html).
+  **Controle el acceso a sus AWS recursos.** Para obtener más información, consulte [Control de acceso mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).

## Recursos compatibles para el etiquetado en Amazon Braket
<a name="tag-supported-resources"></a>

El siguiente tipo de recurso en Amazon Braket admite el etiquetado:
+  Recurso de [https://docs.aws.amazon.com/braket/latest/developerguide/braket-manage-access.html#resources](https://docs.aws.amazon.com/braket/latest/developerguide/braket-manage-access.html#resources)
+  **Nombre del recurso:** `AWS::Service::Braket` 
+  **Regex de ARN:** `arn:${Partition}:braket:${Region}:${Account}:quantum-task/${RandomId}` 

 **Nota:** Puedes aplicar y gestionar etiquetas para tus libretas Amazon Braket en la consola Amazon Braket, utilizando la consola para navegar hasta el recurso de libreta, aunque las libretas en realidad son recursos de Amazon AI. SageMaker Para obtener más información, consulte los [metadatos de las instancias de Notebook](https://docs.aws.amazon.com/sagemaker/latest/dg/nbi-metadata.html) en la documentación. SageMaker 

## Etiquetado con la Amazon Braket API
<a name="braket-cli-tagging"></a>
+ Su utiliza la API de Amazon Braket para configurar etiquetas en un recurso, llame a la [API de `TagResource`](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html).

 `aws braket tag-resource --resource-arn $YOUR_TASK_ARN --tags {\"city\":\"Seattle\"}` 
+ Para eliminar etiquetas de un recurso, llame a la [API de `UntagResource`](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html).

 `aws braket list-tags-for-resource --resource-arn $YOUR_TASK_ARN` 
+ Para enumerar todas las etiquetas asociadas a un recurso concreto, llame a la [API de `ListTagsForResource`](https://docs.aws.amazon.com/braket/latest/APIReference/API_Operations.html).

 `aws braket tag-resource --resource-arn $YOUR_TASK_ARN --tag-keys "[\"city\",\"state\"]"` 