EventBridge Amazon-Veranstaltungsbeispiele für Systems Manager - AWS Systems Manager

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

EventBridge Amazon-Veranstaltungsbeispiele für Systems Manager

Im Folgenden finden Sie Beispiele im JSON-Format für unterstützte EventBridge Ereignisse für AWS Systems Manager.

AWS Systems Manager Automatisierungsereignisse

Benachrichtigung über die Änderung des Automatisierungsschrittstatus

{ "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" } }

Benachrichtigung über die Änderung des Ausführungsstatus

{ "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-Change Calendar-Ereignisse

Verwenden Sie die Informationen in diesem Thema, um das Verhalten von EventBridge Ereignissen für zu planen und zu verstehen AWS Systems ManagerChange Calendar.

Anmerkung

Statusänderungen für Kalender, die von anderen gemeinsam genutzt wurden, AWS-Konten werden derzeit nicht unterstützt.

Change CalendarIntegration mit Amazon EventBridge

AWS Systems Manager Change Calendarintegriert sich in Amazon EventBridge , um Sie über Änderungen des Kalenderstatus zu informieren. Beachten Sie die folgenden Verhaltensweisen im Zusammenhang mit der zugrunde liegenden Scheduling-Architektur:

Zeitpunkt und Zuverlässigkeit von Ereignissen
  • EventBridge übermittelt Benachrichtigungen nach bestem Wissen und mit einer Zeitplanungstoleranz von bis zu 15 Minuten.

  • Ereignisse bei Statusänderungen spiegeln allgemeine Statusübergänge im Kalender wider, nicht einzelne Kalenderereignisse.

  • Wenn mehrere Kalenderereignisse gleichzeitig auftreten, EventBridge wird für jede tatsächliche Änderung des Kalenderstatus nur ein Ereignis generiert.

  • EventBridge löst Ereignisse nur aus, wenn der Gesamtstatus des Kalenders wechselt (z. B. von GESCHLOSSEN zu OFFEN), nicht für einzelne Kalenderereignisse, die nicht zu einer Statusänderung führen.

  • Hinweisereignisse, die den Kalenderstatus nicht ändern, lösen keine EventBridge Benachrichtigungen aus.

Eventänderungen und Überlegungen zum Zeitplan
  • Wenn Sie Kalenderereignisse innerhalb von 15 Minuten nach ihrer geplanten Start- oder Endzeit ändern, werden EventBridge möglicherweise doppelte Benachrichtigungen generiert oder Benachrichtigungen verpasst.

  • Dieses Verhalten tritt auf, weil das Planungssystem möglicherweise nicht genügend Zeit hat, um zuvor geplante Benachrichtigungen ordnungsgemäß zu aktualisieren oder zu stornieren.

  • Bei wiederkehrenden Ereignissen wirkt sich dieses Verhalten in der Regel nur auf das erste Ereignis nach der Änderung aus.

Benachbarte und sich überschneidende Ereignisse
  • Wenn Kalenderereignisse innerhalb von 5 Minuten geplant sind, kann es je nach der tatsächlichen Statusänderung zu Zustandsübergängen kommen oder auch nicht.

  • Durch das Erstellen von überlappenden Ereignissen in einer bestimmten Reihenfolge können zusätzliche EventBridge Ereignisse generiert werden, auch wenn keine tatsächliche Statusänderung stattfindet.

  • Um ein vorhersehbares Verhalten zu gewährleisten, sollten Sie es vermeiden, Kalenderereignisse kurz vor ihrer Ausführungszeit zu erstellen oder zu ändern.

Bewährte Methoden
  • Entwerfen Sie Ihre EventBridge Regeln und die nachgelagerte Automatisierung so, dass potenzielle doppelte Ereignisse behandelt werden.

  • Implementieren Sie Idempotenz in Ihre Automatisierungsworkflows, um Probleme durch doppelte Benachrichtigungen zu vermeiden.

  • Planen Sie ausreichend Vorlaufzeit (mindestens 15 Minuten) ein, wenn Sie Kalenderereignisse erstellen oder ändern.

  • Testen Sie Ihre EventBridge Integrationen gründlich anhand Ihrer spezifischen Kalenderereignismuster.

Kalender OFFEN

{ "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" } }

Kalender GESCHLOSSEN

{ "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-Change Manager-Ereignisse

Benachrichtigung über Statusaktualisierung der Änderungsanfrage – Beispiel 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" ] } }

Benachrichtigung über Statusaktualisierung der Änderungsanfrage – Beispiel 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" ] } }

AWS Systems Manager Veranstaltungen zur Einhaltung von Vorschriften

Im Folgenden finden Sie Beispiele für Veranstaltungen zum Thema AWS Systems Manager Compliance.

Zuordnung regelkonform

{ "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" } }

Zuordnung nicht regelkonform

{ "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" } }

Patch regelkonform

{ "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" } }

Patch nicht regelkonform

{ "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-Maintenance Windows-Ereignisse

Es folgen Beispiele der Ereignisse für Systems Manager Maintenance Windows.

Registrieren eines Ziels

Zu den gültigen Statuswerten gehören REGISTERED undDEREGISTERED.

{ "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" } }

Fensterausführungstyp

Zu den gültigen Statuswerten gehören PENDINGIN_PROGRESS,SUCCESS,FAILED,TIMED_OUT, undSKIPPED_OVERLAPPING.

{ "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" } }

Typ der Aufgabenausführung

Zu den gültigen Statuswerten gehören IN_PROGRESSSUCCESS,FAILED, undTIMED_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" } }

Aufgabenziel verarbeitet

Zu den gültigen Statuswerten gehören IN_PROGRESSSUCCESS,FAILED, undTIMED_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" } }

Fensterstatusänderung

Zu den gültigen Statuswerten gehören ENABLED undDISABLED.

{ "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-Parameter Store-Ereignisse

Es folgen Beispiele der Ereignisse für Systems Manager Parameter Store.

Create Parameter (Parameter erstellen)

{ "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" } }

Update Parameter (Parameter aktualisieren)

{ "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" } }

DeleteParameter (Parameter löschen)

{ "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-OpsCenter-Ereignisse

OpsCenter OpsItem Benachrichtigung erstellen

{ "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" } }

OpsCenter OpsItem Benachrichtigung aktualisieren

{ "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-Run Command-Ereignisse

Run Command-Statusänderungsbenachrichtigung

{ "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" } }

Run CommandInvocation Status-Änderungsbenachrichtigung

{ "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-State Manager-Ereignisse

State Manager-Association-Statusänderung

{ "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" } }

State Manager-Instance-Association-Statusänderung

{ "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" } }