Exemples d'événements Amazon EventBridge pour Systems Manager - AWS Systems Manager

Exemples d'événements Amazon EventBridge pour Systems Manager

Voici des exemples, au format JSON, d'événements EventBridge pris en charge pour AWS Systems Manager.

Événements Automation AWS Systems Manager

Notification de changement de statut d'une étape d'automatisation

{ "version": "0", "id": "eeca120b-a321-433e-9635-dab369006a6b", "detail-type": "EC2 Automation Step Status-change Notification", "source": "aws.ssm", "account": "123456789012", "time": "2024-11-29T19:43:35Z", "region": "us-east-1", "resources": ["arn:aws:ssm:us-east-2:123456789012:automation-execution/333ba70b-2333-48db-b17e-a5e69c6f4d1c", "arn:aws:ssm:us-east-2:123456789012:automation-definition/runcommand1:1"], "detail": { "ExecutionId": "333ba70b-2333-48db-b17e-a5e69c6f4d1c", "Definition": "runcommand1", "DefinitionVersion": 1.0, "Status": "Success", "EndTime": "Nov 29, 2024 7:43:25 PM", "StartTime": "Nov 29, 2024 7:43:23 PM", "Time": 2630.0, "StepName": "runFixedCmds", "Action": "aws:runCommand" } }

Notification de changement de statut d'exécution de l'automatisation

{ "version": "0", "id": "d290ece9-1088-4383-9df6-cd5b4ac42b99", "detail-type": "EC2 Automation Execution Status-change Notification", "source": "aws.ssm", "account": "123456789012", "time": "2024-11-29T19:43:35Z", "region": "us-east-2", "resources": ["arn:aws:ssm:us-east-2:123456789012:automation-execution/333ba70b-2333-48db-b17e-a5e69c6f4d1c", "arn:aws:ssm:us-east-2:123456789012:automation-definition/runcommand1:1"], "detail": { "ExecutionId": "333ba70b-2333-48db-b17e-a5e69c6f4d1c", "Definition": "runcommand1", "DefinitionVersion": 1.0, "Status": "Success", "StartTime": "Nov 29, 2024 7:43:20 PM", "EndTime": "Nov 29, 2024 7:43:26 PM", "Time": 5753.0, "ExecutedBy": "arn:aws:iam::123456789012:user/userName" } }

AWS Systems ManagerÉvénementsChange Calendar

Utilisez les informations de cette rubrique pour planifier et comprendre le comportement des événements EventBridge pour AWS Systems Manager Change Calendar.

Note

Les modifications d'état pour les planifications partagées à partir d'autres Comptes AWS ne sont pas prises en charge actuellement.

Intégration de Change Calendar à Amazon EventBridge

AWS Systems Manager Change Calendar s’intègre à Amazon EventBridge pour vous avertir de certains changements d’état de votre calendrier. Tenez compte des comportements suivants liés à l’architecture de planification sous-jacente :

Planification et fiabilité des événements
  • EventBridge envoie des notifications sur la base du meilleur effort, avec une tolérance de planification maximale de 15 minutes.

  • Les événements de changement d’état reflètent les transitions d’état globales du calendrier, et non les événements individuels du calendrier.

  • Lorsque plusieurs événements de calendrier se produisent simultanément, EventBridge ne génère qu’un seul événement par changement d’état réel du calendrier.

  • EventBridge déclenche des événements uniquement lorsque l’état général du calendrier change (par exemple, de FERMÉ à OUVERT), et non pour des événements individuels du calendrier qui n’entraînent pas de changement d’état.

  • Les événements consultatifs qui ne modifient pas l’état du calendrier ne déclenchent pas de notifications EventBridge.

Modifications des événements et considérations de planification
  • Si vous modifiez des événements du calendrier dans les 15 minutes suivant leur heure de début ou de fin prévue, EventBridge peut générer des notifications dupliquées ou manquer des notifications.

  • Ce comportement est dû au fait que le système de planification ne dispose peut-être pas de suffisamment de temps pour mettre à jour ou annuler correctement les notifications précédemment planifiées.

  • Pour les événements récurrents, ce comportement n’affecte généralement que la première occurrence après la modification.

Événements adjacents et superposés
  • Lorsque des événements du calendrier sont planifiés à moins de 5 minutes d’intervalle, des événements de transition d’état peuvent se produire ou non, en fonction du changement d’état réel.

  • La création d’événements superposés dans certains ordres peut générer des événements EventBridge supplémentaires, même en l’absence d’un véritable changement d’état.

  • Pour garantir un comportement prévisible, évitez de créer ou modifier des événements de calendrier à proximité de leur date d’exécution.

Bonnes pratiques
  • Concevez vos règles EventBridge et votre automatisation en aval pour gérer les éventuels événements dupliqués.

  • Implémentez l’idempotence dans vos flux de travail automatisés afin d’éviter les problèmes de notifications dupliquées.

  • Prévoyez un délai suffisant (au moins 15 minutes) lorsque vous créez ou modifiez des événements du calendrier.

  • Testez soigneusement vos intégrations EventBridge avec les modèles d’événements spécifiques de votre calendrier.

Calendrier OPEN (OUVERT)

{ "version": "0", "id": "47a3f03a-f30d-1011-ac9a-du3bdEXAMPLE", "detail-type": "Calendar State Change", "source": "aws.ssm", "account": "123456789012", "time": "2024-09-19T18:00:07Z", "region": "us-east-2", "resources": [ "arn:aws:ssm:us-east-2:123456789012:document/MyCalendar" ], "detail": { "state": "OPEN", "atTime": "2024-09-19T18:00:07Z", "nextTransitionTime": "2024-10-11T18:00:07Z" } }

Calendrier CLOSED (FERMÉ)

{ "version": "0", "id": "f30df03a-1011-ac9a-47a3-f761eEXAMPLE", "detail-type": "Calendar State Change", "source": "aws.ssm", "account": "123456789012", "time": "2024-09-17T21:40:02Z", "region": "us-east-2", "resources": [ "arn:aws:ssm:us-east-2:123456789012:document/MyCalendar" ], "detail": { "state": "CLOSED", "atTime": "2024-08-17T21:40:00Z", "nextTransitionTime": "2024-09-19T18:00:07Z" } }

AWS Systems ManagerÉvénementsChange Manager

Notification de mise à jour du statut d’une demande de modification : exemple 1

{ "version": "0", "id": "feab80c1-a8ff-c721-b8b1-96ce70939696", "detail-type": "Change Request Status Update", "source": "aws.ssm", "account": "123456789012", "time": "2024-10-24T10:51:52Z", "region": "us-east-1", "resources": [ "arn:aws:ssm:us-west-2:123456789012:opsitem/oi-12345abcdef", "arn:aws:ssm:us-west-2:123456789012:document/MyRunbook1" ], "detail": { "change-request-id": "d0585556-80f6-4522-8dad-dada6d45b67d", "change-request-title": "A change request title", "ops-item-id": "oi-12345abcdef", "ops-item-created-by": "arn:aws:iam::123456789012:user/JohnDoe", "ops-item-created-time": "2024-10-24T10:50:33.180334Z", "ops-item-modified-by": "arn:aws:iam::123456789012:user/JohnDoe", "ops-item-modified-time": "2024-10-24T10:50:33.180340Z", "ops-item-status": "InProgress", "change-template-document-name": "MyChangeTemplate", "runbook-document-arn": "arn:aws:ssm:us-west-2:123456789012:document/MyRunbook1", "runbook-document-version": "1", "auto-approve": true, "approvers": [ "arn:aws:iam::123456789012:user/JaneDoe" ] } }

Notification de mise à jour du statut d’une demande de modification : exemple 2

{ "version": "0", "id": "25ce6b03-2e4e-1a2b-2a8f-6c9de8d278d2", "detail-type": "Change Request Status Update", "source": "aws.ssm", "account": "123456789012", "time": "2024-10-24T10:51:52Z", "region": "us-east-1", "resources": [ "arn:aws:ssm:us-west-2:123456789012:opsitem/oi-abcdef12345", "arn:aws:ssm:us-west-2:123456789012:document/MyRunbook1" ], "detail": { "change-request-id": "d0585556-80f6-4522-8dad-dada6d45b67d", "change-request-title": "A change request title", "ops-item-id": "oi-abcdef12345", "ops-item-created-by": "arn:aws:iam::123456789012:user/JohnDoe", "ops-item-created-time": "2024-10-24T10:50:33.180334Z", "ops-item-modified-by": "arn:aws:iam::123456789012:user/JohnDoe", "ops-item-modified-time": "2024-10-24T10:50:33.997163Z", "ops-item-status": "Rejected", "change-template-document-name": "MyChangeTemplate", "runbook-document-arn": "arn:aws:ssm:us-west-2:123456789012:document/MyRunbook1", "runbook-document-version": "1", "auto-approve": true, "approvers": [ "arn:aws:iam::123456789012:user/JaneDoe" ] } }

Événements de conformité AWS Systems Manager

Voici des exemples d'événements pour la conformité de AWS Systems Manager.

Conforme à l'association

{ "version": "0", "id": "01234567-0123-0123-0123-012345678901", "detail-type": "Configuration Compliance State Change", "source": "aws.ssm", "account": "123456789012", "time": "2024-07-17T19:03:26Z", "region": "us-east-2", "resources": [ "arn:aws:ssm:us-east-2:123456789012:managed-instance/i-01234567890abcdef" ], "detail": { "last-runtime": "2024-01-01T10:10:10Z", "compliance-status": "compliant", "resource-type": "managed-instance", "resource-id": "i-01234567890abcdef", "compliance-type": "Association" } }

Non conforme à l'association

{ "version": "0", "id": "01234567-0123-0123-0123-012345678901", "detail-type": "Configuration Compliance State Change", "source": "aws.ssm", "account": "123456789012", "time": "2024-07-17T19:02:31Z", "region": "us-east-2", "resources": [ "arn:aws:ssm:us-east-2:123456789012:managed-instance/i-01234567890abcdef" ], "detail": { "last-runtime": "2024-01-01T10:10:10Z", "compliance-status": "non_compliant", "resource-type": "managed-instance", "resource-id": "i-01234567890abcdef", "compliance-type": "Association" } }

Conforme aux correctifs

{ "version": "0", "id": "01234567-0123-0123-0123-012345678901", "detail-type": "Configuration Compliance State Change", "source": "aws.123456789012", "account": "123456789012", "time": "2024-07-17T19:03:26Z", "region": "us-east-2", "resources": [ "arn:aws:ssm:us-east-2:123456789012:managed-instance/i-01234567890abcdef" ], "detail": { "resource-type": "managed-instance", "resource-id": "i-01234567890abcdef", "compliance-status": "compliant", "compliance-type": "Patch", "patch-baseline-id": "PB789", "severity": "critical" } }

Non conforme aux correctifs

{ "version": "0", "id": "01234567-0123-0123-0123-012345678901", "detail-type": "Configuration Compliance State Change", "source": "aws.ssm", "account": "123456789012", "time": "2024-07-17T19:02:31Z", "region": "us-east-2", "resources": [ "arn:aws:ssm:us-east-2:123456789012:managed-instance/i-01234567890abcdef" ], "detail": { "resource-type": "managed-instance", "resource-id": "i-01234567890abcdef", "compliance-status": "non_compliant", "compliance-type": "Patch", "patch-baseline-id": "PB789", "severity": "critical" } }

AWS Systems ManagerÉvénementsMaintenance Windows

Vous trouverez ci-dessous des exemples d'événements pour Systems Manager Maintenance Windows.

Enregistrer une cible

Les valeurs valides comprennent REGISTERED et DEREGISTERED.

{ "version":"0", "id":"01234567-0123-0123-0123-0123456789ab", "detail-type":"Maintenance Window Target Registration Notification", "source":"aws.ssm", "account":"123456789012", "time":"2024-11-16T00:58:37Z", "region":"us-east-2", "resources":[ "arn:aws:ssm:us-east-2:123456789012:maintenancewindow/mw-0ed7251d3fcf6e0c2", "arn:aws:ssm:us-east-2:123456789012:windowtarget/e7265f13-3cc5-4f2f-97a9-7d3ca86c32a6" ], "detail":{ "window-target-id":"e7265f13-3cc5-4f2f-97a9-7d3ca86c32a6", "window-id":"mw-0ed7251d3fcf6e0c2", "status":"REGISTERED" } }

Type d'exécution de fenêtre

Les valeurs de statut valides sont notamment les suivantes :

  • CANCELLED

  • CANCELLING

  • FAILED

  • IN_PROGRESS

  • PENDING

  • SKIPPED_OVERLAPPING

  • SUCCESS TIMED_OUT

{ "version":"0", "id":"01234567-0123-0123-0123-0123456789ab", "detail-type":"Maintenance Window Execution State-change Notification", "source":"aws.ssm", "account":"123456789012", "time":"2025-06-02T14:52:18Z", "region":"us-east-2", "resources":[ "arn:aws:ssm:us-east-2:123456789012:maintenancewindow/mw-0c50858d01EXAMPLE" ], "detail":{ "start-time":"2025-06-02T14:48:28.039273Z", "end-time":"2025-06-02T14:52:18.083773Z", "window-id":"mw-0ed7251d3fcf6e0c2", "window-execution-id":"14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE", "status":"SUCCESS" } }

Type d'exécution de tâche

Les valeurs valides comprennent IN_PROGRESS, SUCCESS, FAILED et TIMED_OUT.

{ "version":"0", "id":"01234567-0123-0123-0123-0123456789ab", "detail-type":"Maintenance Window Task Execution State-change Notification", "source":"aws.ssm", "account":"123456789012", "time":"2025-06-02T14:52:18Z", "region":"us-east-2", "resources":[ "arn:aws:ssm:us-east-2:123456789012:maintenancewindow/mw-0c50858d01EXAMPLE" ], "detail":{ "start-time":"2025-06-02T14:48:28.039273Z", "task-execution-id":"6417e808-7f35-4d1a-843f-123456789012", "end-time":"2025-06-02T14:52:18.083773Z", "window-id":"mw-0ed7251d3fcf6e0c2", "window-execution-id":"14bea65d-5ccc-462d-a2f3-e99c8EXAMPLE", "status":"SUCCESS" } }

Cible de tâche traitée

Les valeurs valides comprennent IN_PROGRESS, SUCCESS, FAILED et TIMED_OUT.

{ "version":"0", "id":"01234567-0123-0123-0123-0123456789ab", "detail-type":"Maintenance Window Task Target Invocation State-change Notification", "source":"aws.ssm", "account":"123456789012", "time":"2025-06-02T14:52:18Z", "region":"us-east-2", "resources":[ "arn:aws:ssm:us-east-2:123456789012:maintenancewindow/mw-123456789012345678" ], "detail":{ "start-time":"2025-06-02T14:48:28.039273Z", "end-time":"2025-06-02T14:52:18.083773Z", "window-id":"mw-0ed7251d3fcf6e0c2", "window-execution-id":"791b72e0-f0da-4021-8b35-f95dfEXAMPLE", "task-execution-id":"c9b05aba-197f-4d8d-be34-e73fbEXAMPLE", "window-target-id":"e32eecb2-646c-4f4b-8ed1-205fbEXAMPLE", "status":"SUCCESS", "owner-information":"Owner" } }

Changement d'état de la fenêtre

Les valeurs valides comprennent ENABLED et DISABLED.

{ "version":"0", "id":"01234567-0123-0123-0123-0123456789ab", "detail-type":"Maintenance Window State-change Notification", "source":"aws.ssm", "account":"123456789012", "time":"2024-11-16T00:58:37Z", "region":"us-east-2", "resources":[ "arn:aws:ssm:us-east-2:123456789012:maintenancewindow/mw-0c50858d01EXAMPLE" ], "detail":{ "window-id":"mw-0c50858d01EXAMPLE", "status":"DISABLED" } }

AWS Systems ManagerÉvénementsParameter Store

Vous trouverez ci-dessous des exemples d'événements pour Systems Manager Parameter Store.

Création de paramètre

{ "version": "0", "id": "6a7e4feb-b491-4cf7-a9f1-bf3703497718", "detail-type": "Parameter Store Change", "source": "aws.ssm", "account": "123456789012", "time": "2024-05-22T16:43:48Z", "region": "us-east-2", "resources": [ "arn:aws:ssm:us-east-2:123456789012:parameter/MyExampleParameter" ], "detail": { "operation": "Create", "name": "MyExampleParameter", "type": "String", "description": "Sample Parameter" } }

Mise à jour de paramètre

{ "version": "0", "id": "9547ef2d-3b7e-4057-b6cb-5fdf09ee7c8f", "detail-type": "Parameter Store Change", "source": "aws.ssm", "account": "123456789012", "time": "2024-05-22T16:44:48Z", "region": "us-east-2", "resources": [ "arn:aws:ssm:us-east-2:123456789012:parameter/MyExampleParameter" ], "detail": { "operation": "Update", "name": "MyExampleParameter", "type": "String", "description": "Sample Parameter" } }

Suppression de paramètre

{ "version": "0", "id": "80e9b391-6a9b-413c-839a-453b528053af", "detail-type": "Parameter Store Change", "source": "aws.ssm", "account": "123456789012", "time": "2024-05-22T16:45:48Z", "region": "us-east-2", "resources": [ "arn:aws:ssm:us-east-2:123456789012:parameter/MyExampleParameter" ], "detail": { "operation": "Delete", "name": "MyExampleParameter", "type": "String", "description": "Sample Parameter" } }

AWS Systems ManagerÉvénementsOpsCenter

Créer des notifications OpsCenter OpsItem

{ "version": "0", "id": "aae66adc-7aac-f0c0-7854-7691e8c079b8", "detail-type": "OpsItem Create", "source": "aws.ssm", "account": "123456789012", "time": "2024-10-19T02:48:11Z", "region": "us-east-1", "resources": [ "arn:aws:ssm:us-west-2:123456789012:opsitem/oi-123456abcdef" ], "detail": { "created-by": "arn:aws:iam::123456789012:user/JohnDoe", "created-time": "2024-10-19T02:46:53.629361Z", "source": "aws.ssm", "status": "Open", "ops-item-id": "oi-123456abcdef", "title": "An issue title", "ops-item-type": "/aws/issue", "description": "A long description may appear here" } }

Mettre à jour une notification OpsCenter OpsItem

{ "version": "0", "id": "2fb5b168-b725-41dd-a890-29311200089c", "detail-type": "OpsItem Update", "source": "aws.ssm", "account": "123456789012", "time": "2024-10-19T02:48:11Z", "region": "us-east-1", "resources": [ "arn:aws:ssm:us-west-2:123456789012:opsitem/oi-123456abcdef" ], "detail": { "created-by": "arn:aws:iam::123456789012:user/JohnDoe", "created-time": "2024-10-19T02:46:54.049271Z", "modified-by": "arn:aws:iam::123456789012:user/JohnDoe", "modified-time": "2024-10-19T02:46:54.337354Z", "source": "aws.ssm", "status": "Open", "ops-item-id": "oi-123456abcdef", "title": "An issue title", "ops-item-type": "/aws/issue", "description": "A long description may appear here" } }

AWS Systems ManagerÉvénementsRun Command

Notification de changement de statut Run Command

{ "version": "0", "id": "51c0891d-0e34-45b1-83d6-95db273d1602", "detail-type": "EC2 Command Status-change Notification", "source": "aws.ssm", "account": "123456789012", "time": "2024-07-10T21:51:32Z", "region": "us-east-2", "resources": ["arn:aws:ec2:us-east-2:123456789012:instance/i-02573cafcfEXAMPLE"], "detail": { "command-id": "e8d3c0e4-71f7-4491-898f-c9b35bee5f3b", "document-name": "AWS-RunPowerShellScript", "expire-after": "2024-07-14T22:01:30.049Z", "parameters": { "executionTimeout": ["3600"], "commands": ["date"] }, "requested-date-time": "2024-07-10T21:51:30.049Z", "status": "Success" } }

Notification de changement de statut d’une invocation Run Command

{ "version": "0", "id": "4780e1b8-f56b-4de5-95f2-95dbEXAMPLE", "detail-type": "EC2 Command Invocation Status-change Notification", "source": "aws.ssm", "account": "123456789012", "time": "2024-07-10T21:51:32Z", "region": "us-east-2", "resources": ["arn:aws:ec2:us-east-2:123456789012:instance/i-02573cafcfEXAMPLE"], "detail": { "command-id": "e8d3c0e4-71f7-4491-898f-c9b35bee5f3b", "document-name": "AWS-RunPowerShellScript", "instance-id": "i-02573cafcfEXAMPLE", "requested-date-time": "2024-07-10T21:51:30.049Z", "status": "Success" } }

AWS Systems ManagerÉvénementsState Manager

Changement d'état d'association State Manager

{ "version":"0", "id":"db839caf-6f6c-40af-9a48-25b2ae2b7774", "detail-type":"EC2 State Manager Association State Change", "source":"aws.ssm", "account":"123456789012", "time":"2024-05-16T23:01:10Z", "region":"us-east-2", "resources":[ "arn:aws:ssm:us-east-2::document/AWS-RunPowerShellScript" ], "detail":{ "association-id":"6e37940a-23ba-4ab0-9b96-5d0a1a05464f", "document-name":"AWS-RunPowerShellScript", "association-version":"1", "document-version":"Optional.empty", "targets":"[{\"key\":\"InstanceIds\",\"values\":[\"i-12345678\"]}]", "creation-date":"2024-02-13T17:22:54.458Z", "last-successful-execution-date":"2024-05-16T23:00:01Z", "last-execution-date":"2024-05-16T23:00:01Z", "last-updated-date":"2024-02-13T17:22:54.458Z", "status":"Success", "association-status-aggregated-count":"{\"Success\":1}", "schedule-expression":"cron(0 */30 * * * ? *)", "association-cwe-version":"1.0" } }

Changements d'état d'association d'instance State Manager

{ "version":"0", "id":"6a7e8feb-b491-4cf7-a9f1-bf3703467718", "detail-type":"EC2 State Manager Instance Association State Change", "source":"aws.ssm", "account":"123456789012", "time":"2024-02-23T15:23:48Z", "region":"us-east-2", "resources":[ "arn:aws:ec2:us-east-2:123456789012:instance/i-12345678", "arn:aws:ssm:us-east-2:123456789012:document/my-custom-document" ], "detail":{ "association-id":"34fcb7e0-9a14-4984-9989-0e04e3f60bd8", "instance-id":"i-02573cafcfEXAMPLE", "document-name":"my-custom-document", "document-version":"1", "targets":"[{\"key\":\"instanceids\",\"values\":[\"i-02573cafcfEXAMPLE\"]}]", "creation-date":"2024-02-23T15:23:48Z", "last-successful-execution-date":"2024-02-23T16:23:48Z", "last-execution-date":"2024-02-23T16:23:48Z", "status":"Success", "detailed-status":"", "error-code":"testErrorCode", "execution-summary":"testExecutionSummary", "output-url":"sampleurl", "instance-association-cwe-version":"1" } }