Beispiele für Incident Manager mit AWS CLI - AWS Command Line Interface
Aktionen

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.

Beispiele für Incident Manager mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Incident Manager Aktionen ausführen und allgemeine Szenarien implementieren können.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Aktionen zeigen Ihnen zwar, wie Sie einzelne Servicefunktionen aufrufen, aber Sie können Aktionen im Kontext der zugehörigen Szenarien sehen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, in dem Sie Anweisungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt die Verwendungcreate-replication-set.

AWS CLI

Um den Replikationssatz zu erstellen

Im folgenden create-replication-set Beispiel wird der Replikationssatz erstellt, den Incident Manager verwendet, um Daten in Ihrem Amazon Web Services Services-Konto zu replizieren und zu verschlüsseln. In diesem Beispiel werden bei der Erstellung des Replikationssatzes die Regionen us-east-1 und us-east-2 verwendet.

aws ssm-incidents create-replication-set \
    --regions '{"us-east-1": {"sseKmsKeyId": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"}, "us-east-2": {"sseKmsKeyId": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"}}'

Ausgabe:

{
    "replicationSetArns": [
        "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57"
    ]
}

Weitere Informationen finden Sie unter Verwenden des Incident Manager-Replikationssatzes im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungcreate-response-plan.

AWS CLI

Um einen Reaktionsplan zu erstellen

Im folgenden create-response-plan Beispiel wird ein Reaktionsplan mit den angegebenen Details erstellt.

aws ssm-incidents create-response-plan \
    --chat-channel '{"chatbotSns": ["arn:aws:sns:us-east-1:111122223333:Standard_User"]}' \
    --display-name "Example response plan" \
    --incident-template '{"impact": 5, "title": "example-incident"}' \
    --name "example-response" \
    --actions '[{"ssmAutomation": {"documentName": "AWSIncidents-CriticalIncidentRunbookTemplate", "documentVersion": "$DEFAULT", "roleArn": "arn:aws:iam::111122223333:role/aws-service-role/ssm-incidents.amazonaws.com/AWSServiceRoleForIncidentManager", "targetAccount": "RESPONSE_PLAN_OWNER_ACCOUNT"}}]' \
    --engagements '["arn:aws:ssm-contacts:us-east-1:111122223333:contact/example"]'

Ausgabe:

{
    "arn": "arn:aws:ssm-incidents::111122223333:response-plan/example-response"
}

Weitere Informationen finden Sie unter Vorbereitung auf Vorfälle im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungcreate-timeline-event.

AWS CLI

Beispiel 1: Um ein benutzerdefiniertes Timeline-Ereignis zu erstellen

Im folgenden create-timeline-event Beispiel wird ein benutzerdefiniertes Zeitplanereignis zur angegebenen Zeit des angegebenen Vorfalls erstellt.

aws ssm-incidents create-timeline-event \
    --event-data "\"example timeline event\"" \
    --event-time 2022-10-01T20:30:00.000 \
    --event-type "Custom Event" \
    --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4EXAMPLE"

Ausgabe:

{
    "eventId": "c0bcc885-a41d-eb01-b4ab-9d2deEXAMPLE",
    "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4EXAMPLE"
}

Beispiel 2: So erstellen Sie ein Timeline-Ereignis mit einer Vorfallnotiz

Im folgenden create-timeline-event Beispiel wird ein Zeitleistenereignis erstellt, das im Bereich „Vorfallnotizen“ aufgeführt ist.

aws ssm-incidents create-timeline-event \
     --event-data "\"New Note\"" \
     --event-type "Note" \
     --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Test/6cc46130-ca6c-3b38-68f1-f6abeEXAMPLE" \
     --event-time 2023-06-20T12:06:00.000 \
     --event-references '[{"resource":"arn:aws:ssm-incidents::111122223333:incident-record/Test/6cc46130-ca6c-3b38-68f1-f6abeEXAMPLE"}]'

Ausgabe:

{
    "eventId": "a41dc885-c0bc-b4ab-eb01-de9d2EXAMPLE",
    "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4EXAMPLE"
}

Weitere Informationen finden Sie unter Incident Details im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-incident-record.

AWS CLI

Um einen Vorfalldatensatz zu löschen

Im folgenden delete-incident-record Beispiel wird der angegebene Vorfalldatensatz gelöscht.

aws ssm-incidents delete-incident-record \
    --arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Incident Tracking im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-replication-set.

AWS CLI

Um den Replikationssatz zu löschen

Im folgenden delete-replication-set Beispiel wird der Replikationssatz aus Ihrem Amazon Web Services Services-Konto gelöscht. Durch das Löschen des Replikationssatzes werden auch alle Incident Manager-Daten gelöscht. Dies kann nicht rückgängig gemacht werden.

aws ssm-incidents delete-replication-set \
    --arn "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwenden des Incident Manager-Replikationssatzes im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-resource-policy.

AWS CLI

Um eine Ressourcenrichtlinie zu löschen

Im folgenden delete-resource-policy Beispiel wird eine Ressourcenrichtlinie aus einem Reaktionsplan gelöscht. Dadurch wird dem Schulleiter oder der Organisation, mit der der Reaktionsplan geteilt wurde, der Zugriff entzogen.

aws ssm-incidents delete-resource-policy \
    --policy-id "be8b57191f0371f1c6827341aa3f0a03" \
    --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Arbeiten mit gemeinsam genutzten Kontakten und Reaktionsplänen im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-response-plan.

AWS CLI

Um einen Reaktionsplan zu löschen

Im folgenden delete-response-plan Beispiel wird der angegebene Reaktionsplan gelöscht.

aws ssm-incidents delete-response-plan \
    --arn "arn:aws:ssm-incidents::111122223333:response-plan/example-response"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Vorbereitung auf Vorfälle im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdelete-timeline-event.

AWS CLI

Um ein Timeline-Ereignis zu löschen

Im folgenden delete-timeline-event Beispiel wird ein benutzerdefiniertes Timeline-Ereignis aus dem angegebenen Incident-Datensatz gelöscht.

aws ssm-incidents delete-timeline-event \
    --event-id "c0bcc885-a41d-eb01-b4ab-9d2de193643c" \
    --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Incident Details im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungget-incident-record.

AWS CLI

Um einen Vorfalldatensatz zu erhalten

Im folgenden get-incident-record Beispiel werden Details zum angegebenen Vorfalldatensatz abgerufen.

aws ssm-incidents get-incident-record \
    --arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"

Ausgabe:

{
    "incidentRecord": {
        "arn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308",
        "automationExecutions": [],
        "creationTime": "2021-05-21T18:16:57.579000+00:00",
        "dedupeString": "c4bcc812-85e7-938d-2b78-17181176ee1a",
        "impact": 5,
        "incidentRecordSource": {
            "createdBy": "arn:aws:iam::111122223333:user/draliatp",
            "invokedBy": "arn:aws:iam::111122223333:user/draliatp",
            "source": "aws.ssm-incidents.custom"
        },
        "lastModifiedBy": "arn:aws:iam::111122223333:user/draliatp",
        "lastModifiedTime": "2021-05-21T18:16:59.149000+00:00",
        "notificationTargets": [],
        "status": "OPEN",
        "title": "Example-Incident"
    }
}

Weitere Informationen finden Sie unter Incident Details im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungget-replication-set.

AWS CLI

Um den Replikationssatz abzurufen

Im folgenden get-replication-set Beispiel werden die Details des Replikationssatzes abgerufen, den Incident Manager verwendet, um Daten in Ihrem Amazon Web Services Services-Konto zu replizieren und zu verschlüsseln.

aws ssm-incidents get-replication-set \
    --arn "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57"

Ausgabe:

{
    "replicationSet": {
        "createdBy": "arn:aws:sts::111122223333:assumed-role/Admin/username",
        "createdTime": "2021-05-14T17:57:22.010000+00:00",
        "deletionProtected": false,
        "lastModifiedBy": "arn:aws:sts::111122223333:assumed-role/Admin/username",
        "lastModifiedTime": "2021-05-14T17:57:22.010000+00:00",
        "regionMap": {
            "us-east-1": {
                "sseKmsKeyId": "DefaultKey",
                "status": "ACTIVE"
            },
            "us-east-2": {
                "sseKmsKeyId": "DefaultKey",
                "status": "ACTIVE",
                "statusMessage": "Tagging inaccessible"
            }
        },
        "status": "ACTIVE"
    }
}

Weitere Informationen finden Sie unter Verwenden des Incident Manager-Replikationssets im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungget-resource-policies.

AWS CLI

Um Ressourcenrichtlinien für einen Reaktionsplan aufzulisten

Das folgende command-name Beispiel listet die Ressourcenrichtlinien auf, die dem angegebenen Reaktionsplan zugeordnet sind.

aws ssm-incidents get-resource-policies \
--resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"

Ausgabe:

{
    "resourcePolicies": [
        {
            "policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"d901b37a-dbb0-458a-8842-75575c464219-external-principals\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::222233334444:root\"},\"Action\":[\"ssm-incidents:GetResponsePlan\",\"ssm-incidents:StartIncident\",\"ssm-incidents:UpdateIncidentRecord\",\"ssm-incidents:GetIncidentRecord\",\"ssm-incidents:CreateTimelineEvent\",\"ssm-incidents:UpdateTimelineEvent\",\"ssm-incidents:GetTimelineEvent\",\"ssm-incidents:ListTimelineEvents\",\"ssm-incidents:UpdateRelatedItems\",\"ssm-incidents:ListRelatedItems\"],\"Resource\":[\"arn:aws:ssm-incidents:*:111122223333:response-plan/Example-Response-Plan\",\"arn:aws:ssm-incidents:*:111122223333:incident-record/Example-Response-Plan/*\"]}]}",
            "policyId": "be8b57191f0371f1c6827341aa3f0a03",
            "ramResourceShareRegion": "us-east-1"
        }
    ]
}

Weitere Informationen finden Sie unter Arbeiten mit gemeinsamen Kontakten und Reaktionsplänen im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungget-response-plan.

AWS CLI

Um Einzelheiten zu einem Reaktionsplan zu erhalten

Im folgenden command-name Beispiel werden Details zu einem bestimmten Reaktionsplan in Ihrem AWS Konto abgerufen.

aws ssm-incidents get-response-plan \
    --arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"

Ausgabe:

{
    "actions": [
        {
            "ssmAutomation": {
                "documentName": "AWSIncidents-CriticalIncidentRunbookTemplate",
                "documentVersion": "$DEFAULT",
                "roleArn": "arn:aws:iam::111122223333:role/aws-service-role/ssm-incidents.amazonaws.com/AWSServiceRoleForIncidentManager",
                "targetAccount": "RESPONSE_PLAN_OWNER_ACCOUNT"
            }
        }
    ],
    "arn": "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan",
    "chatChannel": {
        "chatbotSns": [
            "arn:aws:sns:us-east-1:111122223333:Standard_User"
        ]
    },
    "displayName": "Example response plan",
    "engagements": [
        "arn:aws:ssm-contacts:us-east-1:111122223333:contact/example"
    ],
    "incidentTemplate": {
        "impact": 5,
        "title": "Example-Incident"
    },
    "name": "Example-Response-Plan"
}

Weitere Informationen finden Sie unter Vorbereitung auf Vorfälle im Incident Manager-Benutzerhandbuch.

  • APIEinzelheiten finden Sie GetResponsePlanin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-timeline-event.

AWS CLI

Um Details zu einem Timeline-Ereignis abzurufen

Das folgende get-timeline-event Beispiel gibt Details zum angegebenen Timeline-Ereignis zurück.

aws ssm-incidents get-timeline-event \
    --event-id 20bcc812-8a94-4cd7-520c-0ff742111424 \
    --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"

Ausgabe:

{
    "event": {
        "eventData": "\"Incident Started\"",
        "eventId": "20bcc812-8a94-4cd7-520c-0ff742111424",
        "eventTime": "2021-05-21T18:16:57+00:00",
        "eventType": "Custom Event",
        "eventUpdatedTime": "2021-05-21T18:16:59.944000+00:00",
        "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
    }
}

Weitere Informationen finden Sie unter Incident Details im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendunglist-incident-records.

AWS CLI

Um Vorfallaufzeichnungen aufzulisten

Das folgende command-name Beispiel listet die Vorfallaufzeichnungen in Ihrem Amazon Web Services Services-Konto auf.

aws ssm-incidents list-incident-records

Ausgabe:

{
    "incidentRecordSummaries": [
        {
            "arn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308",
            "creationTime": "2021-05-21T18:16:57.579000+00:00",
            "impact": 5,
            "incidentRecordSource": {
                "createdBy": "arn:aws:iam::111122223333:user/draliatp",
                "invokedBy": "arn:aws:iam::111122223333:user/draliatp",
                "source": "aws.ssm-incidents.custom"
            },
            "status": "OPEN",
            "title": "Example-Incident"
        }
    ]
}

Weitere Informationen finden Sie in der Liste der Vorfälle im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendunglist-related-items.

AWS CLI

Um verwandte Artikel aufzulisten

Das folgende list-related-items Beispiel listet die verwandten Elemente des angegebenen Vorfalls auf.

aws ssm-incidents list-related-items \
    --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"

Ausgabe:

{
    "relatedItems": [
        {
            "identifier": {
                "type": "OTHER",
                "value": {
                    "url": "https://console.aws.amazon.com/systems-manager/opsitems/oi-8ef82158e190/workbench?region=us-east-1"
                }
            },
            "title": "Example related item"
        },
        {
            "identifier": {
                "type": "PARENT",
                "value": {
                    "arn": "arn:aws:ssm:us-east-1:111122223333:opsitem/oi-8084126392ac"
                }
            },
            "title": "parentItem"
        }
    ]
}

Weitere Informationen finden Sie unter Incident Details im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendunglist-replication-sets.

AWS CLI

Um den Replikationssatz aufzulisten

Im folgenden list-replication-set Beispiel wird der Replikationssatz aufgeführt, den Incident Manager verwendet, um Daten in Ihrem AWS Konto zu replizieren und zu verschlüsseln.

aws ssm-incidents list-replication-sets

Ausgabe:

{
    "replicationSetArns": [
        "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57"
    ]
}

Weitere Informationen finden Sie unter Verwenden des Incident Manager-Replikationssatzes im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendunglist-response-plans.

AWS CLI

Um die verfügbaren Reaktionspläne aufzulisten

Das folgende list-response-plans Beispiel listet die verfügbaren Reaktionspläne in Ihrem Amazon Web Services Services-Konto auf.

aws ssm-incidents list-response-plans

Ausgabe:

{
    "responsePlanSummaries": [
        {
            "arn": "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan",
            "displayName": "Example response plan",
            "name": "Example-Response-Plan"
        }
    ]
}

Weitere Informationen finden Sie unter Vorbereitung auf Vorfälle im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

AWS CLI

Um Tags für einen Reaktionsplan aufzulisten

Das folgende list-tags-for-resource Beispiel listet die Tags auf, die dem angegebenen Reaktionsplan zugeordnet sind.

aws ssm-incidents list-tags-for-resource \
    --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"

Ausgabe:

{
    "tags": {
    "group1": "1"
    }
}

Weitere Informationen finden Sie unter Tagging im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendunglist-timeline-events.

AWS CLI

Um die Ereignisse eines Vorfalls in der Zeitleiste aufzulisten

Das folgende command-name Beispiel listet die Ereignisse auf der Zeitleiste des angegebenen Vorfalls auf.

aws ssm-incidents list-timeline-events \
    --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"

Ausgabe:

{
    "eventSummaries": [
        {
            "eventId": "8cbcc889-35e1-a42d-2429-d6f100799915",
            "eventTime": "2021-05-21T22:36:13.766000+00:00",
            "eventType": "SSM Incident Record Update",
            "eventUpdatedTime": "2021-05-21T22:36:13.766000+00:00",
            "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
        },
        {
            "eventId": "a2bcc825-aab5-1787-c605-f9bb2640d85b",
            "eventTime": "2021-05-21T18:58:46.443000+00:00",
            "eventType": "SSM Incident Record Update",
            "eventUpdatedTime": "2021-05-21T18:58:46.443000+00:00",
            "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
        },
        {
            "eventId": "5abcc812-89c0-b0a8-9437-1c74223d4685",
            "eventTime": "2021-05-21T18:16:59.149000+00:00",
            "eventType": "SSM Incident Record Update",
            "eventUpdatedTime": "2021-05-21T18:16:59.149000+00:00",
            "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
        },
        {
            "eventId": "06bcc812-8820-405e-4065-8d2b14d29b92",
            "eventTime": "2021-05-21T18:16:58+00:00",
            "eventType": "SSM Automation Execution Start Failure for Incident",
            "eventUpdatedTime": "2021-05-21T18:16:58.689000+00:00",
            "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
        },
        {
            "eventId": "20bcc812-8a94-4cd7-520c-0ff742111424",
            "eventTime": "2021-05-21T18:16:57+00:00",
            "eventType": "Custom Event",
            "eventUpdatedTime": "2021-05-21T18:16:59.944000+00:00",
            "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
        },
        {
            "eventId": "c0bcc885-a41d-eb01-b4ab-9d2de193643c",
            "eventTime": "2020-10-01T20:30:00+00:00",
            "eventType": "Custom Event",
            "eventUpdatedTime": "2021-05-21T22:28:26.299000+00:00",
            "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
        }
    ]
}

Weitere Informationen finden Sie unter Incident-Details im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungput-resource-policy.

AWS CLI

Um einen Reaktionsplan und Vorfälle zu teilen

Im folgenden command-name Beispiel wird eine Ressourcenrichtlinie hinzugefügt Example-Response-Plan, die den Reaktionsplan und die zugehörigen Vorfälle mit dem angegebenen Prinzipal teilt.

aws ssm-incidents put-resource-policy \
    --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" \
    --policy "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"ExampleResourcePolciy\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::222233334444:root\"},\"Action\":[\"ssm-incidents:GetResponsePlan\",\"ssm-incidents:StartIncident\",\"ssm-incidents:UpdateIncidentRecord\",\"ssm-incidents:GetIncidentRecord\",\"ssm-incidents:CreateTimelineEvent\",\"ssm-incidents:UpdateTimelineEvent\",\"ssm-incidents:GetTimelineEvent\",\"ssm-incidents:ListTimelineEvents\",\"ssm-incidents:UpdateRelatedItems\",\"ssm-incidents:ListRelatedItems\"],\"Resource\":[\"arn:aws:ssm-incidents:*:111122223333:response-plan/Example-Response-Plan\",\"arn:aws:ssm-incidents:*:111122223333:incident-record/Example-Response-Plan/*\"]}]}"

Ausgabe:

{
    "policyId": "be8b57191f0371f1c6827341aa3f0a03"
}

Weitere Informationen finden Sie im Incident Manager-Benutzerhandbuch unter Arbeiten mit gemeinsamen Kontakten und Reaktionsplänen.

Das folgende Codebeispiel zeigt die Verwendungstart-incident.

AWS CLI

Um einen Vorfall zu starten

Im folgenden start-incident Beispiel wird ein Vorfall mit dem angegebenen Reaktionsplan gestartet.

aws ssm-incidents start-incident \
    --response-plan-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"

Ausgabe:

{
    "incidentRecordArn": "arn:aws:ssm-incidents::682428703967:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
}

Weitere Informationen finden Sie unter Incident Creation im Incident Manager-Benutzerhandbuch.

  • APIEinzelheiten finden Sie StartIncidentin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungtag-resource.

AWS CLI

Um einen Reaktionsplan zu taggen

Im folgenden tag-resource Beispiel wird ein bestimmter Antwortplan mit dem angegebenen Tag-Schlüssel-Wert-Paar gekennzeichnet.

aws ssm-incidents tag-resource \
    --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" \
    --tags '{"group1":"1"}'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Tagging im Incident Manager-Benutzerhandbuch.

  • APIEinzelheiten finden Sie TagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunguntag-resource.

AWS CLI

Um Tags aus einem Reaktionsplan zu entfernen

Im folgenden untag-resource Beispiel werden die angegebenen Tags aus dem Reaktionsplan entfernt.

aws ssm-incidents untag-resource \
    --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" \
    --tag-keys '["group1"]'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Tagging im Incident Manager-Benutzerhandbuch.

  • APIEinzelheiten finden Sie UntagResourcein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-deletion-protection.

AWS CLI

Um den Löschschutz für Replikationssätze zu aktualisieren

Im folgenden update-deletion-protection Beispiel wird der Löschschutz in Ihrem Konto aktualisiert, um Sie davor zu schützen, die letzte Region in Ihrem Replikationssatz zu löschen.

aws ssm-incidents update-deletion-protection \
    --arn "arn:aws:ssm-incidents::111122223333:replication-set/a2bcc5c9-0f53-8047-7fef-c20749989b40" \
    --deletion-protected

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwenden des Incident Manager-Replikationssatzes im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungupdate-incident-record.

AWS CLI

Um einen Vorfalldatensatz zu aktualisieren

Das folgende command-name Beispiel behebt den angegebenen Vorfall.

aws ssm-incidents update-incident-record \
    --arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" \
    --status "RESOLVED"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Incident Details im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungupdate-related-items.

AWS CLI

Um ein Element zu aktualisieren, das sich auf Vorfälle bezieht

Im folgenden update-related-item Beispiel wird ein verwandtes Element aus dem angegebenen Vorfalldatensatz entfernt.

aws ssm-incidents update-related-items \
    --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" \
    --related-items-update '{"itemToRemove": {"type": "OTHER", "value": {"url": "https://console.aws.amazon.com/systems-manager/opsitems/oi-8ef82158e190/workbench?region=us-east-1"}}}'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Incident Details im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungupdate-replication-set.

AWS CLI

Um einen Replikationssatz zu aktualisieren

Im folgenden command-name Beispiel wird die Region us-east-2 aus dem Replikationssatz gelöscht.

aws ssm-incidents update-replication-set \
    --arn "arn:aws:ssm-incidents::111122223333:replication-set/a2bcc5c9-0f53-8047-7fef-c20749989b40" \
    --actions '[{"deleteRegionAction": {"regionName": "us-east-2"}}]'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwenden des Incident Manager-Replikationssatzes im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungupdate-response-plan.

AWS CLI

Um einen Reaktionsplan zu aktualisieren

Im folgenden update-response-plan Beispiel wird ein Chat-Kanal aus dem angegebenen Antwortplan entfernt.

aws ssm-incidents update-response-plan \
    --arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" \
    --chat-channel '{"empty":{}}'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Vorbereitung auf Vorfälle im Incident Manager-Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungupdate-timeline-event.

AWS CLI

Um ein Timeline-Ereignis zu aktualisieren

Im folgenden update-timeline-event Beispiel wird die Uhrzeit aktualisiert, zu der das Ereignis eingetreten ist.

aws ssm-incidents update-timeline-event \
    --event-id 20bcc812-8a94-4cd7-520c-0ff742111424 \
    --incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" \
    --event-time "2021-05-21T18:10:57+00:00"

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Incident Details im Incident Manager-Benutzerhandbuch.