本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 的 Incident Manager 範例 AWS CLI
<a name="cli_ssm-incidents_code_examples"></a>

下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 Incident Manager 來執行動作和實作常見案例。

*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。

每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。

**Topics**
+ [動作](#actions)

## 動作
<a name="actions"></a>

### `create-replication-set`
<a name="ssm-incidents_CreateReplicationSet_cli_topic"></a>

以下程式碼範例顯示如何使用 `create-replication-set`。

**AWS CLI**  
**建立複寫集**  
下列 `create-replication-set` 範例會建立 Incident Manager 用來複寫和加密 Amazon Web Services 帳戶中資料的複寫集。此範例在建立複寫集時使用 us-east-1 和 us-east-2 區域。  

```
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"}}'
```
輸出：  

```
{
    "replicationSetArns": [
        "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57"
    ]
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[使用 Incident Manager 複寫集](https://docs.aws.amazon.com/incident-manager/latest/userguide/replication.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateReplicationSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/create-replication-set.html)。

### `create-response-plan`
<a name="ssm-incidents_CreateResponsePlan_cli_topic"></a>

以下程式碼範例顯示如何使用 `create-response-plan`。

**AWS CLI**  
**建立回應計劃**  
下列 `create-response-plan` 範例會建立具有指定詳細資訊的回應計劃。  

```
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"]'
```
輸出：  

```
{
    "arn": "arn:aws:ssm-incidents::111122223333:response-plan/example-response"
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件準備](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-response.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateResponsePlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/create-response-plan.html)。

### `create-timeline-event`
<a name="ssm-incidents_CreateTimelineEvent_cli_topic"></a>

以下程式碼範例顯示如何使用 `create-timeline-event`。

**AWS CLI**  
**範例 1：建立自訂時間軸事件**  
下列 `create-timeline-event` 範例會在指定事件的指定時間，建立自訂時間軸事件。  

```
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"
```
輸出：  

```
{
    "eventId": "c0bcc885-a41d-eb01-b4ab-9d2deEXAMPLE",
    "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4EXAMPLE"
}
```
**範例 2：使用事件備註建立時間軸事件**  
下列 `create-timeline-event` 範例會建立 'Incident notes' 面板中列出的時間軸事件。  

```
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"}]'
```
輸出：  

```
{
    "eventId": "a41dc885-c0bc-b4ab-eb01-de9d2EXAMPLE",
    "incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4EXAMPLE"
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件詳細資訊](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [CreateTimelineEvent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/create-timeline-event.html)。

### `delete-incident-record`
<a name="ssm-incidents_DeleteIncidentRecord_cli_topic"></a>

以下程式碼範例顯示如何使用 `delete-incident-record`。

**AWS CLI**  
**刪除事件記錄**  
以下 `delete-incident-record` 範例會刪除指定的事件記錄。  

```
aws ssm-incidents delete-incident-record \
    --arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件追蹤](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteIncidentRecord](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/delete-incident-record.html)。

### `delete-replication-set`
<a name="ssm-incidents_DeleteReplicationSet_cli_topic"></a>

以下程式碼範例顯示如何使用 `delete-replication-set`。

**AWS CLI**  
**刪除複寫集**  
下列 `delete-replication-set` 範例會從 Amazon Web Services 帳戶刪除複寫集。刪除複寫集也會刪除所有 Incident Manager 資料。這個動作無法復原。  

```
aws ssm-incidents delete-replication-set \
    --arn "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57"
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[使用 Incident Manager 複寫集](https://docs.aws.amazon.com/incident-manager/latest/userguide/replication.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteReplicationSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/delete-replication-set.html)。

### `delete-resource-policy`
<a name="ssm-incidents_DeleteResourcePolicy_cli_topic"></a>

以下程式碼範例顯示如何使用 `delete-resource-policy`。

**AWS CLI**  
**刪除資源政策**  
下列 `delete-resource-policy` 範例會從回應計劃刪除資源政策。這將撤銷與回應計劃共用的主體或組織的存取權。  

```
aws ssm-incidents delete-resource-policy \
    --policy-id "be8b57191f0371f1c6827341aa3f0a03" \
    --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan"
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[使用共用聯絡人和回應計劃](https://docs.aws.amazon.com/incident-manager/latest/userguide/sharing.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteResourcePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/delete-resource-policy.html)。

### `delete-response-plan`
<a name="ssm-incidents_DeleteResponsePlan_cli_topic"></a>

以下程式碼範例顯示如何使用 `delete-response-plan`。

**AWS CLI**  
**刪除回應計劃**  
以下 `delete-response-plan` 範例會刪除指定的回應計劃。  

```
aws ssm-incidents delete-response-plan \
    --arn "arn:aws:ssm-incidents::111122223333:response-plan/example-response"
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件準備](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-response.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteResponsePlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/delete-response-plan.html)。

### `delete-timeline-event`
<a name="ssm-incidents_DeleteTimelineEvent_cli_topic"></a>

以下程式碼範例顯示如何使用 `delete-timeline-event`。

**AWS CLI**  
**刪除時間軸事件**  
下列 `delete-timeline-event` 範例會從指定的事件記錄中刪除自訂時間軸事件。  

```
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"
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件詳細資訊](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DeleteTimelineEvent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/delete-timeline-event.html)。

### `get-incident-record`
<a name="ssm-incidents_GetIncidentRecord_cli_topic"></a>

以下程式碼範例顯示如何使用 `get-incident-record`。

**AWS CLI**  
**取得事件記錄**  
下列 `get-incident-record` 範例會取得指定事件記錄的詳細資訊。  

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

```
{
    "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"
    }
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件詳細資訊](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetIncidentRecord](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/get-incident-record.html)。

### `get-replication-set`
<a name="ssm-incidents_GetReplicationSet_cli_topic"></a>

以下程式碼範例顯示如何使用 `get-replication-set`。

**AWS CLI**  
**取得複寫集**  
下列 `get-replication-set` 範例會取得 Incident Manager 用來複寫和加密 Amazon Web Services 帳戶中的資料複寫集的詳細資訊。  

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

```
{
    "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"
    }
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[使用 Incident Manager 複寫集](https://docs.aws.amazon.com/incident-manager/latest/userguide/replication.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetReplicationSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/get-replication-set.html)。

### `get-resource-policies`
<a name="ssm-incidents_GetResourcePolicies_cli_topic"></a>

以下程式碼範例顯示如何使用 `get-resource-policies`。

**AWS CLI**  
**列出回應計劃的資源政策**  
下列 `command-name` 範例列出與指定之回應計劃相關聯的資源政策。  

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

```
{
    "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"
        }
    ]
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[使用共用聯絡人和回應計劃](https://docs.aws.amazon.com/incident-manager/latest/userguide/sharing.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetResourcePolicies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/get-resource-policies.html)。

### `get-response-plan`
<a name="ssm-incidents_GetResponsePlan_cli_topic"></a>

以下程式碼範例顯示如何使用 `get-response-plan`。

**AWS CLI**  
**取得回應計劃的詳細資訊**  
下列`command-name`範例會取得您 AWS 帳戶中指定回應計劃的詳細資訊。  

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

```
{
    "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"
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件準備](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-response.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetResponsePlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/get-response-plan.html)。

### `get-timeline-event`
<a name="ssm-incidents_GetTimelineEvent_cli_topic"></a>

以下程式碼範例顯示如何使用 `get-timeline-event`。

**AWS CLI**  
**取得時間軸事件的詳細資訊**  
下列 `get-timeline-event` 範例會傳回指定之時間軸事件的詳細資訊。  

```
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"
```
輸出：  

```
{
    "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"
    }
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件詳細資訊](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [GetTimelineEvent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/get-timeline-event.html)。

### `list-incident-records`
<a name="ssm-incidents_ListIncidentRecords_cli_topic"></a>

以下程式碼範例顯示如何使用 `list-incident-records`。

**AWS CLI**  
**列出事件記錄**  
下列 `command-name` 範例列出 Amazon Web Services 帳戶中的事件記錄。  

```
aws ssm-incidents list-incident-records
```
輸出：  

```
{
    "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"
        }
    ]
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件清單](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-list.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListIncidentRecords](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/list-incident-records.html)。

### `list-related-items`
<a name="ssm-incidents_ListRelatedItems_cli_topic"></a>

以下程式碼範例顯示如何使用 `list-related-items`。

**AWS CLI**  
**列出相關項目**  
下列 `list-related-items` 範例列出指定事件的相關項目。  

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

```
{
    "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"
        }
    ]
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件詳細資訊](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListRelatedItems](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/list-related-items.html)。

### `list-replication-sets`
<a name="ssm-incidents_ListReplicationSets_cli_topic"></a>

以下程式碼範例顯示如何使用 `list-replication-sets`。

**AWS CLI**  
**列出複寫集**  
下列`list-replication-set`範例列出 Incident Manager 用來複寫和加密 AWS 帳戶中資料的複寫集。  

```
aws ssm-incidents list-replication-sets
```
輸出：  

```
{
    "replicationSetArns": [
        "arn:aws:ssm-incidents::111122223333:replication-set/c4bcb603-4bf9-bb3f-413c-08df53673b57"
    ]
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[使用 Incident Manager 複寫集](https://docs.aws.amazon.com/incident-manager/latest/userguide/replication.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListReplicationSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/list-replication-sets.html)。

### `list-response-plans`
<a name="ssm-incidents_ListResponsePlans_cli_topic"></a>

以下程式碼範例顯示如何使用 `list-response-plans`。

**AWS CLI**  
**列出可用的回應計劃**  
下列 `list-response-plans` 範例列出 Amazon Web Services 帳戶中可用的回應計劃。  

```
aws ssm-incidents list-response-plans
```
輸出：  

```
{
    "responsePlanSummaries": [
        {
            "arn": "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan",
            "displayName": "Example response plan",
            "name": "Example-Response-Plan"
        }
    ]
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件準備](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-response.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListResponsePlans](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/list-response-plans.html)。

### `list-tags-for-resource`
<a name="ssm-incidents_ListTagsForResource_cli_topic"></a>

以下程式碼範例顯示如何使用 `list-tags-for-resource`。

**AWS CLI**  
**列出回應計劃的標籤**  
下列 `list-tags-for-resource` 範例列出與指定回應計劃相關聯的標籤。  

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

```
{
    "tags": {
    "group1": "1"
    }
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[標記](https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/list-tags-for-resource.html)。

### `list-timeline-events`
<a name="ssm-incidents_ListTimelineEvents_cli_topic"></a>

以下程式碼範例顯示如何使用 `list-timeline-events`。

**AWS CLI**  
**列出事件的時間軸事件**  
下列 `command-name` 範例列出指定事件的時間軸事件。  

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

```
{
    "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"
        }
    ]
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件詳細資訊](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [ListTimelineEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/list-timeline-events.html)。

### `put-resource-policy`
<a name="ssm-incidents_PutResourcePolicy_cli_topic"></a>

以下程式碼範例顯示如何使用 `put-resource-policy`。

**AWS CLI**  
**共用回應計劃和事件**  
下列 `command-name` 範例會將資源政策新增至 Example-Response-Plan，以與指定的主體共用回應計劃和相關事件。  

```
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/*\"]}]}"
```
輸出：  

```
{
    "policyId": "be8b57191f0371f1c6827341aa3f0a03"
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[使用共用聯絡人和回應計劃](https://docs.aws.amazon.com/incident-manager/latest/userguide/sharing.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [PutResourcePolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/put-resource-policy.html)。

### `start-incident`
<a name="ssm-incidents_StartIncident_cli_topic"></a>

以下程式碼範例顯示如何使用 `start-incident`。

**AWS CLI**  
**啟動事件**  
下列 `start-incident` 範例使用指定的回應計劃啟動事件。  

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

```
{
    "incidentRecordArn": "arn:aws:ssm-incidents::682428703967:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
}
```
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件建立](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-creation.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [StartIncident](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/start-incident.html)。

### `tag-resource`
<a name="ssm-incidents_TagResource_cli_topic"></a>

以下程式碼範例顯示如何使用 `tag-resource`。

**AWS CLI**  
**標記回應計劃**  
下列 `tag-resource` 範例使用提供的標籤鍵值對來標記指定的回應計劃。  

```
aws ssm-incidents tag-resource \
    --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" \
    --tags '{"group1":"1"}'
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[標記](https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/tag-resource.html)。

### `untag-resource`
<a name="ssm-incidents_UntagResource_cli_topic"></a>

以下程式碼範例顯示如何使用 `untag-resource`。

**AWS CLI**  
**從資源移除標籤**  
下列 `untag-resource` 範例會從回應計劃中移除指定的標籤。  

```
aws ssm-incidents untag-resource \
    --resource-arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" \
    --tag-keys '["group1"]'
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[標記](https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/untag-resource.html)。

### `update-deletion-protection`
<a name="ssm-incidents_UpdateDeletionProtection_cli_topic"></a>

以下程式碼範例顯示如何使用 `update-deletion-protection`。

**AWS CLI**  
**更新複寫集刪除保護**  
下列 `update-deletion-protection` 範例會更新您帳戶中的刪除保護，防止您刪除複寫集中的最後一個區域。  

```
aws ssm-incidents update-deletion-protection \
    --arn "arn:aws:ssm-incidents::111122223333:replication-set/a2bcc5c9-0f53-8047-7fef-c20749989b40" \
    --deletion-protected
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[使用 Incident Manager 複寫集](https://docs.aws.amazon.com/incident-manager/latest/userguide/replication.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateDeletionProtection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/update-deletion-protection.html)。

### `update-incident-record`
<a name="ssm-incidents_UpdateIncidentRecord_cli_topic"></a>

以下程式碼範例顯示如何使用 `update-incident-record`。

**AWS CLI**  
**更新事件記錄**  
下列 `command-name` 範例會解析指定的事件。  

```
aws ssm-incidents update-incident-record \
    --arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308" \
    --status "RESOLVED"
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件詳細資訊](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateIncidentRecord](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/update-incident-record.html)。

### `update-related-items`
<a name="ssm-incidents_UpdateRelatedItems_cli_topic"></a>

以下程式碼範例顯示如何使用 `update-related-items`。

**AWS CLI**  
**更新事件相關項目**  
下列 `update-related-item` 範例會從指定的事件記錄中移除相關項目。  

```
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"}}}'
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件詳細資訊](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateRelatedItems](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/update-related-items.html)。

### `update-replication-set`
<a name="ssm-incidents_UpdateReplicationSet_cli_topic"></a>

以下程式碼範例顯示如何使用 `update-replication-set`。

**AWS CLI**  
**更新複寫集**  
下列 `command-name` 範例會從複寫集刪除 us-east-2 區域。  

```
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"}}]'
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[使用 Incident Manager 複寫集](https://docs.aws.amazon.com/incident-manager/latest/userguide/replication.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateReplicationSet](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/update-replication-set.html)。

### `update-response-plan`
<a name="ssm-incidents_UpdateResponsePlan_cli_topic"></a>

以下程式碼範例顯示如何使用 `update-response-plan`。

**AWS CLI**  
**更新回應計劃**  
下列 `update-response-plan` 範例會從指定的回應計劃中移除聊天頻道。  

```
aws ssm-incidents update-response-plan \
    --arn "arn:aws:ssm-incidents::111122223333:response-plan/Example-Response-Plan" \
    --chat-channel '{"empty":{}}'
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件準備](https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-response.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateResponsePlan](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/update-response-plan.html)。

### `update-timeline-event`
<a name="ssm-incidents_UpdateTimelineEvent_cli_topic"></a>

以下程式碼範例顯示如何使用 `update-timeline-event`。

**AWS CLI**  
**更新時間軸事件**  
下列 `update-timeline-event` 範例會更新事件發生的時間。  

```
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"
```
此命令不會產生輸出。  
如需詳細資訊，請參閱《*Incident Manager 使用者指南*》中的[事件詳細資訊](https://docs.aws.amazon.com/incident-manager/latest/userguide/tracking-details.html)。  
+  如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [UpdateTimelineEvent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-incidents/update-timeline-event.html)。