This documentation is for Version 1 of the Amazon CLI only. For documentation related to Version 2 of the Amazon CLI, see the Version 2 User Guide.
Incident Manager examples using Amazon CLI
The following code examples show you how to perform actions and implement common scenarios by using the Amazon Command Line Interface with Incident Manager.
Actions are code excerpts from larger programs and must be run in context. While actions show you how to call individual service functions, you can see actions in context in their related scenarios.
Each example includes a link to the complete source code, where you can find instructions on how to set up and run the code in context.
Topics
Actions
The following code example shows how to use create-replication-set.
- Amazon CLI
-
To create the replication set
The following
create-replication-setexample creates the replication set Incident Manager uses to replicate and encrypt data in your Amazon Web Services account. This example uses the us-east-1 and us-east-2 Regions while creating the replication set.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"}}'Output:
{ "replicationSetArns": [ "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57" ] }For more information, see Using the Incident Manager replication set
in the Incident Manager User Guide. -
For API details, see CreateReplicationSet
in Amazon CLI Command Reference.
-
The following code example shows how to use create-response-plan.
- Amazon CLI
-
To create a response plan
The following
create-response-planexample creates a response plan with the specified details.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"]'Output:
{ "arn": "arn:aws:ssm-incidents::111122223333:response-plan/example-response" }For more information, see Incident preparation
in the Incident Manager User Guide. -
For API details, see CreateResponsePlan
in Amazon CLI Command Reference.
-
The following code example shows how to use create-timeline-event.
- Amazon CLI
-
Example 1: To create a custom timeline event
The following
create-timeline-eventexample creates a custom timeline event at the specified time on the specified incident.aws ssm-incidents create-timeline-event \ --event-data "\"example timeline event\"" \ --event-time2022-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"Output:
{ "eventId": "c0bcc885-a41d-eb01-b4ab-9d2deEXAMPLE", "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4EXAMPLE" }Example 2: To create a timeline event with an incident note
The following
create-timeline-eventexample creates a timeline event that is listed in the 'Incident notes' panel.aws ssm-incidents create-timeline-event \ --event-data "\"NewNote\"" \ --event-type "Note" \ --incident-record-arn"arn:aws:ssm-incidents::111122223333:incident-record/Test/6cc46130-ca6c-3b38-68f1-f6abeEXAMPLE"\ --event-time2023-06-20T12:06:00.000\ --event-references '[{"resource":"arn:aws:ssm-incidents::111122223333:incident-record/Test/6cc46130-ca6c-3b38-68f1-f6abeEXAMPLE"}]'Output:
{ "eventId": "a41dc885-c0bc-b4ab-eb01-de9d2EXAMPLE", "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4EXAMPLE" }For more information, see Incident details
in the Incident Manager User Guide. -
For API details, see CreateTimelineEvent
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-incident-record.
- Amazon CLI
-
To delete an incident record
The following
delete-incident-recordexample deletes the specified incident record.aws ssm-incidents delete-incident-record \ --arn"arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"This command produces no output.
For more information, see Incident tracking
in the Incident Manager User Guide. -
For API details, see DeleteIncidentRecord
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-replication-set.
- Amazon CLI
-
To delete the replication set
The following
delete-replication-setexample deletes the replication set from your Amazon Web Services account. Deleting the replication set also deletes all Incident Manager data. This can't be undone.aws ssm-incidents delete-replication-set \ --arn"arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57"This command produces no output.
For more information, see Using the Incident Manager replication set
in the Incident Manager User Guide. -
For API details, see DeleteReplicationSet
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-resource-policy.
- Amazon CLI
-
To delete a resource policy
The following
delete-resource-policyexample deletes a resource policy from a response plan. This will revoke access from the principal or organization that the response plan was shared with.aws ssm-incidents delete-resource-policy \ --policy-id"be8b57191f0371f1c6827341aa3f0a03"\ --resource-arn"arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"This command produces no output.
For more information, see Working with shared contacts and response plans
in the Incident Manager User Guide. -
For API details, see DeleteResourcePolicy
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-response-plan.
- Amazon CLI
-
To delete a response plan
The following
delete-response-planexample deletes the specified response plan.aws ssm-incidents delete-response-plan \ --arn"arn:aws:ssm-incidents::111122223333:response-plan/example-response"This command produces no output.
For more information, see Incident preparation
in the Incident Manager User Guide. -
For API details, see DeleteResponsePlan
in Amazon CLI Command Reference.
-
The following code example shows how to use delete-timeline-event.
- Amazon CLI
-
To delete a timeline event
The following
delete-timeline-eventexample deletes a custom timeline event from the specified incident record.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"This command produces no output.
For more information, see Incident details
in the Incident Manager User Guide. -
For API details, see DeleteTimelineEvent
in Amazon CLI Command Reference.
-
The following code example shows how to use get-incident-record.
- Amazon CLI
-
To get an incident record
The following
get-incident-recordexample gets details about the specified incident record.aws ssm-incidents get-incident-record \ --arn"arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"Output:
{ "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" } }For more information, see Incident details
in the Incident Manager User Guide. -
For API details, see GetIncidentRecord
in Amazon CLI Command Reference.
-
The following code example shows how to use get-replication-set.
- Amazon CLI
-
To get the replication set
The following
get-replication-setexample gets the details of the replication set Incident Manager uses to replicate and encrypt data in your Amazon Web Services account.aws ssm-incidents get-replication-set \ --arn"arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57"Output:
{ "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" } }For more information, see Using the Incident Manager replication set
in the Incident Manager User Guide. -
For API details, see GetReplicationSet
in Amazon CLI Command Reference.
-
The following code example shows how to use get-resource-policies.
- Amazon CLI
-
To list resource policies for a response plan
The following
command-nameexample lists the resource policies associated with the specified response plan.aws ssm-incidents get-resource-policies \ --resource-arn"arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"Output:
{ "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" } ] }For more information, see Working with shared contacts and response plans
in the Incident Manager User Guide. -
For API details, see GetResourcePolicies
in Amazon CLI Command Reference.
-
The following code example shows how to use get-response-plan.
- Amazon CLI
-
To get details of a response plan
The following
command-nameexample gets details about a specified response plan in your Amazon account.aws ssm-incidents get-response-plan \ --arn"arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"Output:
{ "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" }For more information, see Incident preparation
in the Incident Manager User Guide. -
For API details, see GetResponsePlan
in Amazon CLI Command Reference.
-
The following code example shows how to use get-timeline-event.
- Amazon CLI
-
To get details of a timeline event
The following
get-timeline-eventexample returns details of the specified timeline event.aws ssm-incidents get-timeline-event \ --event-id20bcc812-8a94-4cd7-520c-0ff742111424\ --incident-record-arn"arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"Output:
{ "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" } }For more information, see Incident details
in the Incident Manager User Guide. -
For API details, see GetTimelineEvent
in Amazon CLI Command Reference.
-
The following code example shows how to use list-incident-records.
- Amazon CLI
-
To list incident records
The following
command-nameexample lists the incident records in your Amazon Web Services account.aws ssm-incidents list-incident-recordsOutput:
{ "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" } ] }For more information, see Incident list
in the Incident Manager User Guide. -
For API details, see ListIncidentRecords
in Amazon CLI Command Reference.
-
The following code example shows how to use list-related-items.
- Amazon CLI
-
To list related items
The following
list-related-itemsexample lists the related items of the specified incident.aws ssm-incidents list-related-items \ --incident-record-arn"arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"Output:
{ "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" } ] }For more information, see Incident details
in the Incident Manager User Guide. -
For API details, see ListRelatedItems
in Amazon CLI Command Reference.
-
The following code example shows how to use list-replication-sets.
- Amazon CLI
-
To list the replication set
The following
list-replication-setexample lists the replication set Incident Manager uses to replicate and encrypt data in your Amazon account.aws ssm-incidents list-replication-setsOutput:
{ "replicationSetArns": [ "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57" ] }For more information, see Using the Incident Manager replication set
in the Incident Manager User Guide. -
For API details, see ListReplicationSets
in Amazon CLI Command Reference.
-
The following code example shows how to use list-response-plans.
- Amazon CLI
-
To list the available response plans
The following
list-response-plansexample lists the available response plans in your Amazon Web Services account.aws ssm-incidents list-response-plansOutput:
{ "responsePlanSummaries": [ { "arn": "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan", "displayName": "Example response plan", "name": "Example-Response-Plan" } ] }For more information, see Incident preparation
in the Incident Manager User Guide. -
For API details, see ListResponsePlans
in Amazon CLI Command Reference.
-
The following code example shows how to use list-tags-for-resource.
- Amazon CLI
-
To list tags for a response plan
The following
list-tags-for-resourceexample lists the tags associated with the specified response plan.aws ssm-incidents list-tags-for-resource \ --resource-arn"arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"Output:
{ "tags": { "group1": "1" } }For more information, see Tagging
in the Incident Manager User Guide. -
For API details, see ListTagsForResource
in Amazon CLI Command Reference.
-
The following code example shows how to use list-timeline-events.
- Amazon CLI
-
To list timeline events of an incident
The following
command-nameexample lists the timeline events of the specified incident.aws ssm-incidents list-timeline-events \ --incident-record-arn"arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"Output:
{ "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" } ] }For more information, see Incident details
in the Incident Manager User Guide. -
For API details, see ListTimelineEvents
in Amazon CLI Command Reference.
-
The following code example shows how to use put-resource-policy.
- Amazon CLI
-
To share a response plan and incidents
The following
command-nameexample adds a resource policy to the Example-Response-Plan that shares the response plan and associated incidents with the specified principal.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/*\"]}]}"Output:
{ "policyId": "be8b57191f0371f1c6827341aa3f0a03" }For more information, see Working with shared contacts and response plans
in the Incident Manager User Guide. -
For API details, see PutResourcePolicy
in Amazon CLI Command Reference.
-
The following code example shows how to use start-incident.
- Amazon CLI
-
To start an incident
The following
start-incidentexample starts an incident using the specified response plan.aws ssm-incidents start-incident \ --response-plan-arn"arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"Output:
{ "incidentRecordArn": "arn:aws:ssm-incidents::682428703967:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" }For more information, see Incident creation
in the Incident Manager User Guide. -
For API details, see StartIncident
in Amazon CLI Command Reference.
-
The following code example shows how to use tag-resource.
- Amazon CLI
-
To tag a response plan
The following
tag-resourceexample tags a specified response plan with the provided tag key-value pair.aws ssm-incidents tag-resource \ --resource-arn"arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"\ --tags '{"group1":"1"}'This command produces no output.
For more information, see Tagging
in the Incident Manager User Guide. -
For API details, see TagResource
in Amazon CLI Command Reference.
-
The following code example shows how to use untag-resource.
- Amazon CLI
-
To remove tags from a response plan
The following
untag-resourceexample removes the specified tags from the response plan.aws ssm-incidents untag-resource \ --resource-arn"arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"\ --tag-keys '["group1"]'This command produces no output.
For more information, see Tagging
in the Incident Manager User Guide. -
For API details, see UntagResource
in Amazon CLI Command Reference.
-
The following code example shows how to use update-deletion-protection.
- Amazon CLI
-
To update replication set deletion protection
The following
update-deletion-protectionexample updates the deletion protection in your account to protect you from deleting the last Region in your replication set.aws ssm-incidents update-deletion-protection \ --arn"arn:aws:ssm-incidents::111122223333:replication-set/a2bcc5c9-0f53-8047-7fef-c20749989b40"\ --deletion-protectedThis command produces no output.
For more information, see Using the Incident Manager replication set
in the Incident Manager User Guide. -
For API details, see UpdateDeletionProtection
in Amazon CLI Command Reference.
-
The following code example shows how to use update-incident-record.
- Amazon CLI
-
To update an incident record
The following
command-nameexample resolves the specified incident.aws ssm-incidents update-incident-record \ --arn"arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"\ --status"RESOLVED"This command produces no output.
For more information, see Incident details
in the Incident Manager User Guide. -
For API details, see UpdateIncidentRecord
in Amazon CLI Command Reference.
-
The following code example shows how to use update-related-items.
- Amazon CLI
-
To update an incidents related item
The following
update-related-itemexample removes a related item from the specified incident record.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"}}}'This command produces no output.
For more information, see Incident details
in the Incident Manager User Guide. -
For API details, see UpdateRelatedItems
in Amazon CLI Command Reference.
-
The following code example shows how to use update-replication-set.
- Amazon CLI
-
To update a replication set
The following
command-nameexample deletes the us-east-2 Region from the replication set.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"}}]'This command produces no output.
For more information, see Using the Incident Manager replication set
in the Incident Manager User Guide. -
For API details, see UpdateReplicationSet
in Amazon CLI Command Reference.
-
The following code example shows how to use update-response-plan.
- Amazon CLI
-
To update a response plan
The following
update-response-planexample removes a chat channel from the specified response plan.aws ssm-incidents update-response-plan \ --arn"arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"\ --chat-channel '{"empty":{}}'This command produces no output.
For more information, see Incident preparation
in the Incident Manager User Guide. -
For API details, see UpdateResponsePlan
in Amazon CLI Command Reference.
-
The following code example shows how to use update-timeline-event.
- Amazon CLI
-
To update a timeline event
The following
update-timeline-eventexample updates the time that the event occurred.aws ssm-incidents update-timeline-event \ --event-id20bcc812-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"This command produces no output.
For more information, see Incident details
in the Incident Manager User Guide. -
For API details, see UpdateTimelineEvent
in Amazon CLI Command Reference.
-