aws:runInstances: avvio di un'istanza di Amazon EC2

Avvia una nuova istanza di Amazon Elastic Compute Cloud (Amazon EC2).

Input

L'operazione supporta la maggior parte dei parametri API. Per ulteriori informazioni, consulta la documentazione API relativa a 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

Riservata.

Tipo: string

Campo obbligatorio: no

BlockDeviceMappings

Dispositivi a blocchi per l'istanza.

Tipo: MapList

Campo obbligatorio: no

ClientToken

Identificatore univoco per assicurare l'idempotenza della richiesta.

Tipo: string

Campo obbligatorio: no

DisableApiTermination

Attiva o disattiva la terminazione dell'API dell'istanza.

Tipo: Booleano

Campo obbligatorio: no

EbsOptimized

Attiva o disattiva l'ottimizzazione di Amazon Elastic Block Store (Amazon EBS).

Tipo: Booleano

Campo obbligatorio: no

IamInstanceProfileArn

L'Amazon Resource Name (ARN) del profilo dell'istanza AWS Identity and Access Management (IAM) per l'istanza.

Tipo: string

Campo obbligatorio: no

IamInstanceProfileName

Nome del profilo dell'istanza IAM per l'istanza.

Tipo: string

Campo obbligatorio: no

ImageId

L'ID del Amazon Machine Image (AMI).

Tipo: string

Campo obbligatorio: sì

InstanceInitiatedShutdownBehavior

Indica se l'istanza viene arrestata o terminata in caso di arresto del sistema.

Tipo: string

Campo obbligatorio: no

InstanceType

Il tipo di istanza.

Nota

Se non viene fornito un valore di un tipo di istanza, viene utilizzato il tipo di istanza m1.small.

Tipo: string

Campo obbligatorio: no

KernelId

ID del kernel.

Tipo: string

Campo obbligatorio: no

KeyName

Nome della coppia di chiavi.

Tipo: string

Campo obbligatorio: no

MaxInstanceCount

Numero massimo di istanze da avviare.

Tipo: string

Campo obbligatorio: no

MetadataOptions

Le opzioni dei metadati per l'istanza. Per ulteriori informazioni, vedi InstanceMetadataOptionsRequest.

Tipo: StringMap

Campo obbligatorio: no

MinInstanceCount

Numero minimo di istanze da avviare.

Tipo: string

Campo obbligatorio: no

Monitoraggio

Attiva o disattiva il monitoraggio dettagliato.

Tipo: Booleano

Campo obbligatorio: no

NetworkInterfaces

Interfacce di rete.

Tipo: MapList

Campo obbligatorio: no

Placement

Posizionamento dell'istanza.

Tipo: StringMap

Campo obbligatorio: no

PrivateIpAddress

Indirizzo IPv4 primario.

Tipo: string

Campo obbligatorio: no

RamdiskId

L'ID del disco RAM.

Tipo: string

Campo obbligatorio: no

SecurityGroupIds

ID dei gruppi di sicurezza per l'istanza.

Tipo: StringList

Campo obbligatorio: no

SecurityGroups

Nomi dei gruppi di sicurezza per l'istanza.

Tipo: StringList

Campo obbligatorio: no

SubnetId

L'ID sottorete.

Tipo: string

Campo obbligatorio: no

TagSpecifications

I tag da applicare alle risorse durante il lancio. È possibile contrassegnare mediante tag solo le istanze e i volumi all'avvio. I tag specificati vengono applicati a tutti i volumi o le istanze che vengono creati durante il lancio. Per contrassegnare mediante tag un'istanza dopo che è stata avviata, utilizza l'operazione aws:createTags: creazione di tag per risorse di AWS.

Tipo: MapList (per ulteriori informazioni, consulta TagSpecification).

Campo obbligatorio: no

UserData

Script fornito sotto forma di valore letterale di stringa. Se viene immesso un valore letterale, deve essere con codifica Base64.

Tipo: string

Campo obbligatorio: no

Output

InstanceIds

ID delle istanze.

InstanceStates

Lo stato attuale dell'istanza.