Etiquetado de 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.

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 AWS Management Console, 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.

Etiquetado de los recursos de

Puede etiquetar entornos informáticos 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.

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.

Compatibilidad con el etiquetado de 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 informáticos AWS Batch	Sí	No. Las etiquetas del entorno informático 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.	Sí
Trabajos de AWS Batch	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: + - = . _ : / @.

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

Uso de etiquetas mediante la consola

Mediante la consola de AWS Batch, puede gestionar 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 informáticos de AWS Batch, los trabajos, las definiciones de trabajos, las colas de trabajos y las políticas de programación al crearlos.

Adición y eliminación de etiquetas en un recurso individual

AWS Batch le permite añadir o eliminar 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 consola de AWS Batch en https://console.aws.amazon.com/batch/.

2. En la barra de navegación, elija la región a utilizar.

3. En el panel de navegación, elija un tipo de recurso (por ejemplo, Colas de trabajos).

4. Elija un recurso específico y, a continuación, elija Editar etiquetas.

5. 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 junto a la etiqueta.

6. Repita este proceso para cada etiqueta que desee agregar o eliminar y, a continuación, elija Editar etiquetas para finalizar.

Uso de etiquetas mediante la CLI o la 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.

Compatibilidad con el etiquetado de 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	tag-resource	Add-BATResourceTag
Eliminar una o varias etiquetas.	UntagResource	untag-resource	Remove-BATResourceTag
Enumera las etiquetas de un recurso	ListTagsForResource	list-tags-for-resource	Get-BATResourceTag

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
Crear un entorno informático	CreateComputeEnvironment	create-compute-environment	New-BATComputeEnvironment
Cear una cola de trabajos	CreateJobQueue	create-job-queue	New-BATJobQueue
Crear una política de programación	CreateSchedulingPolicy	create-scheduling-policy	New-BATSchedulingPolicy
Registrar una definición de trabajo	RegisterJobDefinition	register-job-definition	Register-BATJobDefinition
Enviar un trabajo	SubmitJob	submit-job	Submit-BAT Job