aws:changeInstanceState - Modifier ou affirmer le statut de l'instance - AWS Systems Manager

AWS Systems ManagerChange Managern'est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez AWS Systems ManagerChange Managerla section Modification de la disponibilité.

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 Server, 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.

Note

L’action aws:changeInstanceState prend en charge la limitation des nouvelles tentatives. Pour de plus amples informations, veuillez consulter Configuration des nouvelles tentatives automatiques pour les opérations limitées.

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

Les IDs 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 surrunning, cette action attend que l' EC2 état AmazonRunning, l'état de l'instance et le statut du système soient définis OK avant de terminer. OK

Type : String

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 EC2 instances deWindows Server.

Type : booléen

Obligatoire : non

AdditionalInfo

Instances réservées.

Type : chaîne

Obligatoire : non

Sortie

Aucune