aws:runInstances: lanzar una instancia de Amazon EC2

Lanza una instancia nueva de Amazon Elastic Compute Cloud (Amazon EC2).

Entrada

La acción admite la mayoría de los parámetros de la API. Para obtener más información, consulte la documentación de la API RunInstances.

YAML

name: launchInstance
action: aws:runInstances
maxAttempts: 3
timeoutSeconds: 1200
onFailure: Abort
inputs:
  ImageId: ami-12345678
  InstanceType: t2.micro
  MinInstanceCount: 1
  MaxInstanceCount: 1
  IamInstanceProfileName: myRunCmdRole
  TagSpecifications:
  - ResourceType: instance
    Tags:
    - Key: LaunchedBy
      Value: SSMAutomation
    - Key: Category
      Value: HighAvailabilityFleetHost

JSON

{
   "name":"launchInstance",
   "action":"aws:runInstances",
   "maxAttempts":3,
   "timeoutSeconds":1200,
   "onFailure":"Abort",
   "inputs":{
      "ImageId":"ami-12345678",
      "InstanceType":"t2.micro",
      "MinInstanceCount":1,
      "MaxInstanceCount":1,
      "IamInstanceProfileName":"myRunCmdRole",
      "TagSpecifications":[
         {
            "ResourceType":"instance",
            "Tags":[
               {
                  "Key":"LaunchedBy",
                  "Value":"SSMAutomation"
               },
               {
                  "Key":"Category",
                  "Value":"HighAvailabilityFleetHost"
               }
            ]
         }
      ]
   }
}

AdditionalInfo

Reservado.

Tipo: cadena

Requerido: no

BlockDeviceMappings

Los dispositivos de bloques para la instancia.

Tipo: MapList

Requerido: no

ClientToken

El identificador para garantizar la instancia idempotente de la solicitud.

Tipo: cadena

Requerido: no

DisableApiTermination

Activa o desactiva la terminación de la API de la instancia.

Tipo: Booleano

Requerido: no

EbsOptimized

Activa o desactiva la optimización de Amazon Elastic Block Store (Amazon EBS).

Tipo: Booleano

Requerido: no

IamInstanceProfileArn

El nombre de recurso de Amazon (ARN) del perfil de instancia de AWS Identity and Access Management (IAM).

Tipo: cadena

Requerido: no

IamInstanceProfileName

El nombre del perfil de instancia de IAM correspondiente a la instancia.

Tipo: cadena

Requerido: no

ImageId

El ID de la Amazon Machine Image (AMI).

Tipo: cadena

Obligatorio: sí

InstanceInitiatedShutdownBehavior

Indica si la instancia se detiene o termina al cerrarse el sistema.

Tipo: cadena

Requerido: no

InstanceType

El tipo de instancia.

nota

Si no se proporciona el valor de tipo de instancia, se emplea el tipo de instancia m1.small.

Tipo: cadena

Requerido: no

KernelId

El ID del kernel.

Tipo: cadena

Requerido: no

KeyName

El nombre del par de claves.

Tipo: cadena

Requerido: no

MaxInstanceCount

El número máximo de instancias que se van a lanzar.

Tipo: cadena

Requerido: no

MetadataOptions

Opciones de metadatos de la instancia. Para obtener más información, consulte InstanceMetadataOptionsRequest.

Tipo: StringMap

Requerido: no

MinInstanceCount

El número mínimo de instancias que se van a lanzar.

Tipo: cadena

Requerido: no

Supervisión

Activa o desactiva el monitoreo detallado.

Tipo: Booleano

Requerido: no

NetworkInterfaces

Las interfaces de red.

Tipo: MapList

Requerido: no

Placement

La ubicación de la instancia.

Tipo: StringMap

Requerido: no

PrivateIpAddress

La dirección IPv4 principal.

Tipo: cadena

Requerido: no

RamdiskId

El ID del disco RAM.

Tipo: cadena

Requerido: no

SecurityGroupIds

Los ID de los grupos de seguridad para la instancia.

Tipo: StringList

Requerido: no

SecurityGroups

Los nombres de los grupos de seguridad para la instancia.

Tipo: StringList

Requerido: no

SubnetId

El ID de subred.

Tipo: cadena

Requerido: no

TagSpecifications

Las etiquetas que aplicar a los recursos durante el lanzamiento. Solo puede etiquetar instancias y volúmenes en el momento del lanzamiento. Las etiquetas especificadas se aplican a todas las instancias o volúmenes que se crean durante el lanzamiento. Para etiquetar una instancia después de que se haya lanzado, utilice la acción aws:createTags: crear etiquetas para recursos de AWS.

Tipo MapList (Para obtener más información, consulte TagSpecification).

Requerido: no

UserData

Un script proporcionado como un valor literal de cadena. Si se escribe un valor literal, debe estar codificado en Base64.

Tipo: cadena

Requerido: no

Salida

InstanceIds

Los ID de las instancias.

InstanceStates

El estado actual de la instancia.