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.
# Etiquetar los recursos de AWS Batch
Para ayudarle a administrar sus recursos de AWS Batch, puede asignar sus propios metadatos a cada recurso en forma de *etiquetas*. En este tema se describe qué son las etiquetas y cómo crearlas.
**Topics**
+ [Conceptos básicos de etiquetas](tag-basics.md)
+ [Etiquetar los recursos](tag-resources.md)
+ [Restricciones de las etiquetas](tag-restrictions.md)
+ [Tutorial: administración de etiquetas con la consola](tag-resources-console.md)
+ [Administración de etiquetas mediante el uso de CLI o API](tag-resources-api-sdk.md)
# Conceptos básicos de etiquetas
Una etiqueta es una marca que se asigna a un recurso de AWS. Cada etiqueta está formada por una *clave* y un *valor* opcional, ambos definidos por el usuario.
Las etiquetas le permiten clasificar los recursos de AWS según, por ejemplo, su finalidad, propietario o entorno. Cuando tenga muchos recursos del mismo tipo, puede identificar rápidamente un recurso específico en función de las etiquetas que le haya asignado. Por ejemplo, puede definir un conjunto de etiquetas para los servicios de AWS Batch para ayudarle a realizar un seguimiento del propietario y del nivel de pila de cada servicio. Le recomendamos que diseñe un conjunto coherente de claves de etiqueta para cada tipo de recurso.
Además, las etiquetas no se asignan a los recursos automáticamente. Después de agregar una etiqueta, puede editar las claves y los valores de las etiquetas o eliminar etiquetas de un recurso en cualquier momento. Si elimina un recurso, también se eliminará cualquier etiqueta asignada a dicho recurso.
Las etiquetas no tienen ningún significado semántico para AWS Batch, por lo que se interpretan estrictamente como cadenas de caracteres. Puede establecer el valor de una etiqueta como una cadena vacía, pero no puede asignarle un valor nulo. Si añade una etiqueta con la misma clave que una etiqueta existente en ese recurso, el nuevo valor sobrescribirá al antiguo.
Puede trabajar con etiquetas utilizando la Consola de administración de AWS, la AWS CLI y la API de AWS Batch.
Si utiliza AWS Identity and Access Management (IAM), puede controlar qué usuarios de su cuenta de AWS tienen permiso para crear, editar o eliminar etiquetas.
# Etiquetar los recursos
Puede etiquetar entornos de computación de AWS Batch, trabajos, definiciones de trabajos, colas de trabajos y políticas de programación nuevos o existentes.
Si utiliza la consola de AWS Batch, puede aplicar etiquetas a los recursos de nueva creación o a los recursos existentes cuando lo desee mediante la pestaña **Etiquetas** en la página de recursos en cuestión.
Si utiliza la API de AWS Batch, la AWS CLI o un SDK de AWS, puede aplicar etiquetas a los recursos nuevos mediante el parámetro de `tags` en la acción de la API pertinente o utilizar la acción de la API de `TagResource` para aplicar etiquetas a los recursos existentes. Para obtener más información, consulte [TagResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_TagResource.html).
Además, algunas acciones de creación de recursos le permiten especificar etiquetas para un recurso al crearlo. Si no se pueden aplicar etiquetas durante la creación del recurso, el proceso de creación de recursos falla. Esto garantiza que los recursos que pretendía etiquetar en el momento de su creación se creen con etiquetas específicas o no se creen en absoluto. Si etiqueta recursos en el momento de su creación, no es necesario ejecutar scripts de etiquetado personalizados después de la creación del recurso.
En la tabla siguiente se describen los recursos de AWS Batch que se pueden etiquetar y aquellos que se pueden etiquetar en el momento de su creación.
**Asistencia de etiquetas para recursos de AWS Batch**
| Recurso | Admite etiquetas | Admite la propagación de etiquetas | Admite el etiquetado durante la creación (API de AWS Batch, AWS CLI y SDK de AWS) |
| --- | --- | --- | --- |
| Entornos de computación AWS Batch | Sí | No. Las etiquetas del entorno de computación no se propagan a ningún otro recurso. Las etiquetas de los recursos se especifican en el miembro tags del objeto ComputeResources pasado en la operación de API [CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html). | Sí |
| AWS BatchTrabajos de | Sí | Sí | Sí |
| Definiciones de trabajo de AWS Batch | Sí | No | Sí |
| Colas de trabajo de AWS Batch | Sí | No | Sí |
| Políticas de programación de AWS Batch | Sí | No | Sí |
# Restricciones de las etiquetas
Se aplican las siguientes restricciones básicas a las etiquetas:
+ Número máximo de etiquetas por recurso: 50
+ Para cada recurso, cada clave de etiqueta debe ser única y solo puede tener un valor.
+ Longitud máxima de la clave: 128 caracteres Unicode en UTF-8
+ Longitud máxima del valor: 256 caracteres Unicode en UTF-8
+ Si se utiliza su esquema de etiquetado en múltiples servicios y recursos de AWS, recuerde que otros servicios pueden tener restricciones sobre caracteres permitidos. Los caracteres permitidos generalmente son: letras, números y espacios representables en UTF-8, además de los siguientes caracteres: \$1 - = . \$1 : / @.
+ Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.
+ No utilice `aws:`, `AWS:` ni ninguna combinación de mayúsculas o minúsculas del mismo como prefijo para claves o valores, ya que está reservado para uso de AWS. Las claves y valores de etiquetas que tienen este prefijo no se pueden editar. Las etiquetas que tengan este prefijo no cuentan para el límite de etiquetas por recurso.
# Tutorial: administración de etiquetas con la consola
Con la AWS Batch consola, puede administrar las etiquetas asociadas a los entornos informáticos, los trabajos, las definiciones de trabajos y las colas de trabajos nuevos o existentes.
## Adición de etiquetas a un recurso individual durante su creación
Puede añadir etiquetas a los entornos AWS Batch informáticos, los trabajos, las definiciones de trabajos, las colas de trabajos y las políticas de programación al crearlos.
## Agregar y eliminar etiquetas en un recurso individual
AWS Batch le permite añadir o eliminar las etiquetas asociadas a sus clústeres directamente desde la página del recurso.
**Para agregar o eliminar una etiqueta en un recurso individual**
1. Abra la AWS Batch consola en [https://console.aws.amazon.com/batch/](https://console.aws.amazon.com/batch/).
1. En la barra de navegación, elija la región a utilizar.
1. En el panel de navegación, elija un tipo de recurso (por ejemplo, **Colas de trabajos**).
1. Elija un recurso específico y, a continuación, elija **Editar etiquetas**.
1. Agregue o elimine sus etiquetas según sea necesario.
+ Para añadir una etiqueta, especifique la clave y el valor en los cuadros de texto vacíos al final de la lista.
+ Para eliminar una etiqueta, seleccione el botón ![\[\]](http://docs.aws.amazon.com/es_es/batch/latest/userguide/images/DeleteIcon.png) junto a la etiqueta.
1. Repita este proceso para cada etiqueta que desee agregar o eliminar y, a continuación, elija **Editar etiquetas** para finalizar.
# Administración de etiquetas mediante el uso de CLI o API
Utilice los siguientes comandos de AWS CLI u operaciones de la API de AWS Batch para agregar, actualizar, enumerar y eliminar las etiquetas de sus recursos.
**Asistencia de etiquetas para recursos de AWS Batch**
| Tarea | Acción de la API | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| Agregar o sobrescribir una o varias etiquetas. | [TagResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_TagResource.html) | [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/batch/tag-resource.html) | [Add-BATResourceTag](https://docs.aws.amazon.com/powershell/latest/reference/items/Add-BATResourceTag.html) |
| Eliminar una o varias etiquetas. | [UntagResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_UntagResource.html) | [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/batch/untag-resource.html) | [Remove-BATResourceTag](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-BATResourceTag.html) |
| Enumera las etiquetas de un recurso | [ListTagsForResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_ListTagsForResource.html) | [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/batch/list-tags-for-resource.html) | [Get-BATResourceTag](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-BATResourceTag.html) |
Los siguientes ejemplos muestran cómo agregar o quitar etiquetas a los recursos mediante la AWS CLI.
**Ejemplo 1: Etiquetar un recurso existente**
El siguiente comando etiqueta un recurso existente.
```
aws batch tag-resource --resource-arn resource_ARN --tags team=devs
```
**Ejemplo 2: Eliminar la etiqueta de un recurso existente**
El siguiente comando elimina una etiqueta de un recurso existente.
```
aws batch untag-resource --resource-arn resource_ARN --tag-keys tag_key
```
**Ejemplo 3: enumerar etiquetas de un recurso**
El siguiente comando enumera las etiquetas asociadas a un recurso existente.
```
aws batch list-tags-for-resource --resource-arn resource_ARN
```
Algunas acciones de creación de recursos le permiten especificar etiquetas al crear el recurso. Las siguientes acciones admiten etiquetado durante la creación.
| Tarea | Acción de la API | AWS CLI | AWS Tools for Windows PowerShell |
| --- | --- | --- | --- |
| Creación de un entorno de computación | [CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html) | [create-compute-environment](https://docs.aws.amazon.com/cli/latest/reference/batch/create-compute-environment.html) | [New-BATComputeEnvironment](https://docs.aws.amazon.com/powershell/latest/reference/items/New-BATComputeEnvironment.html) |
| Creación de una cola de trabajos | [CreateJobQueue](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateJobQueue.html) | [create-job-queue](https://docs.aws.amazon.com/cli/latest/reference/batch/create-job-queue.html) | [New-BATJobQueue](https://docs.aws.amazon.com/powershell/latest/reference/items/New-BATJobQueue.html) |
| Creación de una política de programación | [CreateSchedulingPolicy](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateSchedulingPolicy.html) | [create-scheduling-policy](https://docs.aws.amazon.com/cli/latest/reference/batch/create-scheduling-policy.html) | [New-BATSchedulingPolicy](https://docs.aws.amazon.com/powershell/latest/reference/items/New-BATSchedulingPolicy.html) |
| Registrar una definición de trabajo | [RegisterJobDefinition](https://docs.aws.amazon.com/batch/latest/APIReference/API_RegisterJobDefinition.html) | [register-job-definition](https://docs.aws.amazon.com/cli/latest/reference/batch/register-job-definition.html) | [Register-BATJobDefinition](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-BATJobDefinition.html) |
| Enviar un trabajo | [SubmitJob](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html) | [submit-job](https://docs.aws.amazon.com/cli/latest/reference/batch/submit-job.html) | [Submit-BAT Job](https://docs.aws.amazon.com/powershell/latest/reference/items/Submit-BATJob.html) |
| Creación del recurso consumible | [CreateConsumableResource](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateConsumableResource.html) | [create-consumable-resource](https://docs.aws.amazon.com/cli/latest/reference/batch/create-consumable-resource.html) | [Create-BATConsumableResource](https://docs.aws.amazon.com/powershell/latest/reference/items/Create-BATConsumableResource.html) |