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 grupos e instancias de Auto Scaling
Una *etiqueta* es una etiqueta de atributo personalizada que se asigna o que se AWS asigna a un AWS recurso. Cada etiqueta de tiene dos partes:
+ Una clave de etiqueta (por ejemplo, `costcenter`, `environment` o `project`)
+ Un campo opcional denominado valor de etiqueta (por ejemplo, `111122223333` o `production`)
Las etiquetas lo ayudan a hacer lo siguiente:
+ Realiza un seguimiento de tus 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 de costos](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) en la *Guía del usuario de AWS Billing *.
+ Controle el acceso a grupos de Auto Scaling en función de las etiquetas. Puede utilizar condiciones en sus políticas de IAM para controlar el acceso a los grupos de Auto Scaling en función de las etiquetas de ese grupo. Para obtener más información, consulte [Etiquetas para seguridad](tag-security.md).
+ Filtre y busque los grupos de escalado automático en función de las etiquetas que agregue. Para obtener más información, consulte [Uso de etiquetas para filtrar grupos de Auto Scaling](use-tag-filters-aws-cli.md).
+ 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.
Puede etiquetar grupos de Auto Scaling nuevos o existentes. También puede propagar etiquetas de un grupo de escalado automático a las instancias de Amazon EC2 que lance.
Las etiquetas no se propagan a volúmenes de Amazon EBS. Para agregar etiquetas a volúmenes de Amazon EBS, especifique las etiquetas en una plantilla de lanzamiento. Para obtener más información, consulte [Creación de una plantilla de lanzamiento para un grupo de Auto Scaling](create-launch-template.md).
Puede crear y administrar etiquetas a través de Consola de administración de AWS AWS CLI, o SDKs.
**Topics**
+ [Restricciones de nombres y uso de las etiquetas](#tag_restrictions)
+ [Ciclo de vida de etiquetado de las instancias EC2](#tag-lifecycle)
+ [Etiqueta los grupos de Auto Scaling](add-tags.md)
+ [Eliminar etiquetas](delete-tag.md)
+ [Etiquetas para seguridad](tag-security.md)
+ [Control del acceso a las etiquetas](tag-permissions.md)
+ [Uso de etiquetas para filtrar grupos de Auto Scaling](use-tag-filters-aws-cli.md)
## Restricciones de nombres y uso de las etiquetas
Se aplican las siguientes restricciones básicas a las etiquetas de :
+ El número máximo de etiquetas por recurso es 50.
+ El número máximo de etiquetas que puede añadir o eliminar con una sola llamada es 25.
+ La longitud máxima de la clave es de 128 caracteres Unicode.
+ La longitud máxima del valor es de 256 caracteres Unicode.
+ Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas. Como práctica recomendada, decida una estrategia de uso de mayúsculas y minúsculas en las etiquetas e implemente esa estrategia sistemáticamente en todos los tipos de recursos.
+ No utilice el `aws:` prefijo en los nombres o valores de las etiquetas, ya que está reservado para AWS su uso. No puede editar ni eliminar nombres o valores de etiqueta con este prefijo, y no se tienen en cuenta para su cuota de etiquetas por recurso.
## Ciclo de vida de etiquetado de las instancias EC2
Si ha decidido propagar las etiquetas a las instancias EC2, las etiquetas se administran de la siguiente manera:
+ Cuando un grupo de Auto Scaling lanza instancias, agrega etiquetas a las instancias durante la creación de recursos y no después de haberlos creado.
+ El grupo de Auto Scaling agrega automáticamente una etiqueta a las instancias con una clave de `aws:autoscaling:groupName` y un valor del nombre del grupo de Auto Scaling.
+ Si especifica etiquetas de instancia en la plantilla de lanzamiento y opta por propagar las etiquetas del grupo a sus instancias, todas las etiquetas se fusionarán. Si se especifica la misma clave de etiqueta para una etiqueta en su plantilla de lanzamiento y una etiqueta en su grupo de Auto Scaling, entonces el valor de la etiqueta del grupo tiene prioridad.
+ Cuando adjunta instancias existentes, el grupo de Auto Scaling agrega las etiquetas a las instancias, sobrescribiendo las etiquetas existentes con la misma clave de etiqueta. Asimismo, agrega una etiqueta con una clave de `aws:autoscaling:groupName` y un valor del nombre del grupo de Auto Scaling.
+ Cuando desvincula una instancia de un grupo de Auto Scaling, solo se elimina la etiqueta `aws:autoscaling:groupName`.
# Etiqueta los grupos de Auto Scaling
Cuando agrega una etiqueta a su grupo de Auto Scaling, puede especificar si se debe añadir a las instancias lanzadas en el grupo de Auto Scaling. Si modifica una etiqueta, la versión actualizada de la etiqueta se añade a las instancias lanzadas en el grupo de Auto Scaling tras el cambio. Si crea o modifica una etiqueta para un grupo de Auto Scaling, estos cambios no se realizan en las instancias que ya se están ejecutando en el grupo de Auto Scaling.
**Topics**
+ [Agregar o modificar etiquetas (consola)](#add-tags-console)
+ [Agregar o modificar etiquetas (AWS CLI)](#add-tags-aws-cli)
## Agregar o modificar etiquetas (consola)
**Para etiquetar un grupo de Auto Scaling en el momento de su creación**
Si utiliza la consola de Amazon EC2 para crear un grupo de Auto Scaling, puede especificar claves y valores de etiqueta en la página **Add tags (Agregar etiquetas)** del asistente de creación de un grupo de Auto Scaling. Para propagar una etiqueta por las instancias lanzadas en el grupo de Auto Scaling, no olvide mantener la opción **Tag New Instances (Etiquetar nuevas instancias)** de dicha etiqueta seleccionada. En caso contrario, puede anular la selección.
**Para agregar o modificar etiquetas en un grupo de Auto Scaling existente**
1. Abra la consola Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)y seleccione **Auto Scaling Groups** en el panel de navegación.
1. Seleccione la casilla situada junto al grupo de escalado automático.
Se abre un panel dividido en la parte inferior de la página **Auto Scaling groups** (Grupos de Auto Scaling).
1. En la pestaña **Details (Detalles)**, elija **Tags (Etiquetas)**, **Edit (Editar)**.
1. Para modificar las etiquetas existentes, edite **Key** y **Value**.
1. Para agregar una nueva etiqueta, seleccione **Add tag** y modifique **Key** y **Value**. Puede mantener la opción **Tag new instances (Etiquetar instancias nuevas)** seleccionada para agregar la etiqueta a las instancias lanzadas en el grupo de Auto Scaling automáticamente y cancelar su selección en caso contrario.
1. Cuando haya terminado de agregar etiquetas, elija **Update (Actualizar)**.
## Agregar o modificar etiquetas (AWS CLI)
Los siguientes ejemplos muestran cómo utilizarla para añadir etiquetas AWS CLI al crear grupos de Auto Scaling y cómo añadir o modificar etiquetas para los grupos de Auto Scaling existentes.
**Para etiquetar un grupo de Auto Scaling en el momento de su creación**
Utilice el [create-auto-scaling-group](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-auto-scaling-group.html)comando para crear un nuevo grupo de Auto Scaling y añadir una etiqueta, por ejemplo**environment=production**, al grupo Auto Scaling. La etiqueta también se añade a cualquier instancia lanzada en el grupo de Auto Scaling.
```
aws autoscaling create-auto-scaling-group --auto-scaling-group-name my-asg \
--launch-configuration-name my-launch-config --min-size 1 --max-size 3 \
--vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782" \
--tags Key=environment,Value=production,PropagateAtLaunch=true
```
**Para crear o modificar etiquetas en un grupo de Auto Scaling existente**
Utilice el comando [create-or-update-tags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/create-or-update-tags.html) para crear o modificar una etiqueta. Por ejemplo, el siguiente comando añade las etiquetas `costcenter=cc123` y `Name=my-asg`. Las etiquetas también se agregarán a cualquier instancia que se lance en el grupo de Auto Scaling después de realizar este cambio. Si ya existe una etiqueta con esta clave, se sustituye la etiqueta existente. La consola de Amazon EC2 asocia el nombre mostrado de cada instancia con el nombre que especificado en la clave `Name` (distingue entre mayúsculas y minúsculas).
```
aws autoscaling create-or-update-tags \
--tags ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Name,Value=my-asg,PropagateAtLaunch=true \
ResourceId=my-asg,ResourceType=auto-scaling-group,Key=costcenter,Value=cc123,PropagateAtLaunch=true
```
### Describa las etiquetas para un grupo de Auto Scaling (AWS CLI)
Si desea ver las etiquetas que se aplican a un grupo de Auto Scaling específico, puede utilizar cualquiera de los siguientes comandos:
+ [describe-tags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-tags.html): proporcione el nombre de grupo de escalado automático para ver una lista de etiquetas del grupo especificado.
```
aws autoscaling describe-tags --filters Name=auto-scaling-group,Values=my-asg
```
A continuación, se muestra un ejemplo de respuesta.
```
{
"Tags": [
{
"ResourceType": "auto-scaling-group",
"ResourceId": "my-asg",
"PropagateAtLaunch": true,
"Value": "production",
"Key": "environment"
}
]
}
```
+ [describe-auto-scaling-groups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html)— Debe proporcionar el nombre de su grupo de Auto Scaling para ver los atributos del grupo especificado, incluidas las etiquetas.
```
aws autoscaling describe-auto-scaling-groups --auto-scaling-group-name my-asg
```
A continuación, se muestra un ejemplo de respuesta.
```
{
"AutoScalingGroups": [
{
"AutoScalingGroupName": "my-asg",
"AutoScalingGroupARN": "arn",
"LaunchTemplate": {
"LaunchTemplateId": "lt-0b97f1e282EXAMPLE",
"LaunchTemplateName": "my-launch-template",
"Version": "$Latest"
},
"MinSize": 1,
"MaxSize": 5,
"DesiredCapacity": 1,
...
"Tags": [
{
"ResourceType": "auto-scaling-group",
"ResourceId": "my-asg",
"PropagateAtLaunch": true,
"Value": "production",
"Key": "environment"
}
],
...
}
]
}
```
# Eliminar etiquetas
Puede eliminar una etiqueta asociada a su grupo de Auto Scaling en cualquier momento.
**Topics**
+ [Eliminar etiquetas (consola)](#delete-tag-console)
+ [Eliminar etiquetas (AWS CLI)](#delete-tag-aws-cli)
## Eliminar etiquetas (consola)
**Cómo eliminar una etiqueta**
1. Abra la consola Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)y seleccione **Auto Scaling Groups** en el panel de navegación.
1. Seleccione la casilla de verificación situada junto a un grupo existente.
Se abre un panel dividido en la parte inferior de la página **Auto Scaling groups** (Grupos de Auto Scaling).
1. En la pestaña **Details (Detalles)**, elija **Tags (Etiquetas)**, **Edit (Editar)**.
1. Elija **Remove (Eliminar)** junto a la etiqueta.
1. Elija **Actualizar**.
## Eliminar etiquetas (AWS CLI)
Ejecute el comando [delete-tags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-tags.html) para eliminar una etiqueta. Por ejemplo, el comando siguiente elimina una etiqueta cuya clave es `environment`.
```
aws autoscaling delete-tags --tags "ResourceId=my-asg,ResourceType=auto-scaling-group,Key=environment"
```
Debe especificar la clave de etiqueta, pero no obligatorio especificar el valor. Si especifica un valor y el valor es incorrecto, la etiqueta no se elimina.
# Etiquetas para seguridad
Utilice las etiquetas para comprobar que el solicitante (como un rol o usuario de IAM) tiene permisos para crear, modificar o eliminar grupos específicos de escalado automático. Proporcione información de etiquetas en el elemento de condición de una política de IAM mediante una o más de las siguientes claves de condición:
+ Utilice `autoscaling:ResourceTag/tag-key: tag-value` para permitir (o denegar) acciones de los usuarios en grupos de Auto Scaling con etiquetas específicas.
+ Utilice `aws:RequestTag/tag-key: tag-value` para exigir que una etiqueta específica esté presente o no en una solicitud.
+ Utilice `aws:TagKeys [tag-key, ...]` para exigir que las claves de etiqueta específicas estén presentes o no en una solicitud.
Por ejemplo, puede denegar el acceso a todos los grupos de Auto Scaling que incluyan una etiqueta con la clave `environment` y el valor `production`, como se muestra en el ejemplo siguiente.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Deny",
"Action": [
"autoscaling:CreateAutoScalingGroup",
"autoscaling:UpdateAutoScalingGroup",
"autoscaling:DeleteAutoScalingGroup"
],
"Resource": "*",
"Condition": {
"StringEquals": {"autoscaling:ResourceTag/environment": "production"}
}
}
]
}
```
------
Para obtener más información acerca del uso de claves de condición para controlar el acceso a grupos de escalado automático, consulte [Cómo funciona Amazon EC2 Auto Scaling con IAM](control-access-using-iam.md).
# Control del acceso a las etiquetas
Utilice las etiquetas para comprobar que el solicitante (como un rol o usuario de IAM) tiene permisos para agregar, modificar o eliminar etiquetas específicas de escalado automático.
El siguiente ejemplo de política de IAM da permiso a la entidad principal para eliminar sólo la etiqueta con la clave `temporary` de los grupos de escalado automático.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "autoscaling:DeleteTags",
"Resource": "*",
"Condition": {
"ForAllValues:StringEquals": { "aws:TagKeys": ["temporary"] }
}
}
]
}
```
------
Para ver más ejemplos de políticas de IAM que imponen restricciones a las etiquetas especificadas para los grupos de escalado automático, consulte [Controlar qué claves de etiqueta y valores de etiqueta se pueden utilizar](security_iam_id-based-policy-examples.md#policy-example-tags).
**nota**
Aunque tenga una política que impida que los usuarios puedan realizar una operación de etiquetado (o eliminación de etiquetas) en un grupo de Auto Scaling, esto no les impedirá cambiar manualmente las etiquetas en las instancias una vez lanzadas. Para obtener ejemplos de control de acceso a las etiquetas en instancias de EC2, consulte [Ejemplo: Etiquetar recursos](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ExamplePolicies_EC2.html#iam-example-taggingresources) en la *Guía del usuario de Amazon EC2*.
# Uso de etiquetas para filtrar grupos de Auto Scaling
Los siguientes ejemplos muestran cómo usar filtros con el [describe-auto-scaling-groups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/describe-auto-scaling-groups.html)comando para describir grupos de Auto Scaling con etiquetas específicas. El filtrado por etiquetas se limita al SDK AWS CLI o a un SDK y no está disponible en la consola.
**Consideraciones de filtrado**
+ Puede especificar varios filtros y varios valores de filtro en una sola solicitud.
+ No puede utilizar comodines con los valores del filtro.
+ Los valores de filtro distinguen entre mayúsculas y minúsculas.
**Ejemplo: describir grupos de Auto Scaling con una clave de etiqueta y un par de valores específicos**
En el siguiente comando se muestra cómo filtrar los resultados para que aparezcan únicamente los grupos de Auto Scaling con la clave de etiqueta y el par de valores de **`environment=production`**.
```
aws autoscaling describe-auto-scaling-groups \
--filters Name=tag-key,Values=environment Name=tag-value,Values=production
```
A continuación, se muestra un ejemplo de respuesta.
```
{
"AutoScalingGroups": [
{
"AutoScalingGroupName": "my-asg",
"AutoScalingGroupARN": "arn",
"LaunchTemplate": {
"LaunchTemplateId": "lt-0b97f1e282EXAMPLE",
"LaunchTemplateName": "my-launch-template",
"Version": "$Latest"
},
"MinSize": 1,
"MaxSize": 5,
"DesiredCapacity": 1,
...
"Tags": [
{
"ResourceType": "auto-scaling-group",
"ResourceId": "my-asg",
"PropagateAtLaunch": true,
"Value": "production",
"Key": "environment"
}
],
...
},
... additional groups ...
]
}
```
Si lo desea, puede especificar las etiquetas mediante un filtro de `tag:`. Por ejemplo, en el siguiente comando se muestra cómo filtrar los resultados para que aparezcan únicamente los grupos de Auto Scaling con una clave de etiqueta y un par de valores de **`environment=production`**. Este filtro tiene el siguiente formato: `Name=tag:,Values=`, con **** y **** que representan una clave de etiqueta y un par de valores.
```
aws autoscaling describe-auto-scaling-groups \
--filters Name=tag:environment,Values=production
```
También puede filtrar los AWS CLI resultados mediante la `--query` opción. El siguiente ejemplo muestra cómo limitar el AWS CLI resultado del comando anterior únicamente al nombre del grupo, el tamaño mínimo, el tamaño máximo y los atributos de capacidad deseados.
```
aws autoscaling describe-auto-scaling-groups \
--filters Name=tag:environment,Values=production \
--query "AutoScalingGroups[].{AutoScalingGroupName: AutoScalingGroupName, MinSize: MinSize, MaxSize: MaxSize, DesiredCapacity: DesiredCapacity}"
```
A continuación, se muestra un ejemplo de respuesta.
```
[
{
"AutoScalingGroupName": "my-asg",
"MinSize": 0,
"MaxSize": 10,
"DesiredCapacity": 1
},
... additional groups ...
]
```
Para obtener más información sobre el filtrado, consulte [Filtrar los AWS CLI resultados](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-filter.html) en la *Guía del AWS Command Line Interface usuario*.
**Ejemplo: describir grupos de Auto Scaling con etiquetas que coincidan con la clave de etiqueta especificada**
En el siguiente comando se muestra cómo filtrar los resultados para que aparezcan únicamente los grupos de Auto Scaling con la etiqueta `environment`, independientemente del valor de esta.
```
aws autoscaling describe-auto-scaling-groups \
--filters Name=tag-key,Values=environment
```
**Ejemplo: describir grupos de Auto Scaling con etiquetas que coincidan con el conjunto de claves de etiqueta especificadas**
En el siguiente comando se muestra cómo filtrar los resultados para que aparezcan únicamente los grupos de Auto Scaling con etiquetas para `environment` y `project`, independientemente de los valores de estas.
```
aws autoscaling describe-auto-scaling-groups \
--filters Name=tag-key,Values=environment Name=tag-key,Values=project
```
**Ejemplo: describir grupos de Auto Scaling con etiquetas que coincidan con al menos una de las claves de etiqueta especificadas**
En el siguiente comando se muestra cómo filtrar los resultados para que aparezcan únicamente los grupos de Auto Scaling con etiquetas para `environment` o `project`, independientemente de los valores de estas.
```
aws autoscaling describe-auto-scaling-groups \
--filters Name=tag-key,Values=environment,project
```
**Ejemplo: describir grupos de Auto Scaling con el valor de etiqueta especificado**
En el siguiente comando se muestra cómo filtrar los resultados para que aparezcan únicamente los grupos de Auto Scaling con un valor de etiqueta de `production`, independientemente de la clave de etiqueta.
```
aws autoscaling describe-auto-scaling-groups \
--filters Name=tag-value,Values=production
```
**Ejemplo: describir grupos de Auto Scaling con el conjunto de valores de etiqueta especificados**
En el siguiente comando se muestra cómo filtrar los resultados para que aparezcan únicamente los grupos de Auto Scaling con los valores de etiqueta `production` y `development`, independientemente de la clave de etiqueta.
```
aws autoscaling describe-auto-scaling-groups \
--filters Name=tag-value,Values=production Name=tag-value,Values=development
```
**Ejemplo: describir grupos de Auto Scaling con etiquetas que coincidan con al menos uno de los valores de etiqueta especificados**
En el siguiente comando se muestra cómo filtrar los resultados para que aparezcan únicamente los grupos de Auto Scaling con un valor de etiqueta de `production` o `development`, independientemente de la clave de etiqueta.
```
aws autoscaling describe-auto-scaling-groups \
--filters Name=tag-value,Values=production,development
```
**Ejemplo: describir grupos de Auto Scaling con etiquetas que coincidan con varias claves de etiqueta especificadas**
También puede combinar filtros para crear lógicas AND y OR personalizadas y realizar un filtrado más complejo.
En el siguiente comando se muestra cómo filtrar los resultados para que aparezcan únicamente los grupos de Auto Scaling con un conjunto de etiquetas específico. Una clave de etiqueta es `environment` AND el valor de la etiqueta es (`production` OR `development`) AND la otra clave de etiqueta es `costcenter` AND el valor de la etiqueta es `cc123`.
```
aws autoscaling describe-auto-scaling-groups \
--filters Name=tag:environment,Values=production,development Name=tag:costcenter,Values=cc123
```