# Etiquetado de una solicitud de flota de spot nueva o existente y las instancias y los volúmenes que inicia
Para ayudarlo a categorizar y a administrar las solicitudes de flota de spot y las instancias y los volúmenes que inicia, puede etiquetarlas con metadatos personalizados. Puede asignar una etiqueta a una solicitud de flota de spot cuando la cree o posteriormente. Del mismo modo, puede asignar una etiqueta a las instancias y los volúmenes cuando la flota los inicie o después.
Al etiquetar una solicitud de flota, las instancias y volúmenes iniciados por la flota no se etiquetan automáticamente. Tiene que etiquetar explícitamente las instancias y volúmenes iniciados por la flota. Puede elegir asignar etiquetas solo a la solicitud de flota, solo a las instancias iniciadas por la flota, solo a los volúmenes asociados a las instancias iniciadas por la flota o a todas ellas.
**nota**
Solo puede etiquetar volúmenes asociados a instancias bajo demanda. No se pueden etiquetar los volúmenes que están asociados a instancias de spot.
Puede asignar etiquetas mediante la consola de Amazon EC2 o una herramienta de línea de comandos.
Para obtener más información sobre cómo funcionan las etiquetas, consulte [Etiquetar los recursos de Amazon EC2](Using_Tags.md).
**Topics**
+ [Requisito previo](#tag-spot-fleet-prereqs)
+ [Etiquetado de una flota de spot nueva y las instancias y los volúmenes que inicia](#tag-new-spot-fleet-and-resources)
+ [Etiquetado de una flota de spot existente](#tag-existing-spot-fleet)
+ [Visualización de etiquetas de solicitud de flota de spot](#view-spot-fleet-tags)
## Requisito previo
Otorgue al usuario el permiso para etiquetar recursos. Para obtener más información, consulte [Ejemplo: Etiquetar recursos](ExamplePolicies_EC2.md#iam-example-taggingresources).
**Para conceder a un usuario el permiso para etiquetar recursos**
Cree una política de IAM que incluya lo siguiente:
+ La acción `ec2:CreateTags`. Esto concede al usuario permiso para crear etiquetas.
+ La acción `ec2:RequestSpotFleet`. Esto concede al usuario de IAM permiso para crear una solicitud de flota de spot.
+ Para `Resource`, debe especificar `"*"`. Esto permite a los usuarios etiquetar todos los tipos de recursos.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "TagSpotFleetRequest",
"Effect": "Allow",
"Action": [
"ec2:CreateTags",
"ec2:RequestSpotFleet"
],
"Resource": "*"
}
]
}
```
------
**importante**
Actualmente, no admitimos permisos de nivel de recursos para el recurso `spot-fleet-request`. Si especifica `spot-fleet-request` como recurso, obtendrá una excepción no autorizada cuando intente etiquetar la flota. En el ejemplo siguiente se muestra cómo *no* establecer la política.
```
{
"Effect": "Allow",
"Action": [
"ec2:CreateTags",
"ec2:RequestSpotFleet"
],
"Resource": "arn:aws:ec2:us-east-1:111122223333:spot-fleet-request/*"
}
```
Para dar acceso, agregue permisos a los usuarios, grupos o roles:
+ Usuarios y grupos en AWS IAM Identity Center:
Cree un conjunto de permisos. Siga las instrucciones de [Creación de un conjunto de permisos](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html) en la *Guía del usuario de AWS IAM Identity Center*.
+ Usuarios gestionados en IAM a través de un proveedor de identidades:
Cree un rol para la federación de identidades. Siga las instrucciones descritas en [Creación de un rol para un proveedor de identidad de terceros (federación)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) en la *Guía del usuario de IAM*.
+ Usuarios de IAM:
+ Cree un rol que el usuario pueda aceptar. Siga las instrucciones descritas en [Creación de un rol para un usuario de IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) en la *Guía del usuario de IAM*.
+ (No recomendado) Adjunte una política directamente a un usuario o agregue un usuario a un grupo de usuarios. Siga las instrucciones descritas en [Adición de permisos a un usuario (consola)](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) de la *Guía del usuario de IAM*.
## Etiquetado de una flota de spot nueva y las instancias y los volúmenes que inicia
**Etiquetado de una solicitud nueva de flota de spot y las instancias y los volúmenes que inicia mediante la consola**
1. Siga el procedimiento indicado en [Creación de una solicitud de flota de spot con los parámetros definidos](create-spot-fleet.md#create-spot-fleet-advanced).
1. La forma de agregar una etiqueta depende de si se ha configurado manualmente la flota o se ha utilizado una plantilla de inicialización.
+ Si configuró la flota de forma manual, realice el siguiente procedimiento:
Para agregar una etiqueta, expanda **Parámetros de lanzamiento adicionales**, elija **Crear etiqueta** y escriba la clave y el valor de la etiqueta. Repita este proceso para cada etiqueta.
Para cada etiqueta, puede etiquetar la solicitud de flota de spot y las instancias con la misma etiqueta. Para etiquetar ambas, asegúrese de que **Intancias** y **Flota** estén seleccionadas. Para etiquetar solo la solicitud de flota de spot, desmarque **Instancias**. Para solo etiquetar las instancias que inicia la flota, desmarque **Flota**.
**nota**
Al configurar manualmente una flota, no existe la opción de etiquetar los volúmenes. Las etiquetas de volumen solo se admiten para los volúmenes a los que se asocian Instancias bajo demanda. Al configurar manualmente una flota no puede especificar instancias bajo demanda.
+ Si ha utilizado una plantilla de inicialización, realice el siguiente procedimiento:
Para agregar una etiqueta a la solicitud de flota, en **Etiquetas**, elija **Crear etiqueta** y escriba la clave y el valor de la etiqueta. Repita este proceso para cada etiqueta.
Para etiquetar los recursos de su flota, debe especificar las etiquetas en la [plantilla de inicialización](create-launch-template.md).
**Para etiquetar una solicitud nueva de flota de spot y las instancias y los volúmenes que inicia mediante la AWS CLI**
Para etiquetar una solicitud de flota de spot al momento de crearla y para etiquetar las instancias y los volúmenes cuando la flota los inicia, ajuste la configuración de la solicitud de flota de spot de la siguiente manera:
**Etiquetas de solicitud de flota de spot:**
+ Especifique las etiquetas para la solicitud de flota de spot en `SpotFleetRequestConfig`.
+ En `ResourceType`, especifique `spot-fleet-request`. Si especifica otro valor, la solicitud de flota devolverá un error.
+ Para `Tags`, especifique el par clave-valor. Puede especificar más de un par clave-valor.
**Etiquetas de instancia:**
+ Especifique las etiquetas para las instancias en `LaunchSpecifications`.
+ En `ResourceType`, especifique `instance`. Si especifica otro valor, la solicitud de flota devolverá un error.
+ Para `Tags`, especifique el par clave-valor. Puede especificar más de un par clave-valor.
También puede especificar las etiquetas de la instancia en la [plantilla de inicialización](create-launch-template.md) a la que se hace referencia en la solicitud de flota de spot.
**Etiquetas de volumen:**
+ Especifique las etiquetas para los volúmenes de la [plantilla de inicialización](create-launch-template.md) a la que se hace referencia en la solicitud de flota de spot. No se admite el etiquetado de volumen en `LaunchSpecifications`.
En el ejemplo siguiente, la solicitud de flota de spot se etiqueta con dos etiquetas: Key=Environment y Value=Production, y Key=Cost-Center y Value=123. Las instancias iniciadas por la flota están etiquetadas con una etiqueta (que es la misma que una de las etiquetas para la solicitud de flota de spot): Key=Cost-Center y Value=123.
```
{
"SpotFleetRequestConfig": {
"AllocationStrategy": "priceCapacityOptimized",
"ExcessCapacityTerminationPolicy": "default",
"IamFleetRole": "arn:aws:iam::111122223333:role/aws-ec2-spot-fleet-tagging-role",
"LaunchSpecifications": [
{
"ImageId": "ami-0123456789EXAMPLE",
"InstanceType": "c4.large",
"TagSpecifications": [
{
"ResourceType": "instance",
"Tags": [
{
"Key": "Cost-Center",
"Value": "123"
}
]
}
]
}
],
"SpotPrice": "5",
"TargetCapacity": 2,
"TerminateInstancesWithExpiration": true,
"Type": "maintain",
"ReplaceUnhealthyInstances": true,
"InstanceInterruptionBehavior": "terminate",
"InstancePoolsToUseCount": 1,
"TagSpecifications": [
{
"ResourceType": "spot-fleet-request",
"Tags": [
{
"Key": "Environment",
"Value":"Production"
},
{
"Key": "Cost-Center",
"Value":"123"
}
]
}
]
}
}
```
**Para etiquetar instancias iniciadas por una flota de spot mediante la AWS CLI**
Para etiquetar instancias cuando la flota las inicia, puede especificar las etiquetas en la [plantilla de inicialización](create-launch-template.md) a la que se hace referencia en la solicitud de flota de spot, o bien especificar las etiquetas en la configuración de la solicitud de flota de spot de la siguiente manera:
+ Especifique las etiquetas para las instancias en `LaunchSpecifications`.
+ En `ResourceType`, especifique `instance`. Si especifica otro valor, la solicitud de flota devolverá un error.
+ Para `Tags`, especifique el par clave-valor. Puede especificar más de un par clave-valor.
En el ejemplo siguiente, las instancias iniciadas por la flota se etiquetan con una etiqueta: Key=Cost-Center y Value=123.
```
{
"SpotFleetRequestConfig": {
"AllocationStrategy": "priceCapacityOptimized",
"ExcessCapacityTerminationPolicy": "default",
"IamFleetRole": "arn:aws:iam::111122223333:role/aws-ec2-spot-fleet-tagging-role",
"LaunchSpecifications": [
{
"ImageId": "ami-0123456789EXAMPLE",
"InstanceType": "c4.large",
"TagSpecifications": [
{
"ResourceType": "instance",
"Tags": [
{
"Key": "Cost-Center",
"Value": "123"
}
]
}
]
}
],
"SpotPrice": "5",
"TargetCapacity": 2,
"TerminateInstancesWithExpiration": true,
"Type": "maintain",
"ReplaceUnhealthyInstances": true,
"InstanceInterruptionBehavior": "terminate",
"InstancePoolsToUseCount": 1
}
}
```
**Para etiquetar volúmenes adjuntados a instancias bajo demanda iniciadas por una flota de spot mediante la AWS CLI**
Para etiquetar volúmenes cuando los crea la flota, debe especificar las etiquetas en la [plantilla de inicialización](create-launch-template.md) a la que se hace referencia en la solicitud de flota de spot.
**nota**
Las etiquetas de volumen solo se admiten para los volúmenes a los que se asocian Instancias bajo demanda. No se pueden etiquetar los volúmenes que están asociados a Instancias de spot.
No se admite el etiquetado de volumen en `LaunchSpecifications`.
## Etiquetado de una flota de spot existente
**Para etiquetar una solicitud de flota de spot existente mediante la consola**
Después de crear una solicitud de flota de spot, puede agregar etiquetas a la solicitud de flota mediante la consola.
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación, elija **Spot Requests (Solicitudes de spot)**.
1. Seleccione la solicitud de flota de spot.
1. Elija la pestaña **Tags (Etiquetas)** y, a continuación, **Create Tag (Crear etiqueta)**.
**Para etiquetar una solicitud de flota de spot existente mediante la AWS CLI**
Puede utilizar el comando [create-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-tags.html) para etiquetar recursos existentes. En el ejemplo siguiente, la solicitud de flota de spot existente se etiqueta con Key=purpose y Value=test.
```
aws ec2 create-tags \
--resources sfr-11112222-3333-4444-5555-66666EXAMPLE \
--tags Key=purpose,Value=test
```
## Visualización de etiquetas de solicitud de flota de spot
**Para ver las etiquetas de solicitud de flota de spot mediante la consola**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación, elija **Solicitudes de spot**.
1. Seleccione su solicitud de flota de spot y elija la pestaña **Etiquetas**.
**Para describir las etiquetas de solicitud de flota de spot**
Utilice el comando [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-tags.html) para ver las etiquetas del recurso especificado. En el siguiente ejemplo, describe las etiquetas para la solicitud de flota de spot especificada.
```
aws ec2 describe-tags \
--filters "Name=resource-id,Values=sfr-11112222-3333-4444-5555-66666EXAMPLE"
```
```
{
"Tags": [
{
"Key": "Environment",
"ResourceId": "sfr-11112222-3333-4444-5555-66666EXAMPLE",
"ResourceType": "spot-fleet-request",
"Value": "Production"
},
{
"Key": "Another key",
"ResourceId": "sfr-11112222-3333-4444-5555-66666EXAMPLE",
"ResourceType": "spot-fleet-request",
"Value": "Another value"
}
]
}
```
También puede ver las etiquetas de una solicitud de flota de spot mediante la descripción de la solicitud de flota de spot.
Utilice el comando [describe-spot-fleet-requests](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-spot-fleet-requests.html) para ver la configuración de la solicitud de flota de spot especificada, que incluye las etiquetas especificadas para la solicitud de la flota.
```
aws ec2 describe-spot-fleet-requests \
--spot-fleet-request-ids sfr-11112222-3333-4444-5555-66666EXAMPLE
```
```
{
"SpotFleetRequestConfigs": [
{
"ActivityStatus": "fulfilled",
"CreateTime": "2020-02-13T02:49:19.709Z",
"SpotFleetRequestConfig": {
"AllocationStrategy": "capacityOptimized",
"OnDemandAllocationStrategy": "lowestPrice",
"ExcessCapacityTerminationPolicy": "Default",
"FulfilledCapacity": 2.0,
"OnDemandFulfilledCapacity": 0.0,
"IamFleetRole": "arn:aws:iam::111122223333:role/aws-ec2-spot-fleet-tagging-role",
"LaunchSpecifications": [
{
"ImageId": "ami-0123456789EXAMPLE",
"InstanceType": "c4.large"
}
],
"TargetCapacity": 2,
"OnDemandTargetCapacity": 0,
"Type": "maintain",
"ReplaceUnhealthyInstances": false,
"InstanceInterruptionBehavior": "terminate"
},
"SpotFleetRequestId": "sfr-11112222-3333-4444-5555-66666EXAMPLE",
"SpotFleetRequestState": "active",
"Tags": [
{
"Key": "Environment",
"Value": "Production"
},
{
"Key": "Another key",
"Value": "Another value"
}
]
}
]
}
```