View a markdown version of this page

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

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

  • Untuk detail API, lihat AcceptPage di Refer AWS CLI ensi 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 Kon tak di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakancommand-name.

AWS CLI

Untuk menghapus kontak

command-nameContoh berikut menghapus kontak. Kontak tidak akan 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 Kon tak di Panduan Pengguna Manajer Insiden.

  • Untuk detail API, lihat CommandName di Refer AWS CLI ensi 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 jenis SMS, EMAIL, atau SUARA.

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 Kon tak 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 paket kosong. Paket dapat diperbarui setelah membuat saluran kontak. Gunakan perintah create-contact-channel dengan output ARN dari perintah ini. Setelah Anda membuat saluran kontak untuk kontak ini, gunakan update-contact 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 Kon tak di Panduan Pengguna Manajer Insiden.

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 Kon tak 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 dipaging selama insiden.

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

Contoh kode berikut menunjukkan cara menggunakandelete-contact.

AWS CLI

Untuk menghapus kontak

delete-contactContoh berikut menghapus kontak. Kontak tidak akan 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 Kon tak di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakandescribe-engagement.

AWS CLI

Untuk menjelaskan detail pertunangan

describe-engagementContoh berikut mencantumkan detail 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 Kon tak 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 Kon tak di Panduan Pengguna Manajer Insiden.

  • Untuk detail API, lihat DescribePage di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-contact-channel.

AWS CLI

Untuk mencantumkan detail saluran kontak

get-contact-channelContoh berikut mencantumkan detail 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 Kon tak di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanget-contact-policy.

AWS CLI

Untuk mencantumkan 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 Bek erja dengan kontak bersama dan rencana respons di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanget-contact.

AWS CLI

Contoh 1: Untuk menjelaskan 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 Kon tak di Panduan Pengguna Manajer Insiden.

  • Untuk detail API, lihat GetContact di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-contact-channels.

AWS CLI

Untuk membuat daftar saluran kontak dari 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 Kon tak 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 Kon tak di Panduan Pengguna Manajer Insiden.

  • Untuk detail API, lihat ListContacts di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-engagements.

AWS CLI

Untuk daftar semua keterlibatan

list-engagementsContoh berikut mencantumkan keterlibatan dengan 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 Kon tak di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanlist-page-receipts.

AWS CLI

Untuk mencantumkan 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 Kon tak di Panduan Pengguna Manajer Insiden.

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

AWS CLI

Untuk daftar halaman berdasarkan 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 Kon tak di Panduan Pengguna Manajer Insiden.

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

AWS CLI

Untuk membuat daftar halaman untuk saluran kontak 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 Kon tak 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 Bek erja 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 Kon tak di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanstart-engagement.

AWS CLI

Contoh 1: Untuk mem-halaman saluran kontak kontak

start-engagementHalaman berikut menghubungi saluran kontak. Pengirim, subjek, subjek publik, dan konten publik semuanya bebas dari bidang. Incident Manager 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 Kon tak di Panduan Pengguna Manajer Insiden.

Contoh 2: Untuk mem-halaman kontak dalam rencana eskalasi yang disediakan.

Berikut ini start-engagement melibatkan kontak melalui rencana eskalasi. Setiap kontak dipaging sesuai dengan rencana keterlibatan 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 Kon tak di Panduan Pengguna Manajer Insiden.

Contoh kode berikut menunjukkan cara menggunakanstop-engagement.

AWS CLI

Untuk menghentikan pertunangan

stop-engagementContoh berikut menghentikan interaksi dari paging kontak dan saluran kontak lebih lanjut.

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

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 detail API, lihat TagResource di Refer AWS CLI ensi 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.

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