aws:changeInstanceState - Modifier ou affirmer le statut de l'instance - 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:changeInstanceState - Modifier ou affirmer le statut de l'instance

Modifie ou affirme l'état de l'instance.

Cette action peut être utilisée en mode déclaration (n'exécute pas l'API pour modifier l'état, mais vérifie que l'instance affiche l'état souhaité.) Pour utiliser le mode assert, définissez le paramètre CheckStateOnly sur true. Ce mode est utile lorsque vous exécutez la commande Sysprep sous Windows, une commande asynchrone qui peut être exécutée en arrière-plan pendant longtemps. Vous pouvez veiller à ce que l'instance soit arrêtée avant de créer une Amazon Machine Image (AMI).

Note

La valeur de délai d'expiration par défaut pour cette action est de 3600 secondes (une heure). Vous pouvez limiter ou étendre le délai d'attente en spécifiant le paramètre timeoutSeconds pour une étape aws:changeInstanceState.

Entrée

YAML
name: stopMyInstance
action: aws:changeInstanceState
maxAttempts: 3
timeoutSeconds: 3600
onFailure: Abort
inputs:
  InstanceIds:
  - i-1234567890abcdef0
  CheckStateOnly: true
  DesiredState: stopped
JSON
{
    "name":"stopMyInstance",
    "action": "aws:changeInstanceState",
    "maxAttempts": 3,
    "timeoutSeconds": 3600,
    "onFailure": "Abort",
    "inputs": {
        "InstanceIds": ["i-1234567890abcdef0"],
        "CheckStateOnly": true,
        "DesiredState": "stopped"
    }
}
InstanceIds

ID des instances.

Type : StringList

Obligatoire : oui

CheckStateOnly

Si la valeur est false, définit l'état de l'instance sur l'état souhaité. Si la valeur est true, déclare l'état souhaité à l'aide de l'interrogation.

Par défaut : false

Type : booléen

Obligatoire : non

DesiredState

État souhaité. Lorsqu'elle est définie sur running, cette action attend que l'état Amazon EC2 indique Running, que le statut d'instance soit OK et que le statut système corresponde à OK avant de se terminer.

Type : chaîne

Valeurs valides : running | stopped | terminated

Obligatoire : oui

Force

Si ce paramètre est défini, il oblige les instances à s'arrêter. Les instances n'ont pas la possibilité de vider les caches du système de fichiers ou les métadonnées du système de fichiers. Si vous utilisez cette option, vous devez effectuer un contrôle du système de fichiers et des procédures de réparation. Cette option n'est pas recommandée pour les instances EC2 pour Windows Server.

Type : booléen

Obligatoire : non

AdditionalInfo

Instances réservées.

Type : chaîne

Obligatoire : non

Sortie

Aucune