Utilisation d'une fenêtre de maintenance pour envoyer une commande qui renvoie des notifications de statut

Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/.

Dans le panneau de navigation, sélectionnez Maintenance Windows.

Sélectionnez la fenêtre de maintenance pour laquelle vous souhaitez enregistrer une tâche Run Command configurée pour envoyer des notifications Amazon Simple Notification Service (Amazon SNS).

Sélectionnez Actions, puis Register Run command task (Enregistrer une tâche Run Command).

(Facultatif) Dans le champ Name (Nom), saisissez un nom pour la tâche.

(Facultatif) Dans le champ Description, saisissez une description.

Dans la liste Command Document (Document de commande), sélectionnez un document de commande.

Pour Priorité de tâche, spécifiez la priorité de cette tâche. Zéro (0) est la priorité la plus élevée. Les tâches d'une fenêtre de maintenance sont planifiées par ordre de priorité. Les tâches qui ont la même priorité sont planifiées en parallèle.

Dans la section Cibles, sélectionnez un groupe cible enregistré ou sélectionnez des cibles non enregistrées.

Pour Rate control (Contrôle de débit) :

Dans la zone IAM service role (Rôle de service IAM), sélectionnez le rôle de service Maintenance Windows qui dispose des autorisations iam:PassRole sur le rôle SNS.

(Facultatif) Dans Output options (Options de sortie), pour enregistrer la sortie de la commande dans un fichier, sélectionnez Enable writing to an S3 bucket (Autoriser l'écriture dans un compartiment S3) Saisissez les noms de compartiment et de préfixe (dossier) dans les zones.

Dans la section Notifications SNS, procédez comme suit :

Dans la section Parameters (Paramètres), entrez les paramètres requis en fonction du document de commande que vous avez choisi.

Sélectionnez Register run command task (Enregistrer une tâche d'exécution de commande).

Après l'exécution suivante de votre fenêtre de maintenance, vérifiez vos e-mails pour savoir si vous avez reçu un message d'Amazon SNS, et ouvrez le message. Amazon SNS peut prendre quelques minutes pour envoyer le message.

Sur votre ordinateur local, créez un fichier nommé RunCommandTask.json.

Collez le contenu suivant dans le fichier .

{
    "Name": "Name",
    "Description": "Description",
    "WindowId": "mw-0c50858d01EXAMPLE",
    "ServiceRoleArn": "arn:aws:iam::account-id:role/MaintenanceWindowIAMRole",
    "MaxConcurrency": "1",
    "MaxErrors": "1",
    "Priority": 3,
    "Targets": [
        {
            "Key": "WindowTargetIds",
            "Values": [
                "e32eecb2-646c-4f4b-8ed1-205fbEXAMPLE"
            ]
        }
    ],
    "TaskType": "RUN_COMMAND",
    "TaskArn": "CommandDocumentName",
    "TaskInvocationParameters": {
        "RunCommand": {
            "Comment": "Comment",
            "TimeoutSeconds": 3600,
            "NotificationConfig": {
                "NotificationArn": "arn:aws:sns:region:account-id:SNSTopicName",
                "NotificationEvents": [
                    "All"
                ],
                "NotificationType": "Command"
            },
            "ServiceRoleArn": "arn:aws:iam::account-id:role/SNSIAMRole"
        }
    }
}

Remplacez les exemples de valeurs par les informations sur vos propres ressources.

Vous pouvez également restaurer les options que nous n'avons pas spécifiées dans cet exemple si vous souhaitez les utiliser. Par exemple, vous pouvez enregistrer la sortie de la commande dans un compartiment S3.

Pour plus d’informations, consultez register-task-with-maintenance-window dans la Référence des commandes de l’AWS CLI .

Enregistrez le fichier.

Dans le répertoire de votre ordinateur local où vous avez enregistré le fichier, exécutez la commande suivante.

aws ssm register-task-with-maintenance-window --cli-input-json file://RunCommandTask.json

Si elle aboutit, la commande renvoie des informations similaires à ce qui suit.

{
    "WindowTaskId": "j2l8d5b5c-mw66-tk4d-r3g9-1d4d1EXAMPLE"
}
                    

Après l'exécution suivante de votre fenêtre de maintenance, vérifiez vos e-mails pour savoir si vous avez reçu un message d'Amazon SNS, et ouvrez le message. Amazon SNS peut prendre quelques minutes pour envoyer le message.