

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Contoh Kontak Manajer Insiden menggunakan AWS CLI
<a name="cli_ssm-contacts_code_examples"></a>

Contoh kode berikut menunjukkan kepada Anda cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan Kontak Manajer Insiden AWS Command Line Interface dengan.

*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

**Topics**
+ [Tindakan](#actions)

## Tindakan
<a name="actions"></a>

### `accept-page`
<a name="ssm-contacts_AcceptPage_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`accept-page`.

**AWS CLI**  
**Untuk menerima halaman selama dan keterlibatan**  
`accept-page`Contoh berikut menggunakan kode terima yang dikirim ke saluran kontak untuk menerima halaman.  

```
aws ssm-contacts accept-page \
    --page-id "arn:aws:ssm-contacts:us-east-2:682428703967:page/akuam/94ea0c7b-56d9-46c3-b84a-a37c8b067ad3" \
    --accept-type READ \
    --accept-code 425440
```
Perintah ini tidak menghasilkan output  
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [AcceptPage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/accept-page.html)di *Referensi AWS CLI Perintah*. 

### `activate-contact-channel`
<a name="ssm-contacts_ActivateContactChannel_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`activate-contact-channel`.

**AWS CLI**  
**Aktifkan saluran kontak kontak**  
`activate-contact-channel`Contoh berikut mengaktifkan saluran kontak dan membuatnya dapat digunakan sebagai bagian dari insiden.  

```
aws ssm-contacts activate-contact-channel \
    --contact-channel-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d" \
    --activation-code "466136"
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [ActivateContactChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/activate-contact-channel.html)di *Referensi AWS CLI Perintah*. 

### `command-name`
<a name="ssm-contacts_CommandName_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`command-name`.

**AWS CLI**  
**Untuk menghapus kontak**  
`command-name`Contoh berikut menghapus kontak. Kontak tidak lagi dapat dijangkau dari rencana eskalasi apa pun yang merujuk pada mereka.  

```
aws ssm-contacts delete-contact \
    --contact-id "arn:aws:ssm-contacts:us-east-1:682428703967:contact/alejr"
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [CommandName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/command-name.html)di *Referensi AWS CLI Perintah*. 

### `create-contact-channel`
<a name="ssm-contacts_CreateContactChannel_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`create-contact-channel`.

**AWS CLI**  
**Untuk membuat saluran kontak**  
Membuat saluran kontak jenis SMS untuk kontak Akua Mansa. Saluran kontak dapat dibuat dari jenis SMS, EMAIL, atau VOICE.  

```
aws ssm-contacts create-contact-channel \
    --contact-id "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam" \
    --name "akuas sms-test" \
    --type SMS \
    --delivery-address '{"SimpleAddress": "+15005550199"}'
```
Output:  

```
{
    "ContactChannelArn": "arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/02f506b9-ea5d-4764-af89-2daa793ff024"
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [CreateContactChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/create-contact-channel.html)di *Referensi AWS CLI Perintah*. 

### `create-contact`
<a name="ssm-contacts_CreateContact_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`create-contact`.

**AWS CLI**  
**Untuk membuat kontak**  
`create-contact`Contoh berikut membuat kontak di lingkungan Anda dengan rencana kosong. Paket dapat diperbarui setelah membuat saluran kontak. Gunakan create-contact-channel perintah dengan output ARN dari perintah ini. Setelah Anda membuat saluran kontak untuk kontak ini, gunakan pembaruan-kontak untuk memperbarui paket.  

```
aws ssm-contacts create-contact \
    --alias "akuam" \
    --display-name "Akua Mansa" \
    --type PERSONAL \
    --plan '{"Stages": []}'
```
Output:  

```
{
    "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam"
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [CreateContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/create-contact.html)di *Referensi AWS CLI Perintah*. 

### `deactivate-contact-channel`
<a name="ssm-contacts_DeactivateContactChannel_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`deactivate-contact-channel`.

**AWS CLI**  
**Untuk menonaktifkan saluran kontak**  
`deactivate-contact-channel`Contoh berikut menonaktifkan saluran kontak. Menonaktifkan saluran kontak berarti saluran kontak tidak akan lagi dipaging selama insiden terjadi. Anda juga dapat mengaktifkan kembali saluran kontak kapan saja menggunakan `activate-contact-channel` perintah.  

```
aws ssm-contacts deactivate-contact-channel \
    --contact-channel-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d"
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [DeactivateContactChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/deactivate-contact-channel.html)di *Referensi AWS CLI Perintah*. 

### `delete-contact-channel`
<a name="ssm-contacts_DeleteContactChannel_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`delete-contact-channel`.

**AWS CLI**  
**Untuk menghapus saluran kontak**  
`delete-contact-channel`Contoh berikut menghapus saluran kontak. Menghapus saluran kontak memastikan saluran kontak tidak akan diberi halaman selama insiden terjadi.  

```
aws ssm-contacts delete-contact-channel \
    --contact-channel-id "arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/13149bad-52ee-45ea-ae1e-45857f78f9b2"
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [DeleteContactChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/delete-contact-channel.html)di *Referensi AWS CLI Perintah*. 

### `delete-contact`
<a name="ssm-contacts_DeleteContact_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`delete-contact`.

**AWS CLI**  
**Untuk menghapus kontak**  
`delete-contact`Contoh berikut menghapus kontak. Kontak tidak lagi dapat dijangkau dari rencana eskalasi apa pun yang merujuk pada mereka.  

```
aws ssm-contacts delete-contact \
    --contact-id "arn:aws:ssm-contacts:us-east-1:111122223333:contact/alejr"
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [DeleteContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/delete-contact.html)di *Referensi AWS CLI Perintah*. 

### `describe-engagement`
<a name="ssm-contacts_DescribeEngagement_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`describe-engagement`.

**AWS CLI**  
**Untuk menjelaskan detail pertunangan**  
`describe-engagement`Contoh berikut mencantumkan rincian keterlibatan ke kontak atau rencana eskalasi. Subjek dan konten dikirim ke saluran kontak.  

```
aws ssm-contacts describe-engagement \
    --engagement-id "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356"
```
Output:  

```
{
    "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation",
    "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356",
    "Sender": "cli",
    "Subject": "cli-test",
    "Content": "Testing engagements via CLI",
    "PublicSubject": "cli-test",
    "PublicContent": "Testing engagements va CLI",
    "StartTime": "2021-05-18T18:25:41.151000+00:00"
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [DescribeEngagement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/describe-engagement.html)di *Referensi AWS CLI Perintah*. 

### `describe-page`
<a name="ssm-contacts_DescribePage_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`describe-page`.

**AWS CLI**  
**Untuk mencantumkan detail halaman ke saluran kontak**  
`describe-page`Contoh berikut mencantumkan detail halaman ke saluran kontak. Halaman akan mencakup subjek dan konten yang disediakan.  

```
aws ssm-contacts describe-page \
    --page-id "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93"
```
Output:  

```
{
    "PageArn": "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93",
    "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0",
    "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam",
    "Sender": "cli",
    "Subject": "cli-test",
    "Content": "Testing engagements via CLI",
    "PublicSubject": "cli-test",
    "PublicContent": "Testing engagements va CLI",
    "SentTime": "2021-05-18T18:43:29.301000+00:00",
    "ReadTime": "2021-05-18T18:43:55.708000+00:00",
    "DeliveryTime": "2021-05-18T18:43:55.265000+00:00"
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [DescribePage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/describe-page.html)di *Referensi AWS CLI Perintah*. 

### `get-contact-channel`
<a name="ssm-contacts_GetContactChannel_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`get-contact-channel`.

**AWS CLI**  
**Untuk mencantumkan rincian saluran kontak**  
`get-contact-channel`Contoh berikut mencantumkan rincian saluran kontak.  

```
aws ssm-contacts get-contact-channel \
    --contact-channel-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d"
```
Output:  

```
{
    "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam",
    "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d",
    "Name": "akuas sms",
    "Type": "SMS",
    "DeliveryAddress": {
        "SimpleAddress": "+15005550199"
    },
    "ActivationStatus": "ACTIVATED"
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [GetContactChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/get-contact-channel.html)di *Referensi AWS CLI Perintah*. 

### `get-contact-policy`
<a name="ssm-contacts_GetContactPolicy_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`get-contact-policy`.

**AWS CLI**  
**Untuk membuat daftar kebijakan sumber daya kontak**  
`get-contact-policy`Contoh berikut mencantumkan kebijakan sumber daya yang terkait dengan kontak yang ditentukan.  

```
aws ssm-contacts get-contact-policy \
    --contact-arn "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam"
```
Output:  

```
{
    "ContactArn": "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam",
    "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"SharePolicyForDocumentationDralia\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"222233334444\"},\"Action\":[\"ssm-contacts:GetContact\",\"ssm-contacts:StartEngagement\",\"ssm-contacts:DescribeEngagement\",\"ssm-contacts:ListPagesByEngagement\",\"ssm-contacts:StopEngagement\"],\"Resource\":[\"arn:aws:ssm-contacts:*:111122223333:contact/akuam\",\"arn:aws:ssm-contacts:*:111122223333:engagement/akuam/*\"]}]}"
}
```
Untuk informasi selengkapnya, lihat [Bekerja dengan kontak bersama dan rencana respons](https://docs.aws.amazon.com/incident-manager/latest/userguide/sharing.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [GetContactPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/get-contact-policy.html)di *Referensi AWS CLI Perintah*. 

### `get-contact`
<a name="ssm-contacts_GetContact_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`get-contact`.

**AWS CLI**  
**Contoh 1: Untuk mendeskripsikan rencana kontak**  
`get-contact`Contoh berikut menjelaskan kontak.  

```
aws ssm-contacts get-contact \
    --contact-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam"
```
Output:  

```
{
    "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam",
    "Alias": "akuam",
    "DisplayName": "Akua Mansa",
    "Type": "PERSONAL",
    "Plan": {
        "Stages": [
            {
                "DurationInMinutes": 5,
                "Targets": [
                    {
                        "ChannelTargetInfo": {
                            "ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/beb25840-5ac8-4644-95cc-7a8de390fa65",
                            "RetryIntervalInMinutes": 1
                        }
                    }
                ]
            },
            {
                "DurationInMinutes": 5,
                "Targets": [
                    {
                        "ChannelTargetInfo": {
                            "ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/49f3c24d-5f9f-4638-ae25-3f49e04229ad",
                            "RetryIntervalInMinutes": 1
                        }
                    }
                ]
            },
            {
                "DurationInMinutes": 5,
                "Targets": [
                    {
                        "ChannelTargetInfo": {
                            "ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/77d4f447-f619-4954-afff-85551e369c2a",
                            "RetryIntervalInMinutes": 1
                        }
                    }
                ]
            }
        ]
    }
}
```
**Contoh 2: Untuk menggambarkan rencana eskalasi**  
`get-contact`Contoh berikut menjelaskan rencana eskalasi.  

```
aws ssm-contacts get-contact \
--contact-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation"
```
Output:  

```
{
    "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation",
    "Alias": "example_escalation",
    "DisplayName": "Example Escalation",
    "Type": "ESCALATION",
    "Plan": {
        "Stages": [
            {
                "DurationInMinutes": 5,
                "Targets": [
                    {
                        "ContactTargetInfo": {
                            "ContactId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam",
                            "IsEssential": true
                        }
                    }
                ]
            },
            {
                "DurationInMinutes": 5,
                "Targets": [
                    {
                        "ContactTargetInfo": {
                            "ContactId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/alejr",
                            "IsEssential": false
                        }
                    }
                ]
            },
            {
                "DurationInMinutes": 0,
                "Targets": [
                    {
                        "ContactTargetInfo": {
                            "ContactId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/anasi",
                            "IsEssential": false
                        }
                    }
                ]
            }
        ]
    }
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [GetContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/get-contact.html)di *Referensi AWS CLI Perintah*. 

### `list-contact-channels`
<a name="ssm-contacts_ListContactChannels_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-contact-channels`.

**AWS CLI**  
**Untuk membuat daftar saluran kontak kontak kontak**  
`list-contact-channels`Contoh berikut mencantumkan saluran kontak yang tersedia dari kontak yang ditentukan.  

```
aws ssm-contacts list-contact-channels \
    --contact-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam"
```
Output:  

```
{
    [
        {
            "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam",
            "Name": "akuas email",
            "Type": "EMAIL",
            "DeliveryAddress": {
                "SimpleAddress": "akuam@example.com"
            },
            "ActivationStatus": "NOT_ACTIVATED"
        },
        {
            "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d",
            "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam",
            "Name": "akuas sms",
            "Type": "SMS",
            "DeliveryAddress": {
                "SimpleAddress": "+15005550100"
            },
            "ActivationStatus": "ACTIVATED"
        }
    ]
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [ListContactChannels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-contact-channels.html)di *Referensi AWS CLI Perintah*. 

### `list-contacts`
<a name="ssm-contacts_ListContacts_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-contacts`.

**AWS CLI**  
**Untuk membuat daftar semua rencana eskalasi dan kontak**  
`list-contacts`Contoh berikut mencantumkan kontak dan rencana eskalasi di akun Anda.  

```
aws ssm-contacts list-contacts
```
Output:  

```
{
    "Contacts": [
        {
            "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam",
            "Alias": "akuam",
            "DisplayName": "Akua Mansa",
            "Type": "PERSONAL"
        },
        {
            "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/alejr",
            "Alias": "alejr",
            "DisplayName": "Alejandro Rosalez",
            "Type": "PERSONAL"
        },
        {
            "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/anasi",
            "Alias": "anasi",
            "DisplayName": "Ana Carolina Silva",
            "Type": "PERSONAL"
        },
        {
            "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation",
            "Alias": "example_escalation",
            "DisplayName": "Example Escalation",
            "Type": "ESCALATION"
        }
    ]
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [ListContacts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-contacts.html)di *Referensi AWS CLI Perintah*. 

### `list-engagements`
<a name="ssm-contacts_ListEngagements_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-engagements`.

**AWS CLI**  
**Untuk membuat daftar semua keterlibatan**  
`list-engagements`Contoh berikut mencantumkan keterlibatan untuk rencana eskalasi dan kontak. Anda juga dapat membuat daftar keterlibatan untuk satu insiden.  

```
aws ssm-contacts list-engagements
```
Output:  

```
{
    "Engagements": [
        {
            "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/91792571-0b53-4821-9f73-d25d13d9e529",
            "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam",
            "Sender": "cli",
            "StartTime": "2021-05-18T20:37:50.300000+00:00"
        },
        {
            "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0",
            "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam",
            "Sender": "cli",
            "StartTime": "2021-05-18T18:40:26.666000+00:00"
        },
        {
            "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356",
            "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation",
            "Sender": "cli",
            "StartTime": "2021-05-18T18:25:41.151000+00:00"
        },
        {
            "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/607ced0e-e8fa-4ea7-8958-a237b8803f8f",
            "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam",
            "Sender": "cli",
            "StartTime": "2021-05-18T18:20:58.093000+00:00"
        }
    ]
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [ListEngagements](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-engagements.html)di *Referensi AWS CLI Perintah*. 

### `list-page-receipts`
<a name="ssm-contacts_ListPageReceipts_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-page-receipts`.

**AWS CLI**  
**Untuk membuat daftar tanda terima halaman**  
`command-name`Contoh berikut mencantumkan apakah halaman diterima atau tidak oleh kontak.  

```
aws ssm-contacts list-page-receipts \
    --page-id "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/94ea0c7b-56d9-46c3-b84a-a37c8b067ad3"
```
Output:  

```
{
    "Receipts": [
        {
            "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d",
            "ReceiptType": "DELIVERED",
            "ReceiptInfo": "425440",
            "ReceiptTime": "2021-05-18T20:42:57.485000+00:00"
        },
        {
            "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d",
            "ReceiptType": "READ",
            "ReceiptInfo": "425440",
            "ReceiptTime": "2021-05-18T20:42:57.907000+00:00"
        },
        {
            "ContactChannelArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d",
            "ReceiptType": "SENT",
            "ReceiptInfo": "SM6656c19132f1465f9c9c1123a5dde7c9",
            "ReceiptTime": "2021-05-18T20:40:52.962000+00:00"
        }
    ]
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [ListPageReceipts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-page-receipts.html)di *Referensi AWS CLI Perintah*. 

### `list-pages-by-contact`
<a name="ssm-contacts_ListPagesByContact_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-pages-by-contact`.

**AWS CLI**  
**Untuk daftar halaman dengan kontak**  
`list-pages-by-contact`Contoh berikut mencantumkan semua halaman ke kontak yang ditentukan.  

```
aws ssm-contacts list-pages-by-contact \
    --contact-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam"
```
Output:  

```
{
    "Pages": [
        {
            "PageArn": "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93",
            "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0",
            "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam",
            "Sender": "cli",
            "SentTime": "2021-05-18T18:43:29.301000+00:00",
            "DeliveryTime": "2021-05-18T18:43:55.265000+00:00",
            "ReadTime": "2021-05-18T18:43:55.708000+00:00"
        }
    ]
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [ListPagesByContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-pages-by-contact.html)di *Referensi AWS CLI Perintah*. 

### `list-pages-by-engagement`
<a name="ssm-contacts_ListPagesByEngagement_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`list-pages-by-engagement`.

**AWS CLI**  
**Untuk daftar halaman untuk menghubungi saluran dimulai dari keterlibatan.**  
`list-pages-by-engagement`Contoh berikut mencantumkan halaman yang terjadi saat melibatkan rencana keterlibatan yang ditentukan.  

```
aws ssm-contacts list-pages-by-engagement \
    --engagement-id "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0"
```
Output:  

```
{
    "Pages": [
        {
            "PageArn": "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93",
            "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0",
            "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam",
            "Sender": "cli",
            "SentTime": "2021-05-18T18:40:27.245000+00:00"
        }
    ]
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [ListPagesByEngagement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-pages-by-engagement.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`list-tags-for-resource`.

**AWS CLI**  
**Untuk mencantumkan tag untuk kontak**  
`list-tags-for-resource`Contoh berikut mencantumkan tag kontak yang ditentukan.  

```
aws ssm-contacts list-tags-for-resource \
    --resource-arn "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam"
```
Output:  

```
{
    "Tags": [
        {
            "Key": "group1",
            "Value": "1"
        }
    ]
}
```
Untuk informasi selengkapnya, lihat [Menandai](https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/list-tags-for-resource.html)di *Referensi AWS CLI Perintah*. 

### `put-contact-policy`
<a name="ssm-contacts_PutContactPolicy_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`put-contact-policy`.

**AWS CLI**  
**Untuk berbagi kontak dan keterlibatan**  
`put-contact-policy`Contoh berikut menambahkan kebijakan sumber daya ke kontak Akua yang berbagi kontak dan keterlibatan terkait dengan kepala sekolah.  

```
aws ssm-contacts put-contact-policy \
    --contact-arn "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam" \
    --policy "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"ExampleResourcePolicy\",\"Action\":[\"ssm-contacts:GetContact\",\"ssm-contacts:StartEngagement\",\"ssm-contacts:DescribeEngagement\",\"ssm-contacts:ListPagesByEngagement\",\"ssm-contacts:StopEngagement\"],\"Principal\":{\"AWS\":\"222233334444\"},\"Effect\":\"Allow\",\"Resource\":[\"arn:aws:ssm-contacts:*:111122223333:contact\/akuam\",\"arn:aws:ssm-contacts:*:111122223333:engagement\/akuam\/*\"]}]}"
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Bekerja dengan kontak bersama dan rencana respons](https://docs.aws.amazon.com/incident-manager/latest/userguide/sharing.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [PutContactPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/put-contact-policy.html)di *Referensi AWS CLI Perintah*. 

### `send-activation-code`
<a name="ssm-contacts_SendActivationCode_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`send-activation-code`.

**AWS CLI**  
**Untuk mengirim kode aktivasi**  
`send-activation-code`Contoh berikut mengirimkan kode aktivasi dan pesan ke saluran kontak yang ditentukan.  

```
aws ssm-contacts send-activation-code \
    --contact-channel-id "arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/8ddae2d1-12c8-4e45-b852-c8587266c400"
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [SendActivationCode](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/send-activation-code.html)di *Referensi AWS CLI Perintah*. 

### `start-engagement`
<a name="ssm-contacts_StartEngagement_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`start-engagement`.

**AWS CLI**  
**Contoh 1: Untuk halaman saluran kontak kontak**  
`start-engagement`Halaman-halaman berikut menghubungi saluran kontak. Pengirim, subjek, subjek publik, dan konten publik semuanya bebas dari bidang. Manajer Insiden mengirimkan subjek dan konten ke saluran kontak VOICE atau EMAIL yang disediakan. Manajer Insiden mengirimkan subjek publik dan konten publik ke saluran kontak SMS yang disediakan. Pengirim digunakan untuk melacak siapa yang memulai keterlibatan.  

```
aws ssm-contacts start-engagement \
    --contact-id  "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam" \
    --sender "cli" \
    --subject "cli-test" \
    --content "Testing engagements via CLI" \
    --public-subject "cli-test" \
    --public-content "Testing engagements va CLI"
```
Output:  

```
{
    "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/607ced0e-e8fa-4ea7-8958-a237b8803f8f"
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
**Contoh 2: Untuk halaman kontak dalam rencana eskalasi yang disediakan.**  
Berikut ini `start-engagement` melibatkan kontak melalui rencana eskalasi. Setiap kontak diberi halaman sesuai dengan rencana pertunangan mereka.  

```
aws ssm-contacts start-engagement \
    --contact-id  "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation" \
    --sender "cli" \
    --subject "cli-test" \
    --content "Testing engagements via CLI" \
    --public-subject "cli-test" \
    --public-content "Testing engagements va CLI"
```
Output:  

```
{
    "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356"
}
```
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [StartEngagement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/start-engagement.html)di *Referensi AWS CLI Perintah*. 

### `stop-engagement`
<a name="ssm-contacts_StopEngagement_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`stop-engagement`.

**AWS CLI**  
**Untuk menghentikan pertunangan**  
`stop-engagement`Contoh berikut menghentikan keterlibatan dari paging kontak lebih lanjut dan saluran kontak.  

```
aws ssm-contacts stop-engagement \
    --engagement-id "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356"
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [StopEngagement](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/stop-engagement.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`tag-resource`.

**AWS CLI**  
**Untuk menandai kontak**  
`tag-resource`Contoh berikut menandai kontak tertentu dengan pasangan nilai kunci tag yang disediakan.  

```
aws ssm-contacts tag-resource \
    --resource-arn "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam" \
    --tags '[{"Key":"group1","Value":"1"}]'
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Menandai](https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/tag-resource.html)di *Referensi AWS CLI Perintah*. 

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

Contoh kode berikut menunjukkan cara menggunakan`untag-resource`.

**AWS CLI**  
**Untuk menghapus tag dari kontak**  
`untag-resource`Contoh berikut menghapus tag group1 dari kontak yang ditentukan.  

```
aws ssm-contacts untag-resource \
    --resource-arn "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam" \
    --tag-keys "group1"
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Menandai](https://docs.aws.amazon.com/incident-manager/latest/userguide/tagging.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/untag-resource.html)di *Referensi AWS CLI Perintah*. 

### `update-contact-channel`
<a name="ssm-contacts_UpdateContactChannel_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`update-contact-channel`.

**AWS CLI**  
**Untuk memperbarui saluran kontak**  
`update-contact-channel`Contoh berikut memperbarui nama dan alamat pengiriman saluran kontak.  

```
aws ssm-contacts update-contact-channel \
    --contact-channel-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/49f3c24d-5f9f-4638-ae25-3f49e04229ad" \
    --name "akuas voice channel" \
    --delivery-address '{"SimpleAddress": "+15005550198"}'
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [UpdateContactChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/update-contact-channel.html)di *Referensi AWS CLI Perintah*. 

### `update-contact`
<a name="ssm-contacts_UpdateContact_cli_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`update-contact`.

**AWS CLI**  
**Untuk memperbarui rencana keterlibatan kontak**  
`update-contact`Contoh berikut memperbarui rencana keterlibatan kontak Akua untuk memasukkan tiga jenis saluran kontak. Ini dilakukan setelah membuat saluran kontak untuk Akua.  

```
aws ssm-contacts update-contact \
    --contact-id "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam" \
    --plan '{"Stages": [{"DurationInMinutes": 5, "Targets": [{"ChannelTargetInfo": {"ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/beb25840-5ac8-4644-95cc-7a8de390fa65","RetryIntervalInMinutes": 1 }}]}, {"DurationInMinutes": 5, "Targets": [{"ChannelTargetInfo":{"ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/49f3c24d-5f9f-4638-ae25-3f49e04229ad", "RetryIntervalInMinutes": 1}}]}, {"DurationInMinutes": 5, "Targets": [{"ChannelTargetInfo": {"ContactChannelId": "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/77d4f447-f619-4954-afff-85551e369c2a","RetryIntervalInMinutes": 1 }}]}]}'
```
Perintah ini tidak menghasilkan output.  
Untuk informasi selengkapnya, lihat [Kontak](https://docs.aws.amazon.com/incident-manager/latest/userguide/contacts.html) di *Panduan Pengguna Manajer Insiden*.  
+  Untuk detail API, lihat [UpdateContact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm-contacts/update-contact.html)di *Referensi AWS CLI Perintah*. 