aws:runInstances – Executa uma instância do Amazon EC2 - AWS Systems Manager

aws:runInstances – Executa uma instância do Amazon EC2

Inicia uma nova instância do Amazon Elastic Compute Cloud (Amazon EC2).

nota

A ação aws:runInstances suporta uma nova tentativa automática de controle de utilização. Para obter mais informações, consulte Configurar a repetição automática para operações com controle de utilização.

Input

A ação oferece suporte para a maioria dos parâmetros de API. Para obter mais informações, consulte a documentação da 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: string

Obrigatório: não

BlockDeviceMappings

Os dispositivos de bloco para a instância.

Tipo: MapList

Obrigatório: não

ClientToken

O identificador para garantir a idempotência da solicitação.

Tipo: string

Obrigatório: não

DisableApiTermination

Ativa ou desativa o encerramento da API da instância.

Tipo: booliano

Obrigatório: não

EbsOptimized

Ativa ou desativa a otimização do Amazon Elastic Block Store (Amazon EBS).

Tipo: booliano

Obrigatório: não

IamInstanceProfileArn

O nome do recurso da Amazon (ARN) do perfil da instância do AWS Identity and Access Management (IAM) a ser associado às instâncias.

Tipo: string

Obrigatório: não

IamInstanceProfileName

O nome do perfil de instância do IAM para a instância.

Tipo: string

Obrigatório: não

ImageId

O ID da Amazon Machine Image (AMI).

Tipo: String

Exigido: sim

InstanceInitiatedShutdownBehavior

Indica se a instância é interrompida ou encerrada no desligamento do sistema.

Tipo: string

Obrigatório: não

InstanceType

O tipo de instância.

nota

Se o valor de um tipo de instância não for fornecido, o tipo de instância m1.small será usado.

Tipo: string

Obrigatório: não

KernelId

O ID do kernel.

Tipo: string

Obrigatório: não

KeyName

O nome do par de chaves.

Tipo: string

Obrigatório: não

MaxInstanceCount

O número máximo de instâncias a serem executadas.

Tipo: string

Obrigatório: não

MetadataOptions

As opções de metadados da instância. Para obter mais informações, consulte InstanceMetadataOptionsRequest.

Tipo: StringMap

Obrigatório: não

MinInstanceCount

O número mínimo de instâncias a serem executadas.

Tipo: string

Obrigatório: não

Monitoramento

Ativa ou desativa o monitoramento detalhado.

Tipo: booliano

Obrigatório: não

NetworkInterfaces

As interfaces de rede.

Tipo: MapList

Obrigatório: não

Posicionamento

O posicionamento da instância.

Tipo: StringMap

Obrigatório: não

PrivateIpAddress

O endereço IPv4 primário.

Tipo: string

Obrigatório: não

RamdiskId

O ID do disco RAM.

Tipo: string

Obrigatório: não

SecurityGroupIds

Os IDs dos security groups da instância.

Tipo: StringList

Obrigatório: não

SecurityGroups

Os nomes dos security groups da instância.

Tipo: StringList

Obrigatório: não

SubnetId

O ID da sub-rede.

Tipo: string

Obrigatório: não

TagSpecifications

As tags a serem aplicadas aos recursos durante a execução. Você só pode marcar instâncias e volumes na inicialização. As tags especificadas são aplicadas a todas as instâncias ou volumes que são criados durante a execução. Para marcar uma instância depois que ela tiver sido iniciada, use a ação aws:createTags: cria tags para os recursos da AWS.

Tipo: MapList (Para obter mais informações, consulte TagSpecification.)

Obrigatório: não

UserData

Um script fornecido como um valor literal de string. Se um valor literal for inserido, ele deverá ser codificado em Base64.

Tipo: string

Obrigatório: não

Output
InstanceIds

Os IDs das instâncias.

InstanceStates

O estado atual da instância.