Contoh Kontak Manajer Insiden menggunakan AWS CLI - AWS Command Line Interface
Tindakan

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

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

Tindakan adalah 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.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanaccept-page.

AWS CLI

Untuk menerima halaman selama dan keterlibatan

accept-pageContoh 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 di Panduan Pengguna Manajer Insiden.

  • Untuk API detailnya, lihat AcceptPagedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanactivate-contact-channel.

AWS CLI

Aktifkan saluran kontak kontak

activate-contact-channelContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakancommand-name.

AWS CLI

Untuk menghapus kontak

command-nameContoh 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 di Panduan Pengguna Manajer Insiden.

  • Untuk API detailnya, lihat CommandNamedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-contact-channel.

AWS CLI

Untuk membuat saluran kontak

Membuat saluran kontak tipe SMS untuk kontak Akua Mansa. Saluran kontak dapat dibuat dari jenisSMS,EMAIL, atauVOICE.

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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakancreate-contact.

AWS CLI

Untuk membuat kontak

create-contactContoh 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 di Panduan Pengguna Manajer Insiden.

  • Untuk API detailnya, lihat CreateContactdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandeactivate-contact-channel.

AWS CLI

Untuk menonaktifkan saluran kontak

deactivate-contact-channelContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakandelete-contact-channel.

AWS CLI

Untuk menghapus saluran kontak

delete-contact-channelContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakandelete-contact.

AWS CLI

Untuk menghapus kontak

delete-contactContoh 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 di Panduan Pengguna Manajer Insiden.

  • Untuk API detailnya, lihat DeleteContactdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-engagement.

AWS CLI

Untuk menjelaskan detail pertunangan

describe-engagementContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakandescribe-page.

AWS CLI

Untuk mencantumkan detail halaman ke saluran kontak

describe-pageContoh 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 di Panduan Pengguna Manajer Insiden.

  • Untuk API detailnya, lihat DescribePagedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-contact-channel.

AWS CLI

Untuk mencantumkan rincian saluran kontak

get-contact-channelContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanget-contact-policy.

AWS CLI

Untuk membuat daftar kebijakan sumber daya kontak

get-contact-policyContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanget-contact.

AWS CLI

Contoh 1: Untuk mendeskripsikan rencana kontak

get-contactContoh 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-contactContoh 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 di Panduan Pengguna Manajer Insiden.

  • Untuk API detailnya, lihat GetContactdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-contact-channels.

AWS CLI

Untuk membuat daftar saluran kontak kontak kontak

list-contact-channelsContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanlist-contacts.

AWS CLI

Untuk membuat daftar semua rencana eskalasi dan kontak

list-contactsContoh 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 di Panduan Pengguna Manajer Insiden.

  • Untuk API detailnya, lihat ListContactsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-engagements.

AWS CLI

Untuk membuat daftar semua keterlibatan

list-engagementsContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanlist-page-receipts.

AWS CLI

Untuk membuat daftar tanda terima halaman

command-nameContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanlist-pages-by-contact.

AWS CLI

Untuk daftar halaman dengan kontak

list-pages-by-contactContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanlist-pages-by-engagement.

AWS CLI

Untuk daftar halaman untuk menghubungi saluran dimulai dari keterlibatan.

list-pages-by-engagementContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk mencantumkan tag untuk kontak

list-tags-for-resourceContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanput-contact-policy.

AWS CLI

Untuk berbagi kontak dan keterlibatan

put-contact-policyContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakansend-activation-code.

AWS CLI

Untuk mengirim kode aktivasi

send-activation-codeContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanstart-engagement.

AWS CLI

Contoh 1: Untuk halaman saluran kontak kontak

start-engagementHalaman-halaman berikut menghubungi saluran kontak. Pengirim, subjek, subjek publik, dan konten publik semuanya bebas dari bidang. Manajer Insiden mengirimkan subjek dan konten ke saluran yang disediakan VOICE atau EMAIL kontak. Manajer Insiden mengirimkan subjek publik dan konten publik ke saluran kontak yang disediakan. SMS 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 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanstop-engagement.

AWS CLI

Untuk menghentikan pertunangan

stop-engagementContoh 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 di Panduan Pengguna Manajer Insiden.

  • Untuk API detailnya, lihat StopEngagementdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menandai kontak

tag-resourceContoh 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 di Panduan Pengguna Manajer Insiden.

  • Untuk API detailnya, lihat TagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari kontak

untag-resourceContoh 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 di Panduan Pengguna Manajer Insiden.

  • Untuk API detailnya, lihat UntagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-contact-channel.

AWS CLI

Untuk memperbarui saluran kontak

update-contact-channelContoh 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 di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanupdate-contact.

AWS CLI

Untuk memperbarui rencana keterlibatan kontak

update-contactContoh 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 di Panduan Pengguna Manajer Insiden.

  • Untuk API detailnya, lihat UpdateContactdi Referensi AWS CLI Perintah.