aws-sdk-shield 1.25.0 → 1.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab4c1c775ddc9e7eb1d75612ead83ccf3e80dc3d6077b042f5dffa707b9411b4
-  data.tar.gz: 04a59519bb3f17eb4d59b93b27cbde5d90cafdb85837d61a1d3d7edfca05d2eb
+  metadata.gz: d562d25061a6896c4d3012ac213b71d04d07bafe9f2f46881b5a63f353bf2833
+  data.tar.gz: b7b0b904731efe4524c06db78ad8c94d17c4aab517532161239a2b244b645c27
 SHA512:
-  metadata.gz: 226ac5493ffb7d811ba044e24ea96934f8f9c6cc96ae55575ac2a3a970aa5e247331892fb2750553a7f9e532b0e503c85c1aa8b7cbb669e3992f19a65f8dcdfa
-  data.tar.gz: 96b63836f50c9c5a0428481bae73e26d409976e9da6abd5669d9d74acf2cc1df1c6746fc9ebc46e9b879d899334cb0a1dc40bd8aff2f82b23cff04a124a57d97
+  metadata.gz: 0fc3949723bf67e9323b342cdd47fc56fffd7e2e8d90c6a9b0d88f38803a361ad53ec7f07da6ed50ef3082f9f0b8eef2156d9c8982ca73c7b28d545f5d58ae77
+  data.tar.gz: 92fe118ea6d193ee66434137d5eebe23b07b44d51c9ea2d545561822e7ff4d36bcce0281375e26be0cde27d95edd9972ef58f375ffe13f2c7c8bc15efbbf8828

data/lib/aws-sdk-shield.rb

@@ -45,6 +45,6 @@ require_relative 'aws-sdk-shield/customizations'
 # @service
 module Aws::Shield
 
-  GEM_VERSION = '1.25.0'
+  GEM_VERSION = '1.26.0'
 
 end

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

@@ -318,7 +318,7 @@ module Aws::Shield
 
     # @!group API Operations
 
-    # Authorizes the DDoS Response team (DRT) to access the specified Amazon
+    # Authorizes the DDoS Response Team (DRT) to access the specified Amazon
     # S3 bucket containing your AWS WAF logs. You can associate up to 10
     # Amazon S3 buckets with your subscription.
     #
@@ -351,7 +351,7 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Authorizes the DDoS Response team (DRT), using the specified role, to
+    # Authorizes the DDoS Response Team (DRT), using the specified role, to
     # access your AWS account to assist with DDoS attack mitigation during
     # potential attacks. This enables the DRT to inspect your AWS WAF
     # configuration and create or update AWS WAF rules and web ACLs.
@@ -463,6 +463,63 @@ module Aws::Shield
       req.send_request(options)
     end
 
+    # Initializes proactive engagement and sets the list of contacts for the
+    # DDoS Response Team (DRT) to use. You must provide at least one phone
+    # number in the emergency contact list.
+    #
+    # After you have initialized proactive engagement using this call, to
+    # disable or enable proactive engagement, use the calls
+    # `DisableProactiveEngagement` and `EnableProactiveEngagement`.
+    #
+    # <note markdown="1"> This call defines the list of email addresses and phone numbers that
+    # the DDoS Response Team (DRT) can use to contact you for escalations to
+    # the DRT and to initiate proactive customer support.
+    #
+    #  The contacts that you provide in the request replace any contacts that
+    # were already defined. If you already have contacts defined and want to
+    # use them, retrieve the list using `DescribeEmergencyContactSettings`
+    # and then provide it to this call.
+    #
+    #  </note>
+    #
+    # @option params [required, Array<Types::EmergencyContact>] :emergency_contact_list
+    #   A list of email addresses and phone numbers that the DDoS Response
+    #   Team (DRT) can use to contact you for escalations to the DRT and to
+    #   initiate proactive customer support.
+    #
+    #   To enable proactive engagement, the contact list must include at least
+    #   one phone number.
+    #
+    #   <note markdown="1"> The contacts that you provide here replace any contacts that were
+    #   already defined. If you already have contacts defined and want to use
+    #   them, retrieve the list using `DescribeEmergencyContactSettings` and
+    #   then provide it here.
+    #
+    #    </note>
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.associate_proactive_engagement_details({
+    #     emergency_contact_list: [ # required
+    #       {
+    #         email_address: "EmailAddress", # required
+    #         phone_number: "PhoneNumber",
+    #         contact_notes: "ContactNotes",
+    #       },
+    #     ],
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/AssociateProactiveEngagementDetails AWS API Documentation
+    #
+    # @overload associate_proactive_engagement_details(params = {})
+    # @param [Hash] params ({})
+    def associate_proactive_engagement_details(params = {}, options = {})
+      req = build_request(:associate_proactive_engagement_details, params)
+      req.send_request(options)
+    end
+
     # Enables AWS Shield Advanced for a specific AWS resource. The resource
     # can be an Amazon CloudFront distribution, Elastic Load Balancing load
     # balancer, AWS Global Accelerator accelerator, Elastic IP Address, or
@@ -669,7 +726,7 @@ module Aws::Shield
     end
 
     # Returns the current role and list of Amazon S3 log buckets used by the
-    # DDoS Response team (DRT) to access your AWS account while assisting
+    # DDoS Response Team (DRT) to access your AWS account while assisting
     # with attack mitigation.
     #
     # @return [Types::DescribeDRTAccessResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -692,8 +749,10 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Lists the email addresses that the DRT can use to contact you during a
-    # suspected attack.
+    # A list of email addresses and phone numbers that the DDoS Response
+    # Team (DRT) can use to contact you if you have proactive engagement
+    # enabled, for escalations to the DRT and to initiate proactive customer
+    # support.
     #
     # @return [Types::DescribeEmergencyContactSettingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -703,6 +762,8 @@ module Aws::Shield
     #
     #   resp.emergency_contact_list #=> Array
     #   resp.emergency_contact_list[0].email_address #=> String
+    #   resp.emergency_contact_list[0].phone_number #=> String
+    #   resp.emergency_contact_list[0].contact_notes #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DescribeEmergencyContactSettings AWS API Documentation
     #
@@ -770,6 +831,7 @@ module Aws::Shield
     #   resp.subscription.limits #=> Array
     #   resp.subscription.limits[0].type #=> String
     #   resp.subscription.limits[0].max #=> Integer
+    #   resp.subscription.proactive_engagement_status #=> String, one of "ENABLED", "DISABLED", "PENDING"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DescribeSubscription AWS API Documentation
     #
@@ -780,7 +842,22 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Removes the DDoS Response team's (DRT) access to the specified Amazon
+    # Removes authorization from the DDoS Response Team (DRT) to notify
+    # contacts about escalations to the DRT and to initiate proactive
+    # customer support.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DisableProactiveEngagement AWS API Documentation
+    #
+    # @overload disable_proactive_engagement(params = {})
+    # @param [Hash] params ({})
+    def disable_proactive_engagement(params = {}, options = {})
+      req = build_request(:disable_proactive_engagement, params)
+      req.send_request(options)
+    end
+
+    # Removes the DDoS Response Team's (DRT) access to the specified Amazon
     # S3 bucket containing your AWS WAF logs.
     #
     # To make a `DisassociateDRTLogBucket` request, you must be subscribed
@@ -815,7 +892,7 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Removes the DDoS Response team's (DRT) access to your AWS account.
+    # Removes the DDoS Response Team's (DRT) access to your AWS account.
     #
     # To make a `DisassociateDRTRole` request, you must be subscribed to the
     # [Business Support plan][1] or the [Enterprise Support plan][2].
@@ -880,6 +957,21 @@ module Aws::Shield
       req.send_request(options)
     end
 
+    # Authorizes the DDoS Response Team (DRT) to use email and phone to
+    # notify contacts about escalations to the DRT and to initiate proactive
+    # customer support.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/EnableProactiveEngagement AWS API Documentation
+    #
+    # @overload enable_proactive_engagement(params = {})
+    # @param [Hash] params ({})
+    def enable_proactive_engagement(params = {}, options = {})
+      req = build_request(:enable_proactive_engagement, params)
+      req.send_request(options)
+    end
+
     # Returns the `SubscriptionState`, either `Active` or `Inactive`.
     #
     # @return [Types::GetSubscriptionStateResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -947,6 +1039,8 @@ module Aws::Shield
     #   * {Types::ListAttacksResponse#attack_summaries #attack_summaries} => Array&lt;Types::AttackSummary&gt;
     #   * {Types::ListAttacksResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_attacks({
@@ -1004,6 +1098,8 @@ module Aws::Shield
     #   * {Types::ListProtectionsResponse#protections #protections} => Array&lt;Types::Protection&gt;
     #   * {Types::ListProtectionsResponse#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_protections({
@@ -1030,12 +1126,19 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Updates the details of the list of email addresses that the DRT can
-    # use to contact you during a suspected attack.
+    # Updates the details of the list of email addresses and phone numbers
+    # that the DDoS Response Team (DRT) can use to contact you if you have
+    # proactive engagement enabled, for escalations to the DRT and to
+    # initiate proactive customer support.
     #
     # @option params [Array<Types::EmergencyContact>] :emergency_contact_list
-    #   A list of email addresses that the DRT can use to contact you during a
-    #   suspected attack.
+    #   A list of email addresses and phone numbers that the DDoS Response
+    #   Team (DRT) can use to contact you if you have proactive engagement
+    #   enabled, for escalations to the DRT and to initiate proactive customer
+    #   support.
+    #
+    #   If you have proactive engagement enabled, the contact list must
+    #   include at least one phone number.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1045,6 +1148,8 @@ module Aws::Shield
     #     emergency_contact_list: [
     #       {
     #         email_address: "EmailAddress", # required
+    #         phone_number: "PhoneNumber",
+    #         contact_notes: "ContactNotes",
     #       },
     #     ],
     #   })
@@ -1099,7 +1204,7 @@ module Aws::Shield
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-shield'
-      context[:gem_version] = '1.25.0'
+      context[:gem_version] = '1.26.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-shield/client_api.rb

@@ -19,6 +19,8 @@ module Aws::Shield
     AssociateDRTRoleResponse = Shapes::StructureShape.new(name: 'AssociateDRTRoleResponse')
     AssociateHealthCheckRequest = Shapes::StructureShape.new(name: 'AssociateHealthCheckRequest')
     AssociateHealthCheckResponse = Shapes::StructureShape.new(name: 'AssociateHealthCheckResponse')
+    AssociateProactiveEngagementDetailsRequest = Shapes::StructureShape.new(name: 'AssociateProactiveEngagementDetailsRequest')
+    AssociateProactiveEngagementDetailsResponse = Shapes::StructureShape.new(name: 'AssociateProactiveEngagementDetailsResponse')
     AttackDetail = Shapes::StructureShape.new(name: 'AttackDetail')
     AttackId = Shapes::StringShape.new(name: 'AttackId')
     AttackLayer = Shapes::StringShape.new(name: 'AttackLayer')
@@ -31,6 +33,7 @@ module Aws::Shield
     AttackVectorDescription = Shapes::StructureShape.new(name: 'AttackVectorDescription')
     AttackVectorDescriptionList = Shapes::ListShape.new(name: 'AttackVectorDescriptionList')
     AutoRenew = Shapes::StringShape.new(name: 'AutoRenew')
+    ContactNotes = Shapes::StringShape.new(name: 'ContactNotes')
     Contributor = Shapes::StructureShape.new(name: 'Contributor')
     CreateProtectionRequest = Shapes::StructureShape.new(name: 'CreateProtectionRequest')
     CreateProtectionResponse = Shapes::StructureShape.new(name: 'CreateProtectionResponse')
@@ -50,6 +53,8 @@ module Aws::Shield
     DescribeProtectionResponse = Shapes::StructureShape.new(name: 'DescribeProtectionResponse')
     DescribeSubscriptionRequest = Shapes::StructureShape.new(name: 'DescribeSubscriptionRequest')
     DescribeSubscriptionResponse = Shapes::StructureShape.new(name: 'DescribeSubscriptionResponse')
+    DisableProactiveEngagementRequest = Shapes::StructureShape.new(name: 'DisableProactiveEngagementRequest')
+    DisableProactiveEngagementResponse = Shapes::StructureShape.new(name: 'DisableProactiveEngagementResponse')
     DisassociateDRTLogBucketRequest = Shapes::StructureShape.new(name: 'DisassociateDRTLogBucketRequest')
     DisassociateDRTLogBucketResponse = Shapes::StructureShape.new(name: 'DisassociateDRTLogBucketResponse')
     DisassociateDRTRoleRequest = Shapes::StructureShape.new(name: 'DisassociateDRTRoleRequest')
@@ -61,6 +66,8 @@ module Aws::Shield
     EmailAddress = Shapes::StringShape.new(name: 'EmailAddress')
     EmergencyContact = Shapes::StructureShape.new(name: 'EmergencyContact')
     EmergencyContactList = Shapes::ListShape.new(name: 'EmergencyContactList')
+    EnableProactiveEngagementRequest = Shapes::StructureShape.new(name: 'EnableProactiveEngagementRequest')
+    EnableProactiveEngagementResponse = Shapes::StructureShape.new(name: 'EnableProactiveEngagementResponse')
     GetSubscriptionStateRequest = Shapes::StructureShape.new(name: 'GetSubscriptionStateRequest')
     GetSubscriptionStateResponse = Shapes::StructureShape.new(name: 'GetSubscriptionStateResponse')
     HealthCheckArn = Shapes::StringShape.new(name: 'HealthCheckArn')
@@ -90,6 +97,8 @@ module Aws::Shield
     MitigationList = Shapes::ListShape.new(name: 'MitigationList')
     NoAssociatedRoleException = Shapes::StructureShape.new(name: 'NoAssociatedRoleException')
     OptimisticLockException = Shapes::StructureShape.new(name: 'OptimisticLockException')
+    PhoneNumber = Shapes::StringShape.new(name: 'PhoneNumber')
+    ProactiveEngagementStatus = Shapes::StringShape.new(name: 'ProactiveEngagementStatus')
     Protection = Shapes::StructureShape.new(name: 'Protection')
     ProtectionId = Shapes::StringShape.new(name: 'ProtectionId')
     ProtectionName = Shapes::StringShape.new(name: 'ProtectionName')
@@ -142,6 +151,11 @@ module Aws::Shield
 
     AssociateHealthCheckResponse.struct_class = Types::AssociateHealthCheckResponse
 
+    AssociateProactiveEngagementDetailsRequest.add_member(:emergency_contact_list, Shapes::ShapeRef.new(shape: EmergencyContactList, required: true, location_name: "EmergencyContactList"))
+    AssociateProactiveEngagementDetailsRequest.struct_class = Types::AssociateProactiveEngagementDetailsRequest
+
+    AssociateProactiveEngagementDetailsResponse.struct_class = Types::AssociateProactiveEngagementDetailsResponse
+
     AttackDetail.add_member(:attack_id, Shapes::ShapeRef.new(shape: AttackId, location_name: "AttackId"))
     AttackDetail.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ResourceArn, location_name: "ResourceArn"))
     AttackDetail.add_member(:sub_resources, Shapes::ShapeRef.new(shape: SubResourceSummaryList, location_name: "SubResources"))
@@ -228,6 +242,10 @@ module Aws::Shield
     DescribeSubscriptionResponse.add_member(:subscription, Shapes::ShapeRef.new(shape: Subscription, location_name: "Subscription"))
     DescribeSubscriptionResponse.struct_class = Types::DescribeSubscriptionResponse
 
+    DisableProactiveEngagementRequest.struct_class = Types::DisableProactiveEngagementRequest
+
+    DisableProactiveEngagementResponse.struct_class = Types::DisableProactiveEngagementResponse
+
     DisassociateDRTLogBucketRequest.add_member(:log_bucket, Shapes::ShapeRef.new(shape: LogBucket, required: true, location_name: "LogBucket"))
     DisassociateDRTLogBucketRequest.struct_class = Types::DisassociateDRTLogBucketRequest
 
@@ -244,10 +262,16 @@ module Aws::Shield
     DisassociateHealthCheckResponse.struct_class = Types::DisassociateHealthCheckResponse
 
     EmergencyContact.add_member(:email_address, Shapes::ShapeRef.new(shape: EmailAddress, required: true, location_name: "EmailAddress"))
+    EmergencyContact.add_member(:phone_number, Shapes::ShapeRef.new(shape: PhoneNumber, location_name: "PhoneNumber"))
+    EmergencyContact.add_member(:contact_notes, Shapes::ShapeRef.new(shape: ContactNotes, location_name: "ContactNotes"))
     EmergencyContact.struct_class = Types::EmergencyContact
 
     EmergencyContactList.member = Shapes::ShapeRef.new(shape: EmergencyContact)
 
+    EnableProactiveEngagementRequest.struct_class = Types::EnableProactiveEngagementRequest
+
+    EnableProactiveEngagementResponse.struct_class = Types::EnableProactiveEngagementResponse
+
     GetSubscriptionStateRequest.struct_class = Types::GetSubscriptionStateRequest
 
     GetSubscriptionStateResponse.add_member(:subscription_state, Shapes::ShapeRef.new(shape: SubscriptionState, required: true, location_name: "SubscriptionState"))
@@ -345,6 +369,7 @@ module Aws::Shield
     Subscription.add_member(:time_commitment_in_seconds, Shapes::ShapeRef.new(shape: DurationInSeconds, location_name: "TimeCommitmentInSeconds"))
     Subscription.add_member(:auto_renew, Shapes::ShapeRef.new(shape: AutoRenew, location_name: "AutoRenew"))
     Subscription.add_member(:limits, Shapes::ShapeRef.new(shape: Limits, location_name: "Limits"))
+    Subscription.add_member(:proactive_engagement_status, Shapes::ShapeRef.new(shape: ProactiveEngagementStatus, location_name: "ProactiveEngagementStatus"))
     Subscription.struct_class = Types::Subscription
 
     SummarizedAttackVector.add_member(:vector_type, Shapes::ShapeRef.new(shape: String, required: true, location_name: "VectorType"))
@@ -441,6 +466,19 @@ module Aws::Shield
         o.errors << Shapes::ShapeRef.new(shape: OptimisticLockException)
       end)
 
+      api.add_operation(:associate_proactive_engagement_details, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "AssociateProactiveEngagementDetails"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: AssociateProactiveEngagementDetailsRequest)
+        o.output = Shapes::ShapeRef.new(shape: AssociateProactiveEngagementDetailsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidOperationException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: OptimisticLockException)
+      end)
+
       api.add_operation(:create_protection, Seahorse::Model::Operation.new.tap do |o|
         o.name = "CreateProtection"
         o.http_method = "POST"
@@ -540,6 +578,19 @@ module Aws::Shield
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
 
+      api.add_operation(:disable_proactive_engagement, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DisableProactiveEngagement"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DisableProactiveEngagementRequest)
+        o.output = Shapes::ShapeRef.new(shape: DisableProactiveEngagementResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidOperationException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: OptimisticLockException)
+      end)
+
       api.add_operation(:disassociate_drt_log_bucket, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DisassociateDRTLogBucket"
         o.http_method = "POST"
@@ -578,6 +629,19 @@ module Aws::Shield
         o.errors << Shapes::ShapeRef.new(shape: OptimisticLockException)
       end)
 
+      api.add_operation(:enable_proactive_engagement, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "EnableProactiveEngagement"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: EnableProactiveEngagementRequest)
+        o.output = Shapes::ShapeRef.new(shape: EnableProactiveEngagementResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidOperationException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: OptimisticLockException)
+      end)
+
       api.add_operation(:get_subscription_state, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetSubscriptionState"
         o.http_method = "POST"
@@ -596,6 +660,12 @@ module Aws::Shield
         o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidOperationException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:list_protections, Seahorse::Model::Operation.new.tap do |o|
@@ -607,6 +677,12 @@ module Aws::Shield
         o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidPaginationTokenException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:update_emergency_contact_settings, Seahorse::Model::Operation.new.tap do |o|

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

@@ -22,9 +22,9 @@ module Aws::Shield
       include Aws::Structure
     end
 
-    # In order to grant the necessary access to the DDoS Response Team, the
-    # user submitting the request must have the `iam:PassRole` permission.
-    # This error indicates the user did not have the appropriate
+    # In order to grant the necessary access to the DDoS Response Team
+    # (DRT), the user submitting the request must have the `iam:PassRole`
+    # permission. This error indicates the user did not have the appropriate
     # permissions. For more information, see [Granting a User Permissions to
     # Pass a Role to an AWS Service][1].
     #
@@ -126,6 +126,46 @@ module Aws::Shield
     #
     class AssociateHealthCheckResponse < Aws::EmptyStructure; end
 
+    # @note When making an API call, you may pass AssociateProactiveEngagementDetailsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         emergency_contact_list: [ # required
+    #           {
+    #             email_address: "EmailAddress", # required
+    #             phone_number: "PhoneNumber",
+    #             contact_notes: "ContactNotes",
+    #           },
+    #         ],
+    #       }
+    #
+    # @!attribute [rw] emergency_contact_list
+    #   A list of email addresses and phone numbers that the DDoS Response
+    #   Team (DRT) can use to contact you for escalations to the DRT and to
+    #   initiate proactive customer support.
+    #
+    #   To enable proactive engagement, the contact list must include at
+    #   least one phone number.
+    #
+    #   <note markdown="1"> The contacts that you provide here replace any contacts that were
+    #   already defined. If you already have contacts defined and want to
+    #   use them, retrieve the list using `DescribeEmergencyContactSettings`
+    #   and then provide it here.
+    #
+    #    </note>
+    #   @return [Array<Types::EmergencyContact>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/AssociateProactiveEngagementDetailsRequest AWS API Documentation
+    #
+    class AssociateProactiveEngagementDetailsRequest < Struct.new(
+      :emergency_contact_list)
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/AssociateProactiveEngagementDetailsResponse AWS API Documentation
+    #
+    class AssociateProactiveEngagementDetailsResponse < Aws::EmptyStructure; end
+
     # The details of a DDoS attack.
     #
     # @!attribute [rw] attack_id
@@ -500,8 +540,10 @@ module Aws::Shield
     class DescribeEmergencyContactSettingsRequest < Aws::EmptyStructure; end
 
     # @!attribute [rw] emergency_contact_list
-    #   A list of email addresses that the DRT can use to contact you during
-    #   a suspected attack.
+    #   A list of email addresses and phone numbers that the DDoS Response
+    #   Team (DRT) can use to contact you if you have proactive engagement
+    #   enabled, for escalations to the DRT and to initiate proactive
+    #   customer support.
     #   @return [Array<Types::EmergencyContact>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DescribeEmergencyContactSettingsResponse AWS API Documentation
@@ -569,6 +611,16 @@ module Aws::Shield
       include Aws::Structure
     end
 
+    # @api private
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DisableProactiveEngagementRequest AWS API Documentation
+    #
+    class DisableProactiveEngagementRequest < Aws::EmptyStructure; end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DisableProactiveEngagementResponse AWS API Documentation
+    #
+    class DisableProactiveEngagementResponse < Aws::EmptyStructure; end
+
     # @note When making an API call, you may pass DisassociateDRTLogBucketRequest
     #   data as a hash:
     #
@@ -631,28 +683,50 @@ module Aws::Shield
     #
     class DisassociateHealthCheckResponse < Aws::EmptyStructure; end
 
-    # Contact information that the DRT can use to contact you during a
-    # suspected attack.
+    # Contact information that the DRT can use to contact you if you have
+    # proactive engagement enabled, for escalations to the DRT and to
+    # initiate proactive customer support.
     #
     # @note When making an API call, you may pass EmergencyContact
     #   data as a hash:
     #
     #       {
     #         email_address: "EmailAddress", # required
+    #         phone_number: "PhoneNumber",
+    #         contact_notes: "ContactNotes",
     #       }
     #
     # @!attribute [rw] email_address
-    #   An email address that the DRT can use to contact you during a
-    #   suspected attack.
+    #   The email address for the contact.
+    #   @return [String]
+    #
+    # @!attribute [rw] phone_number
+    #   The phone number for the contact.
+    #   @return [String]
+    #
+    # @!attribute [rw] contact_notes
+    #   Additional notes regarding the contact.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/EmergencyContact AWS API Documentation
     #
     class EmergencyContact < Struct.new(
-      :email_address)
+      :email_address,
+      :phone_number,
+      :contact_notes)
       include Aws::Structure
     end
 
+    # @api private
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/EnableProactiveEngagementRequest AWS API Documentation
+    #
+    class EnableProactiveEngagementRequest < Aws::EmptyStructure; end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/EnableProactiveEngagementResponse AWS API Documentation
+    #
+    class EnableProactiveEngagementResponse < Aws::EmptyStructure; end
+
     # @api private
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/GetSubscriptionStateRequest AWS API Documentation
@@ -976,8 +1050,8 @@ module Aws::Shield
       include Aws::Structure
     end
 
-    # Exception that indicates that the protection state has been modified
-    # by another client. You can retry the request.
+    # Exception that indicates that the resource state has been modified by
+    # another client. Retrieve the resource and then retry your request.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -1107,6 +1181,19 @@ module Aws::Shield
     #   Specifies how many protections of a given type you can create.
     #   @return [Array<Types::Limit>]
     #
+    # @!attribute [rw] proactive_engagement_status
+    #   If `ENABLED`, the DDoS Response Team (DRT) will use email and phone
+    #   to notify contacts about escalations to the DRT and to initiate
+    #   proactive customer support.
+    #
+    #   If `PENDING`, you have requested proactive engagement and the
+    #   request is pending. The status changes to `ENABLED` when your
+    #   request is fully processed.
+    #
+    #   If `DISABLED`, the DRT will not proactively notify contacts about
+    #   escalations or to initiate proactive customer support.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/Subscription AWS API Documentation
     #
     class Subscription < Struct.new(
@@ -1114,7 +1201,8 @@ module Aws::Shield
       :end_time,
       :time_commitment_in_seconds,
       :auto_renew,
-      :limits)
+      :limits,
+      :proactive_engagement_status)
       include Aws::Structure
     end
 
@@ -1217,13 +1305,20 @@ module Aws::Shield
     #         emergency_contact_list: [
     #           {
     #             email_address: "EmailAddress", # required
+    #             phone_number: "PhoneNumber",
+    #             contact_notes: "ContactNotes",
     #           },
     #         ],
     #       }
     #
     # @!attribute [rw] emergency_contact_list
-    #   A list of email addresses that the DRT can use to contact you during
-    #   a suspected attack.
+    #   A list of email addresses and phone numbers that the DDoS Response
+    #   Team (DRT) can use to contact you if you have proactive engagement
+    #   enabled, for escalations to the DRT and to initiate proactive
+    #   customer support.
+    #
+    #   If you have proactive engagement enabled, the contact list must
+    #   include at least one phone number.
     #   @return [Array<Types::EmergencyContact>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/UpdateEmergencyContactSettingsRequest AWS API Documentation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-shield
 version: !ruby/object:Gem::Version
-  version: 1.25.0
+  version: 1.26.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-28 00:00:00.000000000 Z
+date: 2020-06-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core