aws:runInstances – lancer une instance Amazon EC2 - AWS Systems Manager

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

aws:runInstances – lancer une instance Amazon EC2

Lance une nouvelle instance Amazon Elastic Compute Cloud (Amazon EC2).

Entrée

L'action prend en charge la plupart des paramètres de l'API. Pour plus d'informations, consultez la documentation de l'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

Instances réservées.

Type : chaîne

Obligatoire : non

BlockDeviceMappings

Périphériques de stockage en mode bloc pour l'instance.

Type : MapList

Obligatoire : non

ClientToken

Identifiant permettant de garantir l'idempotence de la demande.

Type : chaîne

Obligatoire : non

DisableApiTermination

Active ou désactive la résiliation de l'API d'instance.

Type : booléen

Obligatoire : non

EbsOptimized

Active ou désactive l'optimisation Amazon Elastic Block Store (Amazon EBS).

Type : booléen

Obligatoire : non

IamInstanceProfileArn

Amazon Resource Name (ARN) du profil d'instance AWS Identity and Access Management (IAM) à associer à l'instance.

Type : chaîne

Obligatoire : non

IamInstanceProfileName

Nom du profil d'instance IAM pour l'instance.

Type : chaîne

Obligatoire : non

ImageId

ID de l'Amazon Machine Image (AMI).

Type : chaîne

Obligatoire : oui

InstanceInitiatedShutdownBehavior

Indique si l'instance s'arrête ou est résiliée lors de l'arrêt du système.

Type : chaîne

Obligatoire : non

InstanceType

Type d'instance.

Note

Si aucune valeur de type d'instance n'est fournie, le type d'instance m1.small est utilisé.

Type : chaîne

Obligatoire : non

KernelId

ID du noyau.

Type : chaîne

Obligatoire : non

KeyName

Nom de la paire de clés.

Type : chaîne

Obligatoire : non

MaxInstanceCount

Nombre maximum d'instances à lancer.

Type : chaîne

Obligatoire : non

MetadataOptions

Options de métadonnées de l'instance. Pour plus d'informations, veuillez consulter la rubrique InstanceMetadataOptionsRequest.

Type : StringMap

Obligatoire : non

MinInstanceCount

Nombre minimum d'instances à lancer.

Type : chaîne

Obligatoire : non

Surveillance

Active ou désactive la surveillance détaillée.

Type : booléen

Obligatoire : non

NetworkInterfaces

Interfaces réseau.

Type : MapList

Obligatoire : non

Placement

Placement de l'instance.

Type : StringMap

Obligatoire : non

PrivateIpAddress

Adresse IPv4 principale.

Type : chaîne

Obligatoire : non

RamdiskId

ID du disque RAM.

Type : chaîne

Obligatoire : non

SecurityGroupIds

ID des groupes de sécurité de l'instance.

Type : StringList

Obligatoire : non

SecurityGroups

Noms des groupes de sécurité de l'instance.

Type : StringList

Obligatoire : non

SubnetId

ID de sous-réseau.

Type : chaîne

Obligatoire : non

TagSpecifications

Balises à appliquer aux ressources lors du lancement. Vous pouvez uniquement baliser des instances et des volumes au moment du lancement. Les balises spécifiées sont appliquées à toutes les instances ou volumes qui sont créés lors du lancement. Pour ajouter des balises à une instance après qu'elle a été lancée, utilisez l'action aws:createTags - Créer des balises pour des ressources AWS.

Type : MapList (pour plus d'informations, consultez TagSpecification)

Obligatoire : non

UserData

Script fourni en tant que valeur de littéral de chaîne. Si une valeur littérale est entrée, elle doit être codée en base64.

Type : chaîne

Obligatoire : non

Sortie
InstanceIds

ID des instances.

InstanceStates

Statut actuel de l'instance.