aws:runInstances: avvio di un'istanza di Amazon EC2 - AWS Systems Manager

• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la documentazione di Amazon CloudWatch Dashboard.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

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

Nota

L'azione aws:runInstances supporta un nuovo tentativo di limitazione (della larghezza di banda della rete) automatico. Per ulteriori informazioni, consulta Configurazione della ripetizione dei tentativi automatica per le operazioni di limitazione (della larghezza di banda della rete).

Input

L'operazione supporta la maggior parte dei parametri API. Per ulteriori informazioni, consulta la documentazione dell'RunInstancesAPI.

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: stringa

Obbligatorio: no

BlockDeviceMappings

Dispositivi a blocchi per l'istanza.

Tipo: MapList

Obbligatorio: no

ClientToken

Identificatore univoco per assicurare l'idempotenza della richiesta.

▬Tipo: stringa

Obbligatorio: no

DisableApiTermination

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

Tipo: Booleano

Obbligatorio: no

EbsOptimized

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

Tipo: Booleano

Obbligatorio: no

IamInstanceProfileArn

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

▬Tipo: stringa

Obbligatorio: no

IamInstanceProfileName

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

▬Tipo: stringa

Obbligatorio: no

ImageId

L'ID del Amazon Machine Image (AMI).

Tipo: stringa

Obbligatorio: sì

InstanceInitiatedShutdownBehavior

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

▬Tipo: stringa

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: stringa

Obbligatorio: no

KernelId

ID del kernel.

▬Tipo: stringa

Obbligatorio: no

KeyName

Nome della coppia di chiavi.

▬Tipo: stringa

Obbligatorio: no

MaxInstanceCount

Numero massimo di istanze da avviare.

▬Tipo: stringa

Obbligatorio: no

MetadataOptions

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

Tipo: StringMap

Obbligatorio: no

MinInstanceCount

Numero minimo di istanze da avviare.

▬Tipo: stringa

Obbligatorio: no

Monitoraggio

Attiva o disattiva il monitoraggio dettagliato.

Tipo: Booleano

Obbligatorio: no

NetworkInterfaces

Interfacce di rete.

Tipo: MapList

Obbligatorio: no

Placement

Posizionamento dell'istanza.

Tipo: StringMap

Obbligatorio: no

PrivateIpAddress

L' IPv4 indirizzo principale.

▬Tipo: stringa

Obbligatorio: no

RamdiskId

L'ID del disco RAM.

▬Tipo: stringa

Obbligatorio: no

SecurityGroupIds

I gruppi IDs di sicurezza per l'istanza.

Tipo: StringList

Obbligatorio: no

SecurityGroups

Nomi dei gruppi di sicurezza per l'istanza.

Tipo: StringList

Obbligatorio: no

SubnetId

L'ID sottorete.

▬Tipo: stringa

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— Crea tag per AWS le risorse.

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

Obbligatorio: no

UserData

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

▬Tipo: stringa

Obbligatorio: no

Output
InstanceIds

Le IDs istanze.

InstanceStates

Lo stato attuale dell'istanza.