Etiquetado de los recursos de Amazon ECS

Como ayuda para administrar los recursos de Amazon ECS, puede asignar sus propios metadatos a cada recurso mediante etiquetas. Cada etiqueta consta de una clave y un valor opcional.

Puede utilizar etiquetas para clasificar los recursos de Amazon ECS de diversas maneras, por ejemplo, según su finalidad, propietario o entorno. Esto es útil cuando se tienen muchos recursos del mismo tipo. Puede identificar rápidamente un recurso específico según las etiquetas que le haya asignado. Por ejemplo, podría definir un conjunto de etiquetas para las instancias de contenedor de Amazon ECS de su cuenta. Esto le permite realizar un seguimiento del propietario y el nivel de la pila de cada instancia.

Puede utilizar etiquetas para sus informes de costo y uso. Puede utilizar estos informes para analizar el costo y el uso de los recursos de Amazon ECS. Para obtener más información, consulte Informes de uso de Amazon ECS.

aviso

Hay muchas API que devuelven las claves de las etiquetas y sus valores. Denegar el acceso a DescribeTags no deniega automáticamente el acceso a etiquetas devueltas por otras API. Como práctica recomendada, no debe incluir datos confidenciales en las etiquetas.

Recomendamos que idee un conjunto de claves de etiqueta que cumpla sus necesidades para cada tipo de recurso. Puede utilizar un conjunto coherente de claves de etiquetas para administrar los recursos más fácilmente. Puede buscar y filtrar los recursos en función de las etiquetas que agregue.

Las etiquetas no tienen ningún significado semántico para Amazon ECS, por lo que se interpretan estrictamente como cadenas de caracteres. Puede editar las claves y los valores de las etiquetas y también puede eliminar etiquetas de un recurso en cualquier momento. Puede establecer el valor de una etiqueta como una cadena vacía, pero no puede asignarle un valor nulo. Si agrega una etiqueta con la misma clave que una etiqueta existente en ese recurso, el nuevo valor sobrescribirá al anterior. Cuando elimina un recurso, también se eliminarán las etiquetas asignadas a dicho recurso.

Si utiliza AWS Identity and Access Management (IAM), puede controlar qué usuarios de su cuenta de AWS tienen permiso para administrar etiquetas.

Cómo se etiquetan los recursos

Hay varias formas de etiquetar las tareas, los servicios, las definiciones de tareas y los clústeres de Amazon ECS:

• El usuario etiqueta manualmente un recurso con la AWS Management Console, la API de Amazon ECS, la AWS CLI o un AWS SDK.

• El usuario crea un servicio o ejecuta una tarea independiente y selecciona la opción de etiquetas administradas por Amazon ECS.

  Amazon ECS etiqueta automáticamente todas las tareas recién lanzadas. Para obtener más información, consulte Etiquetas administradas por Amazon ECS.

• El usuario crea un recurso con la consola. La consola etiqueta automáticamente los recursos.

  Estas etiquetas se devuelven en la AWS CLI y las respuestas del SDK de AWS se muestran en la consola. No se pueden modificar ni eliminar.

  Para obtener información sobre las etiquetas agregadas, consulte la columna Etiquetas agregadas automáticamente por la consola en la tabla Compatibilidad de etiquetado para los recursos de Amazon ECS.

Si especifica etiquetas al crear un recurso y las etiquetas no se pueden aplicar, Amazon ECS revierte el proceso de creación. Esto garantiza que los recursos se creen con etiquetas o, de lo contrario, no se creen y que ningún recurso se quede jamás sin etiquetar. Al etiquetar los recursos en el momento de su creación, ya no es necesario ejecutar scripts de etiquetado personalizados después de la creación del recurso.

En la siguiente tabla se describen los recursos de Amazon ECS que admiten etiquetas.

Recurso	Admite etiquetas	Admite la propagación de etiquetas	Etiquetas agregadas automáticamente por la consola
Tareas de Amazon ECS	Sí	Sí, desde la definición de tarea.	Clave: aws:ecs:clusterName Valor: cluster-name
Servicios de Amazon ECS	Sí	Sí, ya sea desde la definición de tareas o el servicio a las tareas del servicio.	Clave: ecs:service:stackId Valor: arn:aws:cloudformation:arn
Conjuntos de tareas de Amazon ECS	Sí	No	N/A
Definiciones de tareas de Amazon ECS	Sí	No	Clave: ecs:taskDefinition:createdFrom Valor: ecs-console-v2
Clústeres de Amazon ECS	Sí	No	Clave: aws:cloudformation:logical-id Valor: ECSCluster Clave: aws:cloudformation:stack-id Valor: arn:aws:cloudformation:arn Clave: aws:cloudformation:stack-name Valor: ECS-Console-V2-Cluster-EXAMPLE
Instancias de contenedor de Amazon ECS	Sí	Sí, desde la instancia de Amazon EC2. Para obtener más información, consulte Adición de etiquetas a una instancia de contenedor de Amazon ECS.	N/A
Instancias externas de Amazon ECS	Sí	No	N/A
Proveedor de capacidad de Amazon ECS	Sí. No se pueden etiquetar los proveedores de capacidad predefinidos FARGATE ni FARGATE_SPOT.	No	N/A

Etiquetado de recursos durante la creación

Los recursos siguientes admiten el etiquetado en el momento de la creación mediante la API de Amazon ECS, la AWS CLI o el AWS SDK:

• Tareas de Amazon ECS

• Servicios de Amazon ECS

• Definición de tarea de Amazon ECS

• Conjuntos de tareas de Amazon ECS

• Clústeres de Amazon ECS

• Instancias de contenedor de Amazon ECS

• Proveedores de capacidad de Amazon ECS

Amazon ECS tiene la opción de utilizar la autorización de etiquetado para la creación de recursos. Cuando la Cuenta de AWS se configura para autorizar el etiquetado, los usuarios deben tener permisos para llevar a cabo las acciones que crean el recurso, como ecsCreateCluster. Si indica las etiquetas en la acción de creación de recursos, AWS hace otra autorización para verificar que los usuarios o roles tengan permisos para crear etiquetas. Por lo tanto, usted debe conceder permisos explícitos para utilizar la acción ecs:TagResource. Para obtener más información, consulte Conceder permisos para etiquetar recursos durante la creación. Para obtener información acerca de cómo configurar la opción, consulte Autorización de etiquetado.

Restricciones

Se aplican las siguientes restricciones a las etiquetas:

• Se puede asociar un máximo de 50 etiquetas a un recurso.

• Las claves de etiquetas no se pueden repetir para un recurso. Cada clave de etiqueta debe ser única y solo puede tener un valor.

• Las claves pueden tener hasta 128 caracteres en UTF-8.

• Los valores pueden tener hasta 256 caracteres en UTF-8.

• Si hay múltiples Servicios de AWS y los recursos usan su esquema de etiquetado, limite los tipos de caracteres que usa. Algunos servicios pueden tener restricciones en cuanto a los caracteres permitidos. En general, los caracteres permitidos son letras, números, espacios y los siguientes caracteres: + - = . _ : / @.

• Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.

• No puede utilizar aws:, AWS:, ni ninguna combinación de mayúsculas o minúsculas de dichas letras como prefijo para claves ni valores. Estos están reservados solo para la utilización de AWS. Las claves y valores de etiquetas que tienen este prefijo no se pueden editar. Las etiquetas con este prefijo no cuentan para el límite de etiquetas por recurso.

Etiquetas administradas por Amazon ECS

Cuando se utilizan las etiquetas administradas por Amazon ECS, dicho servicio etiqueta automáticamente todas las tareas que se acaban de lanzar y los volúmenes de Amazon EBS adjuntos a las tareas con la información del clúster y las etiquetas de definición de tareas agregadas por el usuario o las etiquetas de servicio. A continuación, se describen las etiquetas agregadas:

• Tareas independientes: una etiqueta con una clave como aws:ecs:clusterName y un valor establecidos en el nombre del clúster. Todas las etiquetas de definición de tareas que agregaron los usuarios. Un volumen de Amazon EBS adjunto a una tarea independiente recibirá la etiqueta con una clave como aws:ecs:clusterName y un valor establecidos en el nombre del clúster. Para obtener más información sobre el etiquetado de volúmenes de Amazon EBS, consulte Tagging Amazon EBS volumes.

• Tareas que forman parte de un servicio: una etiqueta con una clave como aws:ecs:clusterName y un valor establecidos en el nombre del clúster. Una etiqueta con una clave como aws:ecs:serviceName y un valor establecidos en el nombre del servicio. Etiquetas de alguno de los recursos siguientes:

  • Definiciones de tareas: todas las etiquetas de definiciones de tareas que agregaron los usuarios.

  • Servicios: todas las etiquetas de servicios que agregaron los usuarios.

    Un volumen de Amazon EBS adjunto a una tarea que forma parte de un servicio recibirá una etiqueta con una clave como aws:ecs:clusterName y un valor establecidos en el nombre del clúster, y una etiqueta con una clave como aws:ecs:serviceName y un valor establecidos en el nombre del servicio. Para obtener más información sobre el etiquetado de volúmenes de Amazon EBS, consulte Tagging Amazon EBS volumes.

Se requieren las siguientes opciones para esta función:

• Debe optar incluir los nuevos formatos de nombre de recurso de Amazon (ARN) e identificador (ID) de recursos. Para obtener más información, consulte Nombres de recursos de Amazon (ARN) e ID.

• Cuando usa las API para crear un servicio o ejecutar una tarea, debe configurar enableECSManagedTags a true para run-task y create-service. Para obtener más información, consulte create-service y run-task en la Referencia de la API AWS Command Line Interface.

• Amazon ECS utiliza etiquetas administradas para determinar cuándo están habilitadas algunas características, por ejemplo, el escalado automático de clústeres. Recomendamos no modificar las etiquetas manualmente para que Amazon ECS pueda administrar las características de forma eficaz.

Uso de etiquetas para facturación

AWS proporciona una herramienta de elaboración de informes llamada Cost Explorer, que puede utilizar para analizar el coste y la utilización de los recursos de Amazon ECS.

Puede utilizar Cost Explorer para ver gráficos sobre el uso y los costes. Puede ver los datos de los últimos 13 meses y predecir la cantidad que probablemente va a gastar durante los tres meses siguientes. Cost Explorer se puede utilizar para observar patrones de lo que se gasta en recursos de AWS a lo largo del tiempo. Por ejemplo, se puede utilizar para identificar aspectos que deben estudiarse más a fondo y observar tendencias que pueden ayudar a comprender los costos. También puede especificar intervalos de tiempo para los datos y ver los datos temporales por día o por mes.

Puede utilizar etiquetas administradas por Amazon ECS o agregadas por el usuario para su informe de costo y uso. Para obtener más información, consulte Informes de uso de Amazon ECS.

Para ver el costo de los recursos combinados, puede organizar la información de facturación basada en los recursos que tienen los mismos valores de clave de etiqueta. Por ejemplo, puede etiquetar varios recursos con un nombre de aplicación específico y luego organizar su información de facturación para ver los costos totales de la aplicación en distintos servicios. Para obtener más información acerca de la configuración de un informe de asignación de costos con etiquetas, consulte Informe de asignación de costos mensual en la Guía del usuario de AWS Billing.

Además, puede activar los Datos de asignación de costos divididos para incluir datos de uso de CPU y memoria a nivel de tarea en sus informes de costos y uso. Para obtener más información, consulte Informes sobre costo y uso de nivel de tarea.

nota

Si ha habilitado los informes, puede que los datos correspondientes al mes actual demoren hasta 24 horas en estar disponibles para su visualización.