Etiquetar las solicitudes de instancia de spot

Para ayudarlo a clasificar y a administrar las solicitudes de instancia de spot, puede etiquetarlas con metadatos personalizados. Puede asignar una etiqueta a una solicitud de instancia de spot cuando la cree o posteriormente. Puede asignar etiquetas mediante la consola de Amazon EC2 o una herramienta de línea de comandos.

Al etiquetar una solicitud de instancia de spot, las instancias y los volúmenes iniciados por la solicitud de instancia de spot no se etiquetan automáticamente. Tiene que etiquetar de manera explícita las instancias y los volúmenes iniciados por la solicitud de instancia de spot. Puede asignar una etiqueta a una instancia de spot y a los volúmenes durante la inicialización o después.

Para obtener más información sobre cómo funcionan las etiquetas, consulte Etiquetar los recursos de Amazon EC2.

Requisitos previos

Otorgue al usuario el permiso para etiquetar recursos. Para obtener más información acerca de las políticas de IAM y las políticas de ejemplo, consulte Ejemplo: Etiquetar recursos.

La política de IAM que cree se determina con el método que utilice para crear una solicitud de instancia de spot.

• Si utiliza el launch wizard de instancias o run-instances para solicitar instancias de spot, consulte To grant a user the permission to tag resources when using the launch instance wizard or run-instances.

• Si utiliza el comando request-spot-instances para solicitar instancias de spot, consulteTo grant a user the permission to tag resources when using request-spot-instances.

Para otorgar permiso a un usuario para etiquetar recursos cuando utilice el asistente de inicialización de instancias o instancias de ejecución

Cree una política de IAM que incluya lo siguiente:

• La acción ec2:RunInstances. Esto otorga al usuario permiso para iniciar una instancia.

• En Resource, especifique spot-instances-request. Esto permite a los usuarios crear solicitudes de instancias de spot, que solicitan instancias de spot.

• La acción ec2:CreateTags. Esto concede al usuario permiso para crear etiquetas.

• En Resource, especifique *. Esto permite a los usuarios etiquetar todos los recursos que se crean durante la inicialización de la instancia.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowLaunchInstances",
            "Effect": "Allow",
            "Action": [
                "ec2:RunInstances"
            ],
            "Resource": [
                "arn:aws:ec2:us-east-1::image/*",
                "arn:aws:ec2:us-east-1:*:subnet/*",
                "arn:aws:ec2:us-east-1:*:network-interface/*",
                "arn:aws:ec2:us-east-1:*:security-group/*",
                "arn:aws:ec2:us-east-1:*:key-pair/*",
                "arn:aws:ec2:us-east-1:*:volume/*",
                "arn:aws:ec2:us-east-1:*:instance/*",
                "arn:aws:ec2:us-east-1:*:spot-instances-request/*"
            ]
        },
        {
            "Sid": "TagSpotInstanceRequests",
            "Effect": "Allow",
            "Action": "ec2:CreateTags",
            "Resource": "*"
        }
    ]
}

Al utilizar la acción RunInstances para crear solicitudes de instancias de spot y etiquetar estas instancias durante la creación, debe tener en cuenta la manera en que Amazon EC2 evalúa el recurso spot-instances-request en la instrucción RunInstances. En la política de IAM, se evalúa de la siguiente manera:

• Si no etiqueta la solicitud de instancia de spot durante la creación, Amazon EC2 no evalúa el recurso spot-instances-request en la instrucción RunInstances.

• Si etiqueta la solicitud de instancia de spot durante la creación, Amazon EC2 evalúa el recurso spot-instances-request en la instrucción RunInstances.

Por lo tanto, para el recurso spot-instances-request, se aplican las siguientes reglas a la política de IAM:

• Si utiliza RunInstances para crear una solicitud de instancia de spot y no tiene la intención de etiquetar dicha solicitud durante la creación, no es necesario que permita explícitamente el recurso spot-instances-request; la llamada se realizará correctamente.

• Si utiliza RunInstances para crear una solicitud de instancia de spot y tiene la intención de etiquetar dicha solicitud durante la creación, debe incluir el recurso spot-instances-request en la instrucción de permiso de RunInstances; de lo contrario, la llamada devolverá un error.

• Si utiliza RunInstances para crear una solicitud de instancia de spot y tiene la intención de etiquetar dicha solicitud durante la creación, debe especificar el recurso spot-instances-request o incluir el comodín * en la instrucción de permiso de “CreateTags” (Crear etiquetas); de lo contrario, la llamada devolverá un error.

Para ejemplos de políticas de IAM, incluidas las políticas que no se admiten para las solicitudes de instancia de spot, consulte Trabajar con Instancias de spot.

Para conceder a un usuario el permiso para etiquetar recursos cuando utilice instancias de spot de solicitud

Cree una política de IAM que incluya lo siguiente:

• La acción ec2:RequestSpotInstances. Esto concede al usuario permiso para crear una solicitud de instancia de spot.

• La acción ec2:CreateTags. Esto concede al usuario permiso para crear etiquetas.

• En Resource, especifique spot-instances-request. Esto permite a los usuarios etiquetar solo la solicitud de instancia de spot.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "TagSpotInstanceRequest",
            "Effect": "Allow",
            "Action": [
                "ec2:RequestSpotInstances",
                "ec2:CreateTags"
            ],
            "Resource": "arn:aws:ec2:us-east-1:111122223333:spot-instances-request/*"
}

Etiquetar una nueva solicitud de instancia de spot

Console

Para etiquetar una nueva solicitud de instancia de spot mediante la consola

1. Siga el procedimiento indicado en Administración de instancias de spot.

2. Para agregar una etiqueta, en la página Agregar etiquetas elija Agregar etiqueta y escriba la clave y el valor de la etiqueta. Elija Agregar otra etiqueta para cada etiqueta adicional.

   Para cada etiqueta, puede etiquetar la solicitud de instancia de spot, las instancias de spot y los volúmenes con la misma etiqueta. Para etiquetar los tres, asegúrese de que estén seleccionadas las Instances (instancia[s]), los Volumes (Volúmenes) y las Spot Instance Requests (Solicitudes de instancias de spot). Para etiquetar solo uno o dos, asegúrese de que los recursos que desea etiquetar están seleccionados y de que los demás recursos están borrados.

3. Rellene los campos necesarios para crear una solicitud de instancia de spot y, a continuación, elija Launch (iniciar). Para obtener más información, consulte Administración de instancias de spot.

AWS CLI

Etiquetar una nueva solicitud de instancia de spot mediante la AWS CLI

Para etiquetar una solicitud de instancia de spot en la creación, configure los ajustes de la solicitud de instancia de spot de la siguiente manera:

• Especifique las etiquetas para la solicitud de instancias de spot mediante el parámetro --tag-specification.

• En ResourceType, especifique spot-instances-request. Si especifica otro valor, la solicitud de instancia de spot devolverá un error.

• Para Tags, especifique el par clave-valor. Puede especificar más de un par clave-valor.

En el siguiente ejemplo, la solicitud de instancia de spot se etiqueta con dos etiquetas: Key=Environment y Value=Production, además de Key=Cost-Center y Value=123.

aws ec2 request-spot-instances \
    --instance-count 5 \
    --type "one-time" \
    --launch-specification file://specification.json \
    --tag-specification 'ResourceType=spot-instances-request,Tags=[{Key=Environment,Value=Production},{Key=Cost-Center,Value=123}]'

Etiquetar una solicitud de instancia de spot existente

Console

Para etiquetar una solicitud de instancia de spot existente mediante la consola

Después de crear una solicitud de instancia de spot, puede agregar etiquetas a la solicitud de instancia de spot a través de la consola.

1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

2. En el panel de navegación, elija Solicitudes de spot.

3. Seleccione su solicitud de instancia de spot.

4. Elija la pestaña Tags (Etiquetas) y, a continuación, Create Tag (Crear etiqueta).

Para etiquetar una instancia de spot existente mediante la consola

Después de que se haya iniciado su solicitud de instancia de spot, puede agregar etiquetas a la instancia con la consola. Para obtener más información, consulte Agregar y eliminar etiquetas mediante la consola.

AWS CLI

Etiquetar una solicitud de instancia de spot o una instancia de spot existente mediante AWS CLI

Utilice el comando create-tags para etiquetar recursos existentes. En el siguiente ejemplo, la solicitud de instancia de spot existente y la instancia de spot se etiquetan con Key=purpose y Value=test.

aws ec2 create-tags \
    --resources sir-08b93456 i-1234567890abcdef0 \
    --tags Key=purpose,Value=test

Ver las etiquetas de las solicitudes de instancias de spot

Console

Para ver etiquetas de la solicitud de instancia de spot mediante la consola

1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

2. En el panel de navegación, elija Solicitudes de spot.

3. seleccione su solicitud de instancia de spot y elija la pestaña Tags (Etiquetas).

AWS CLI

Para describir las etiquetas de solicitud de instancia de spot

Las etiquetas de una solicitud de una instancia de spot se pueden ver al describir esa misma solicitud. Utilice el comando describe-spot-instance-requests para ver la configuración de la solicitud de instancia de spot especificada, que incluye las etiquetas especificadas para la solicitud.

aws ec2 describe-spot-instance-requests \
    --spot-instance-request-ids sir-EXAMPLE1 \
    --query "SpotInstanceRequests[*].Tags"

A continuación, se muestra un ejemplo del resultado.

[
    [
        {
            "Key": "Environment",
            "Value": "Production"
        },
        {
            "Key": "Department",
            "Value": "101"
        }
    ]
]