를 사용한 Incident Manager Contacts 예제 AWS CLI - AWS Command Line Interface

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 사용한 Incident Manager Contacts 예제 AWS CLI

다음 코드 예제에서는 Incident Manager Contacts와 AWS Command Line Interface 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

다음 코드 예시에서는 accept-page을 사용하는 방법을 보여 줍니다.

AWS CLI

및 참여 중에 페이지를 수락하려면

다음 accept-page 예제에서는 고객 응대 채널로 전송된 수락 코드를 사용하여 페이지를 수락합니다.

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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조AcceptPage의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 activate-contact-channel을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처의 연락 채널 활성화

다음 activate-contact-channel 예제에서는 연락 채널을 활성화하고 인시던트의 일부로 사용할 수 있도록 합니다.

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"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

다음 코드 예시에서는 command-name을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처를 삭제하려면

다음 command-name 예제에서는 연락처를 삭제합니다. 연락은 더 이상 해당 연락과 관련된 에스컬레이션 계획에서 연결할 수 없습니다.

aws ssm-contacts delete-contact \ --contact-id "arn:aws:ssm-contacts:us-east-1:682428703967:contact/alejr"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조CommandName의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 create-contact-channel을 사용하는 방법을 보여 줍니다.

AWS CLI

고객 응대 채널을 생성하려면

연락 Akua Mansa에 SMS 대한 유형의 연락 채널을 생성합니다. 연락 채널은 유형 SMS, EMAIL또는 로 생성할 수 있습니다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"}'

출력:

{ "ContactChannelArn": "arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/02f506b9-ea5d-4764-af89-2daa793ff024" }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

다음 코드 예시에서는 create-contact을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처를 생성하려면

다음 create-contact 예제에서는 빈 계획으로 환경에 연락처를 생성합니다. 연락 채널을 생성한 후 계획을 업데이트할 수 있습니다. ARN 이 명령의 출력과 함께 명령을 사용합니다 create-contact-channel. 이 연락에 대한 연락 채널을 생성한 후 업데이트 연락을 사용하여 계획을 업데이트합니다.

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

출력:

{ "ContactArn": "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam" }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조CreateContact의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 deactivate-contact-channel을 사용하는 방법을 보여 줍니다.

AWS CLI

연락 채널을 비활성화하려면

다음 deactivate-contact-channel 예제에서는 연락 채널을 비활성화합니다. 고객 응대 채널을 비활성화하면 인시던트 발생 시 고객 응대 채널이 더 이상 호출되지 않습니다. 언제든지 activate-contact-channel 명령을 사용하여 연락 채널을 다시 활성화할 수도 있습니다.

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"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

다음 코드 예시에서는 delete-contact-channel을 사용하는 방법을 보여 줍니다.

AWS CLI

연락 채널을 삭제하려면

다음 delete-contact-channel 예제에서는 연락 채널을 삭제합니다. 연락 채널을 삭제하면 인시던트 발생 시 연락 채널이 호출되지 않습니다.

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"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

다음 코드 예시에서는 delete-contact을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처를 삭제하려면

다음 delete-contact 예제에서는 연락처를 삭제합니다. 연락은 더 이상 해당 연락과 관련된 에스컬레이션 계획에서 연결할 수 없습니다.

aws ssm-contacts delete-contact \ --contact-id "arn:aws:ssm-contacts:us-east-1:111122223333:contact/alejr"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조DeleteContact의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-engagement을 사용하는 방법을 보여 줍니다.

AWS CLI

참여의 세부 정보를 설명하려면

다음 describe-engagement 예제에서는 고객 응대 또는 에스컬레이션 계획에 대한 참여 세부 정보를 나열합니다. 주제와 콘텐츠가 연락 채널로 전송됩니다.

aws ssm-contacts describe-engagement \ --engagement-id "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", "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" }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조DescribeEngagement의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-page을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처 채널에 대한 페이지 세부 정보를 나열하려면

다음 describe-page 예제에서는 연락 채널에 대한 페이지의 세부 정보를 나열합니다. 페이지에는 제공된 주제와 콘텐츠가 포함됩니다.

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

출력:

{ "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" }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조DescribePage의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-contact-channel을 사용하는 방법을 보여 줍니다.

AWS CLI

연락 채널의 세부 정보를 나열하려면

다음 get-contact-channel 예제에서는 연락 채널의 세부 정보를 나열합니다.

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"

출력:

{ "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" }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조GetContactChannel의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-contact-policy을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처의 리소스 정책을 나열하려면

다음 get-contact-policy 예제에서는 지정된 연락처와 연결된 리소스 정책을 나열합니다.

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

출력:

{ "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/*\"]}]}" }

자세한 내용은 Incident Manager 사용 설명서공유 연락처 및 대응 계획 작업을 참조하세요.

  • 자세한 API 내용은 명령 참조GetContactPolicy의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-contact을 사용하는 방법을 보여 줍니다.

AWS CLI

예제 1: 고객 응대 계획 설명

다음 get-contact 예제에서는 연락처에 대해 설명합니다.

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

출력:

{ "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 } } ] } ] } }

예제 2: 에스컬레이션 계획 설명

다음 get-contact 예제에서는 에스컬레이션 계획을 설명합니다.

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

출력:

{ "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 } } ] } ] } }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조GetContact의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-contact-channels을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처의 연락처 채널을 나열하려면

다음 list-contact-channels 예제에서는 지정된 연락의 사용 가능한 연락 채널을 나열합니다.

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

출력:

{ [ { "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" } ] }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조ListContactChannels의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-contacts을 사용하는 방법을 보여 줍니다.

AWS CLI

모든 에스컬레이션 계획 및 연락처를 나열하려면

다음 list-contacts 예제에서는 계정의 연락 및 에스컬레이션 계획을 나열합니다.

aws ssm-contacts list-contacts

출력:

{ "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" } ] }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조ListContacts의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-engagements을 사용하는 방법을 보여 줍니다.

AWS CLI

모든 참여를 나열하려면

다음 list-engagements 예제에서는 에스컬레이션 계획 및 연락처에 대한 참여를 나열합니다. 단일 인시던트에 대한 참여를 나열할 수도 있습니다.

aws ssm-contacts list-engagements

출력:

{ "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" } ] }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조ListEngagements의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-page-receipts을 사용하는 방법을 보여 줍니다.

AWS CLI

페이지 수신을 나열하려면

다음 command-name 예제에서는 연락처가 페이지를 수신했는지 여부를 나열합니다.

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

출력:

{ "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" } ] }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조ListPageReceipts의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-pages-by-contact을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처별로 페이지를 나열하려면

다음 list-pages-by-contact 예제에서는 지정된 연락처의 모든 페이지를 나열합니다.

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

출력:

{ "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" } ] }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조ListPagesByContact의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-pages-by-engagement을 사용하는 방법을 보여 줍니다.

AWS CLI

참여에서 시작된 연락 채널 페이지를 나열합니다.

다음 list-pages-by-engagement 예제에서는 정의된 참여 계획을 사용하는 동안 발생한 페이지를 나열합니다.

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

출력:

{ "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" } ] }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

다음 코드 예시에서는 list-tags-for-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처의 태그를 나열하려면

다음 list-tags-for-resource 예제에서는 지정된 연락처의 태그를 나열합니다.

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

출력:

{ "Tags": [ { "Key": "group1", "Value": "1" } ] }

자세한 내용은 Incident Manager 사용 설명서태그 지정을 참조하세요.

  • 자세한 API 내용은 명령 참조ListTagsForResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 put-contact-policy을 사용하는 방법을 보여 줍니다.

AWS CLI

고객 응대 및 참여를 공유하려면

다음 put-contact-policy 예제에서는 보안 주체와 연락처 및 관련 참여를 공유하는 리소스 정책을 연락처 Akua에 추가합니다.

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\/*\"]}]}"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서공유 연락처 및 대응 계획 작업을 참조하세요.

  • 자세한 API 내용은 명령 참조PutContactPolicy의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 send-activation-code을 사용하는 방법을 보여 줍니다.

AWS CLI

활성화 코드를 보내려면

다음 send-activation-code 예제에서는 활성화 코드와 메시지를 지정된 연락 채널로 보냅니다.

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"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조SendActivationCode의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 start-engagement을 사용하는 방법을 보여 줍니다.

AWS CLI

예제 1: 연락처의 연락 채널을 호출하려면

다음 start-engagement 페이지는 연락처의 연락처 채널입니다. 발신자, 제목, 퍼블릭 주제 및 퍼블릭 콘텐츠에는 필드가 없습니다. Incident Manager는 제공된 채널 VOICE 또는 EMAIL 연락 채널로 주제와 콘텐츠를 전송합니다. Incident Manager는 제공된 SMS 연락 채널로 퍼블릭 주제 및 퍼블릭 콘텐츠를 전송합니다. 발신자는 누가 참여를 시작했는지 추적하는 데 사용됩니다.

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"

출력:

{ "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/607ced0e-e8fa-4ea7-8958-a237b8803f8f" }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

예제 2: 제공된 에스컬레이션 계획에서 연락처를 호출합니다.

다음은 에스컬레이션 계획을 통해 고객 응대에 start-engagement 관여합니다. 각 연락처는 참여 계획에 따라 페이지가 지정됩니다.

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"

출력:

{ "EngagementArn": "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356" }

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조StartEngagement의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 stop-engagement을 사용하는 방법을 보여 줍니다.

AWS CLI

참여를 중지하려면

다음 stop-engagement 예제에서는 참여로 인해 추가 연락 및 연락 채널 페이징이 중지됩니다.

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

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조StopEngagement의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 tag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처에 태그를 지정하려면

다음 tag-resource 예제에서는 지정된 연락처에 제공된 태그 키 값 페어를 태그 지정합니다.

aws ssm-contacts tag-resource \ --resource-arn "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam" \ --tags '[{"Key":"group1","Value":"1"}]'

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서태그 지정을 참조하세요.

  • 자세한 API 내용은 명령 참조TagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 untag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처에서 태그를 제거하려면

다음 untag-resource 예제에서는 지정된 연락처에서 group1 태그를 제거합니다.

aws ssm-contacts untag-resource \ --resource-arn "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam" \ --tag-keys "group1"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서태그 지정을 참조하세요.

  • 자세한 API 내용은 명령 참조UntagResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 update-contact-channel을 사용하는 방법을 보여 줍니다.

AWS CLI

연락 채널을 업데이트하려면

다음 update-contact-channel 예제에서는 연락 채널의 이름과 전송 주소를 업데이트합니다.

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"}'

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

다음 코드 예시에서는 update-contact을 사용하는 방법을 보여 줍니다.

AWS CLI

연락 참여 계획을 업데이트하려면

다음 update-contact 예제에서는 세 가지 유형의 연락 채널을 포함하도록 연락 Akua의 참여 계획을 업데이트합니다. 이는 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 }}]}]}'

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Incident Manager 사용 설명서연락처를 참조하세요.

  • 자세한 API 내용은 명령 참조UpdateContact의 섹션을 참조하세요. AWS CLI