aws-sdk-ssmcontacts 1.5.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e2d2ca32be7a97738be82c6e02f82b1443cec91124b679f5b5db3920f00429c
-  data.tar.gz: ecd0e99143a4aa6b7d150b7fa27d2e479ce82796fa267b4a26936d3a8a16d97d
+  metadata.gz: f0902c86253ae3633f855d0575589fb0463a28b49ef2836439ae302e7346a8a4
+  data.tar.gz: ba75a080ea06ff84eec02d98c12e1a1703196106d45180bfd315e589a7aa44eb
 SHA512:
-  metadata.gz: 05ea4bfdfb065775a019b091f85d8e8faf5cafa829d2e1277b05d819c0040c2bfb29e699d665f798420e132fae3d449683c66c7d3931ec94729d101539e42fe6
-  data.tar.gz: 9fc012c0ff85a22b02202fe9ef8f8deddff032773645fb9710f89e5146d74824cf76110e59e3ae51d87b2d90b39b8a08d1231c0586d3763e38ebc4efad43c89c
+  metadata.gz: aa54a2cd5d3f48d2554772296b9be569e330c14b677aa05f3f5c5db0f12c040c6df837f62efd6f91beb262d4e5461cf61afeab9f0d90b00e1e83a0d4e44398bd
+  data.tar.gz: 4c634aa0eaec6d9bd43adbc42122bac64f78950c696638b3dcfcd0ba7db09cd2f3d66d716762d7d77fc04e5756a9cf81f02b4105b9d2aa84ab96b8978424ca3a

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.9.0 (2021-11-04)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.8.0 (2021-10-18)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.7.0 (2021-09-07)
+------------------
+
+* Feature - Added SDK examples for SSM-Contacts.
+
+1.6.0 (2021-09-01)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.5.0 (2021-08-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.5.0
+1.9.0

data/lib/aws-sdk-ssmcontacts/client.rb

@@ -285,6 +285,15 @@ module Aws::SSMContacts
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Boolean] :use_dualstack_endpoint
+    #     When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
+    #     will be used if available.
+    #
+    #   @option options [Boolean] :use_fips_endpoint
+    #     When set to `true`, fips compatible endpoints will be used if available.
+    #     When a `fips` region is used, the region is normalized and this config
+    #     is set to `true`.
+    #
     #   @option options [Boolean] :validate_params (true)
     #     When `true`, request parameters are validated before
     #     sending the request.
@@ -369,6 +378,21 @@ module Aws::SSMContacts
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To accept a page during and engagement
+    #
+    #   # The following accept-page operation uses an accept code sent to the contact channel to accept a page.
+    #
+    #   resp = client.accept_page({
+    #     accept_code: "425440", 
+    #     accept_type: "READ", 
+    #     page_id: "arn:aws:ssm-contacts:us-east-2:682428703967:page/akuam/94ea0c7b-56d9-46c3-b84a-a37c8b067ad3", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.accept_page({
@@ -401,6 +425,20 @@ module Aws::SSMContacts
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: Activate a contact's contact channel
+    #
+    #   # The following activate-contact-channel example activates a contact channel and makes it usable as part of an incident.
+    #
+    #   resp = client.activate_contact_channel({
+    #     activation_code: "466136", 
+    #     contact_channel_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.activate_contact_channel({
@@ -442,7 +480,7 @@ module Aws::SSMContacts
     #   first Region of your replication set.
     #
     # @option params [String] :idempotency_token
-    #   A token ensuring that the action is called only once with the
+    #   A token ensuring that the operation is called only once with the
     #   specified details.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -452,6 +490,28 @@ module Aws::SSMContacts
     #
     #   * {Types::CreateContactResult#contact_arn #contact_arn} => String
     #
+    #
+    # @example Example: To create a contact
+    #
+    #   # The following create-contact example creates a contact in your environment with a blank plan. The plan can be updated
+    #   # after creating contact channels. Use the create-contact-channel operation with the output ARN of this command. After you
+    #   # have created contact channels for this contact use update-contact to update the plan.
+    #
+    #   resp = client.create_contact({
+    #     alias: "akuam", 
+    #     display_name: "Akua Mansa", 
+    #     plan: {
+    #       stages: [
+    #       ], 
+    #     }, 
+    #     type: "PERSONAL", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_contact({
@@ -535,7 +595,7 @@ module Aws::SSMContacts
     #   until it has been activated.
     #
     # @option params [String] :idempotency_token
-    #   A token ensuring that the action is called only once with the
+    #   A token ensuring that the operation is called only once with the
     #   specified details.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -545,6 +605,26 @@ module Aws::SSMContacts
     #
     #   * {Types::CreateContactChannelResult#contact_channel_arn #contact_channel_arn} => String
     #
+    #
+    # @example Example: To create a contact channel
+    #
+    #   # Creates a contact channel of type SMS for the contact Akua Mansa. Contact channels can be created of type SMS, EMAIL, or
+    #   # VOICE.
+    #
+    #   resp = client.create_contact_channel({
+    #     contact_id: "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam", 
+    #     delivery_address: {
+    #       simple_address: "+15005550199", 
+    #     }, 
+    #     name: "akuas sms-test", 
+    #     type: "SMS", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     contact_channel_arn: "arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/02f506b9-ea5d-4764-af89-2daa793ff024", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_contact_channel({
@@ -580,6 +660,21 @@ module Aws::SSMContacts
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To deactivate a contact channel
+    #
+    #   # The following ``deactivate-contact-channel`` example deactivates a contact channel. Deactivating a contact channel means
+    #   # the contact channel will no longer be paged during an incident. You can also reactivate a contact channel at any time
+    #   # using the activate-contact-channel operation.
+    #
+    #   resp = client.deactivate_contact_channel({
+    #     contact_channel_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.deactivate_contact_channel({
@@ -606,6 +701,20 @@ module Aws::SSMContacts
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To delete a contact
+    #
+    #   # The following delete-contact example deletes a contact. The contact will no longer be reachable from any escalation plan
+    #   # that refers to them.
+    #
+    #   resp = client.delete_contact({
+    #     contact_id: "arn:aws:ssm-contacts:us-east-1:111122223333:contact/alejr", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_contact({
@@ -632,6 +741,20 @@ module Aws::SSMContacts
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To delete a contact channel
+    #
+    #   # The following delete-contact-channel example deletes a contact channel. Deleting a contact channel ensures the contact
+    #   # channel will not be paged during an incident.
+    #
+    #   resp = client.delete_contact_channel({
+    #     contact_channel_id: "arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/13149bad-52ee-45ea-ae1e-45857f78f9b2", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_contact_channel({
@@ -668,6 +791,28 @@ module Aws::SSMContacts
     #   * {Types::DescribeEngagementResult#start_time #start_time} => Time
     #   * {Types::DescribeEngagementResult#stop_time #stop_time} => Time
     #
+    #
+    # @example Example: To describe the details of an engagement
+    #
+    #   # The following describe-engagement example lists the details of an engagement to a contact or escalation plan. The
+    #   # subject and content are sent to the contact channels.
+    #
+    #   resp = client.describe_engagement({
+    #     engagement_id: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", 
+    #     content: "Testing engagements", 
+    #     engagement_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356", 
+    #     public_content: "Testing engagements", 
+    #     public_subject: "test", 
+    #     sender: "tester", 
+    #     start_time: Time.parse("$2021-05-18T18:25:41.151000+00:00"), 
+    #     subject: "test", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_engagement({
@@ -716,6 +861,31 @@ module Aws::SSMContacts
     #   * {Types::DescribePageResult#read_time #read_time} => Time
     #   * {Types::DescribePageResult#delivery_time #delivery_time} => Time
     #
+    #
+    # @example Example: To list the details of a page to a contact channel
+    #
+    #   # The following describe-page example lists details of a page to a contact channel. The page will include the subject and
+    #   # content provided.
+    #
+    #   resp = client.describe_page({
+    #     page_id: "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #     content: "Testing engagements", 
+    #     delivery_time: Time.parse("2021-05-18T18:43:55.265000+00:00"), 
+    #     engagement_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", 
+    #     page_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93", 
+    #     public_content: "Testing engagements", 
+    #     public_subject: "test", 
+    #     read_time: Time.parse("2021-05-18T18:43:55.708000+00:00"), 
+    #     sender: "tester", 
+    #     sent_time: Time.parse("2021-05-18T18:43:29.301000+00:00"), 
+    #     subject: "test", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_page({
@@ -759,6 +929,113 @@ module Aws::SSMContacts
     #   * {Types::GetContactResult#type #type} => String
     #   * {Types::GetContactResult#plan #plan} => Types::Plan
     #
+    #
+    # @example Example: Example 1: To describe a contact plan
+    #
+    #   # The following get-contact example describes a contact.
+    #
+    #   resp = client.get_contact({
+    #     contact_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     alias: "akuam", 
+    #     contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #     display_name: "Akua Mansa", 
+    #     plan: {
+    #       stages: [
+    #         {
+    #           duration_in_minutes: 5, 
+    #           targets: [
+    #             {
+    #               channel_target_info: {
+    #                 contact_channel_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/beb25840-5ac8-4644-95cc-7a8de390fa65", 
+    #                 retry_interval_in_minutes: 1, 
+    #               }, 
+    #             }, 
+    #           ], 
+    #         }, 
+    #         {
+    #           duration_in_minutes: 5, 
+    #           targets: [
+    #             {
+    #               channel_target_info: {
+    #                 contact_channel_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/49f3c24d-5f9f-4638-ae25-3f49e04229ad", 
+    #                 retry_interval_in_minutes: 1, 
+    #               }, 
+    #             }, 
+    #           ], 
+    #         }, 
+    #         {
+    #           duration_in_minutes: 5, 
+    #           targets: [
+    #             {
+    #               channel_target_info: {
+    #                 contact_channel_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/77d4f447-f619-4954-afff-85551e369c2a", 
+    #                 retry_interval_in_minutes: 1, 
+    #               }, 
+    #             }, 
+    #           ], 
+    #         }, 
+    #       ], 
+    #     }, 
+    #     type: "PERSONAL", 
+    #   }
+    #
+    # @example Example: Example 2: To describe an escalation plan
+    #
+    #   # The following get-contact example describes an escalation plan.
+    #
+    #   resp = client.get_contact({
+    #     contact_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     alias: "example_escalation", 
+    #     contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", 
+    #     display_name: "Example Escalation Plan", 
+    #     plan: {
+    #       stages: [
+    #         {
+    #           duration_in_minutes: 5, 
+    #           targets: [
+    #             {
+    #               contact_target_info: {
+    #                 contact_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #                 is_essential: true, 
+    #               }, 
+    #             }, 
+    #           ], 
+    #         }, 
+    #         {
+    #           duration_in_minutes: 5, 
+    #           targets: [
+    #             {
+    #               contact_target_info: {
+    #                 contact_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/alejr", 
+    #                 is_essential: false, 
+    #               }, 
+    #             }, 
+    #           ], 
+    #         }, 
+    #         {
+    #           duration_in_minutes: 0, 
+    #           targets: [
+    #             {
+    #               contact_target_info: {
+    #                 contact_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/anasi", 
+    #                 is_essential: false, 
+    #               }, 
+    #             }, 
+    #           ], 
+    #         }, 
+    #       ], 
+    #     }, 
+    #     type: "ESCALATION", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_contact({
@@ -803,6 +1080,27 @@ module Aws::SSMContacts
     #   * {Types::GetContactChannelResult#delivery_address #delivery_address} => Types::ContactChannelAddress
     #   * {Types::GetContactChannelResult#activation_status #activation_status} => String
     #
+    #
+    # @example Example: To list the details of a contact channel
+    #
+    #   # The following get-contact-channel example lists the details of a contact channel.
+    #
+    #   resp = client.get_contact_channel({
+    #     contact_channel_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     activation_status: "ACTIVATED", 
+    #     contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #     contact_channel_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", 
+    #     delivery_address: {
+    #       simple_address: "+15005550199", 
+    #     }, 
+    #     name: "akuas sms", 
+    #     type: "SMS", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_contact_channel({
@@ -838,6 +1136,21 @@ module Aws::SSMContacts
     #   * {Types::GetContactPolicyResult#contact_arn #contact_arn} => String
     #   * {Types::GetContactPolicyResult#policy #policy} => String
     #
+    #
+    # @example Example: To list the resource policies of a contact
+    #
+    #   # The following get-contact-policy example lists the resource policies associated with the specified contact.
+    #
+    #   resp = client.get_contact_policy({
+    #     contact_arn: "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     contact_arn: "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/*\"]}]}", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_contact_policy({
@@ -876,6 +1189,31 @@ module Aws::SSMContacts
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: To list the contact channels of a contact
+    #
+    #   # The following list-contact-channels example lists the available contact channels of the specified contact.
+    #
+    #   resp = client.list_contact_channels({
+    #     contact_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     contact_channels: [
+    #       {
+    #         activation_status: "ACTIVATED", 
+    #         contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #         contact_channel_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", 
+    #         delivery_address: {
+    #           simple_address: "+15005550100", 
+    #         }, 
+    #         name: "akuas sms", 
+    #         type: "SMS", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_contact_channels({
@@ -928,6 +1266,44 @@ module Aws::SSMContacts
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: To list all escalation plans and contacts
+    #
+    #   # The following list-contacts example lists the contacts and escalation plans in your account.
+    #
+    #   resp = client.list_contacts({
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     contacts: [
+    #       {
+    #         alias: "akuam", 
+    #         contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #         display_name: "Akua Mansa", 
+    #         type: "PERSONAL", 
+    #       }, 
+    #       {
+    #         alias: "alejr", 
+    #         contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/alejr", 
+    #         display_name: "Alejandro Rosalez", 
+    #         type: "PERSONAL", 
+    #       }, 
+    #       {
+    #         alias: "anasi", 
+    #         contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/anasi", 
+    #         display_name: "Ana Carolina Silva", 
+    #         type: "PERSONAL", 
+    #       }, 
+    #       {
+    #         alias: "example_escalation", 
+    #         contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", 
+    #         display_name: "Example Escalation", 
+    #         type: "ESCALATION", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_contacts({
@@ -977,6 +1353,45 @@ module Aws::SSMContacts
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: To list all engagements
+    #
+    #   # The following list-engagements example lists engagements to escalation plans and contacts. You can also list engagements
+    #   # for a single incident.
+    #
+    #   resp = client.list_engagements({
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     engagements: [
+    #       {
+    #         contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #         engagement_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/91792571-0b53-4821-9f73-d25d13d9e529", 
+    #         sender: "cli", 
+    #         start_time: Time.parse("2021-05-18T20:37:50.300000+00:00"), 
+    #       }, 
+    #       {
+    #         contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #         engagement_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", 
+    #         sender: "cli", 
+    #         start_time: Time.parse("2021-05-18T18:40:26.666000+00:00"), 
+    #       }, 
+    #       {
+    #         contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", 
+    #         engagement_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356", 
+    #         sender: "cli", 
+    #         start_time: Time.parse("2021-05-18T18:25:41.151000+00:00"), 
+    #       }, 
+    #       {
+    #         contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #         engagement_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/607ced0e-e8fa-4ea7-8958-a237b8803f8f", 
+    #         sender: "cli", 
+    #         start_time: Time.parse("2021-05-18T18:20:58.093000+00:00"), 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_engagements({
@@ -1029,6 +1444,39 @@ module Aws::SSMContacts
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: To list page receipts
+    #
+    #   # The following command-name example lists whether a page was received or not by a contact.
+    #
+    #   resp = client.list_page_receipts({
+    #     page_id: "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/94ea0c7b-56d9-46c3-b84a-a37c8b067ad3", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     receipts: [
+    #       {
+    #         contact_channel_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", 
+    #         receipt_info: "425440", 
+    #         receipt_time: Time.parse("2021-05-18T20:42:57.485000+00:00"), 
+    #         receipt_type: "DELIVERED", 
+    #       }, 
+    #       {
+    #         contact_channel_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", 
+    #         receipt_info: "425440", 
+    #         receipt_time: Time.parse("2021-05-18T20:42:57.907000+00:00"), 
+    #         receipt_type: "READ", 
+    #       }, 
+    #       {
+    #         contact_channel_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/fc7405c4-46b2-48b7-87b2-93e2f225b90d", 
+    #         receipt_info: "SM6656c19132f1465f9c9c1123a5dde7c9", 
+    #         receipt_time: Time.parse("2021-05-18T20:40:52.962000+00:00"), 
+    #         receipt_type: "SENT", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_page_receipts({
@@ -1075,6 +1523,30 @@ module Aws::SSMContacts
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: To list pages by contact
+    #
+    #   # The following list-pages-by-contact example lists all pages to the specified contact.
+    #
+    #   resp = client.list_pages_by_contact({
+    #     contact_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     pages: [
+    #       {
+    #         contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #         delivery_time: Time.parse("2021-05-18T18:43:55.265000+00:00"), 
+    #         engagement_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", 
+    #         page_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93", 
+    #         read_time: Time.parse("2021-05-18T18:43:55.708000+00:00"), 
+    #         sender: "cli", 
+    #         sent_time: Time.parse("2021-05-18T18:43:29.301000+00:00"), 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_pages_by_contact({
@@ -1125,6 +1597,28 @@ module Aws::SSMContacts
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
+    #
+    # @example Example: To list pages to contact channels started from an engagement.
+    #
+    #   # The following list-pages-by-engagement example lists the pages that occurred while engaging the defined engagement plan.
+    #
+    #   resp = client.list_pages_by_engagement({
+    #     engagement_id: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     pages: [
+    #       {
+    #         contact_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #         engagement_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/78a29753-3674-4ac5-9f83-0468563567f0", 
+    #         page_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:page/akuam/ad0052bd-e606-498a-861b-25726292eb93", 
+    #         sender: "cli", 
+    #         sent_time: Time.parse("2021-05-18T18:40:27.245000+00:00"), 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_pages_by_engagement({
@@ -1164,6 +1658,25 @@ module Aws::SSMContacts
     #
     #   * {Types::ListTagsForResourceResult#tags #tags} => Array<Types::Tag>
     #
+    #
+    # @example Example: To list tags for a contact
+    #
+    #   # The following list-tags-for-resource example lists the tags of the specified contact.
+    #
+    #   resp = client.list_tags_for_resource({
+    #     resource_arn: "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     tags: [
+    #       {
+    #         key: "group1", 
+    #         value: "1", 
+    #       }, 
+    #     ], 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_tags_for_resource({
@@ -1195,6 +1708,21 @@ module Aws::SSMContacts
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To share a contact and engagements
+    #
+    #   # The following put-contact-policy example adds a resource policy to the contact Akua that shares the contact and related
+    #   # engagements with the principal.
+    #
+    #   resp = client.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/*\"]}]}", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.put_contact_policy({
@@ -1213,7 +1741,7 @@ module Aws::SSMContacts
 
     # Sends an activation code to a contact channel. The contact can use
     # this code to activate the contact channel in the console or with the
-    # `ActivateChannel` action. Incident Manager can't engage a contact
+    # `ActivateChannel` operation. Incident Manager can't engage a contact
     # channel until it has been activated.
     #
     # @option params [required, String] :contact_channel_id
@@ -1221,6 +1749,19 @@ module Aws::SSMContacts
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To send an activation code
+    #
+    #   # The following send-activation-code example sends an activation code and message to the specified contact channel.
+    #
+    #   resp = client.send_activation_code({
+    #     contact_channel_id: "arn:aws:ssm-contacts:us-east-1:111122223333:contact-channel/akuam/8ddae2d1-12c8-4e45-b852-c8587266c400", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.send_activation_code({
@@ -1265,7 +1806,7 @@ module Aws::SSMContacts
     #   The ARN of the incident that the engagement is part of.
     #
     # @option params [String] :idempotency_token
-    #   A token ensuring that the action is called only once with the
+    #   A token ensuring that the operation is called only once with the
     #   specified details.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -1275,6 +1816,47 @@ module Aws::SSMContacts
     #
     #   * {Types::StartEngagementResult#engagement_arn #engagement_arn} => String
     #
+    #
+    # @example Example: Example 1: To page a contact's contact channels
+    #
+    #   # The following start-engagement pages contact's contact channels. Sender, subject, public-subject, and public-content are
+    #   # all free from fields. Incident Manager sends the subject and content to the provided VOICE or EMAIL contact channels.
+    #   # Incident Manager sends the public-subject and public-content to the provided SMS contact channels. Sender is used to
+    #   # track who started the engagement.
+    #
+    #   resp = client.start_engagement({
+    #     contact_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #     content: "Testing engagements", 
+    #     public_content: "Testing engagements", 
+    #     public_subject: "test", 
+    #     sender: "tester", 
+    #     subject: "test", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     engagement_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/akuam/607ced0e-e8fa-4ea7-8958-a237b8803f8f", 
+    #   }
+    #
+    # @example Example: Example 2: To page a contact in the provided escalation plan.
+    #
+    #   # The following start-engagement engages contact's through an escalation plan. Each contact is paged according to their
+    #   # engagement plan.
+    #
+    #   resp = client.start_engagement({
+    #     contact_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/example_escalation", 
+    #     content: "Testing engagements", 
+    #     public_content: "Testing engagements", 
+    #     public_subject: "test", 
+    #     sender: "tester", 
+    #     subject: "test", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     engagement_arn: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356", 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.start_engagement({
@@ -1312,6 +1894,19 @@ module Aws::SSMContacts
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To stop an engagement
+    #
+    #   # The following stop-engagement example stops an engagement from paging further contacts and contact channels.
+    #
+    #   resp = client.stop_engagement({
+    #     engagement_id: "arn:aws:ssm-contacts:us-east-2:111122223333:engagement/example_escalation/69e40ce1-8dbb-4d57-8962-5fbe7fc53356", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.stop_engagement({
@@ -1339,6 +1934,25 @@ module Aws::SSMContacts
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To tag a contact
+    #
+    #   # The following tag-resource example tags a specified contact with the provided tag key value pair.
+    #
+    #   resp = client.tag_resource({
+    #     resource_arn: "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam", 
+    #     tags: [
+    #       {
+    #         key: "group1", 
+    #         value: "1", 
+    #       }, 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.tag_resource({
@@ -1370,6 +1984,22 @@ module Aws::SSMContacts
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To remove tags from a contact
+    #
+    #   # The following untag-resource example removes the group1 tag from the specified contact.
+    #
+    #   resp = client.untag_resource({
+    #     resource_arn: "arn:aws:ssm-contacts:us-east-1:111122223333:contact/akuam", 
+    #     tag_keys: [
+    #       "group1", 
+    #     ], 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.untag_resource({
@@ -1402,6 +2032,57 @@ module Aws::SSMContacts
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To update the engagement plan of contact
+    #
+    #   # The following update-contact example updates the engagement plan of the contact Akua to include the three types of
+    #   # contacts channels. This is done after creating contact channels for Akua.
+    #
+    #   resp = client.update_contact({
+    #     contact_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact/akuam", 
+    #     plan: {
+    #       stages: [
+    #         {
+    #           duration_in_minutes: 5, 
+    #           targets: [
+    #             {
+    #               channel_target_info: {
+    #                 contact_channel_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/beb25840-5ac8-4644-95cc-7a8de390fa65", 
+    #                 retry_interval_in_minutes: 1, 
+    #               }, 
+    #             }, 
+    #           ], 
+    #         }, 
+    #         {
+    #           duration_in_minutes: 5, 
+    #           targets: [
+    #             {
+    #               channel_target_info: {
+    #                 contact_channel_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/49f3c24d-5f9f-4638-ae25-3f49e04229ad", 
+    #                 retry_interval_in_minutes: 1, 
+    #               }, 
+    #             }, 
+    #           ], 
+    #         }, 
+    #         {
+    #           duration_in_minutes: 5, 
+    #           targets: [
+    #             {
+    #               channel_target_info: {
+    #                 contact_channel_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/77d4f447-f619-4954-afff-85551e369c2a", 
+    #                 retry_interval_in_minutes: 1, 
+    #               }, 
+    #             }, 
+    #           ], 
+    #         }, 
+    #       ], 
+    #     }, 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_contact({
@@ -1444,7 +2125,7 @@ module Aws::SSMContacts
     #   update.
     #
     # @option params [String] :name
-    #   The name of the contact channel
+    #   The name of the contact channel.
     #
     # @option params [Types::ContactChannelAddress] :delivery_address
     #   The details that Incident Manager uses when trying to engage the
@@ -1452,6 +2133,23 @@ module Aws::SSMContacts
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
+    #
+    # @example Example: To update a contact channel
+    #
+    #   # The following update-contact-channel example updates the name and delivery address of a contact channel.
+    #
+    #   resp = client.update_contact_channel({
+    #     contact_channel_id: "arn:aws:ssm-contacts:us-east-2:111122223333:contact-channel/akuam/49f3c24d-5f9f-4638-ae25-3f49e04229ad", 
+    #     delivery_address: {
+    #       simple_address: "+15005550198", 
+    #     }, 
+    #     name: "akuas voice channel", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_contact_channel({
@@ -1484,7 +2182,7 @@ module Aws::SSMContacts
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ssmcontacts'
-      context[:gem_version] = '1.5.0'
+      context[:gem_version] = '1.9.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-ssmcontacts/types.rb

@@ -74,7 +74,7 @@ module Aws::SSMContacts
     #
     class AcceptPageResult < Aws::EmptyStructure; end
 
-    # You don't have sufficient access to perform this action.
+    # You don't have sufficient access to perform this operation.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -358,7 +358,7 @@ module Aws::SSMContacts
     #   @return [Boolean]
     #
     # @!attribute [rw] idempotency_token
-    #   A token ensuring that the action is called only once with the
+    #   A token ensuring that the operation is called only once with the
     #   specified details.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -379,7 +379,7 @@ module Aws::SSMContacts
     end
 
     # @!attribute [rw] contact_channel_arn
-    #   The ARN of the contact channel.
+    #   The Amazon Resource Name (ARN) of the contact channel.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-contacts-2021-05-03/CreateContactChannelResult AWS API Documentation
@@ -451,7 +451,7 @@ module Aws::SSMContacts
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] idempotency_token
-    #   A token ensuring that the action is called only once with the
+    #   A token ensuring that the operation is called only once with the
     #   specified details.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -484,7 +484,7 @@ module Aws::SSMContacts
       include Aws::Structure
     end
 
-    # The action failed to due an encryption key error.
+    # The operation failed to due an encryption key error.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -1607,7 +1607,7 @@ module Aws::SSMContacts
     #   @return [String]
     #
     # @!attribute [rw] idempotency_token
-    #   A token ensuring that the action is called only once with the
+    #   A token ensuring that the operation is called only once with the
     #   specified details.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -1732,7 +1732,7 @@ module Aws::SSMContacts
     #
     class TagResourceResult < Aws::EmptyStructure; end
 
-    # The contact or contact channel that is being engaged.
+    # The contact or contact channel that's being engaged.
     #
     # @note When making an API call, you may pass Target
     #   data as a hash:
@@ -1866,7 +1866,7 @@ module Aws::SSMContacts
     #   @return [String]
     #
     # @!attribute [rw] name
-    #   The name of the contact channel
+    #   The name of the contact channel.
     #   @return [String]
     #
     # @!attribute [rw] delivery_address
@@ -1944,8 +1944,8 @@ module Aws::SSMContacts
     #
     class UpdateContactResult < Aws::EmptyStructure; end
 
-    # The input fails to satisfy the constraints specified by an AWS
-    # service.
+    # The input fails to satisfy the constraints specified by an Amazon Web
+    # Services service.
     #
     # @!attribute [rw] message
     #   @return [String]

data/lib/aws-sdk-ssmcontacts.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-ssmcontacts/customizations'
 # @!group service
 module Aws::SSMContacts
 
-  GEM_VERSION = '1.5.0'
+  GEM_VERSION = '1.9.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ssmcontacts
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-02 00:00:00.000000000 Z
+date: 2021-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.119.0
+        version: 3.122.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.119.0
+        version: 3.122.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
@@ -76,7 +76,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="