aws-sdk-shield 1.24.0 → 1.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: feb5932bfaebf0754f92527a61403bfb3c9479196f71b8f885131344c8cf5c68
-  data.tar.gz: 5e677fae9281170b8a421976c19cc22e7e6b7b0474536c5537f9d1eeea642e8f
+  metadata.gz: d7a45988d874990055ef49cd9ad5da7d733be1bd6a150c19a30bf59a4fbbf237
+  data.tar.gz: 12fd63a32d0f0b30dd2b5932180a2ee3d8ff93054af13b132c8e81bc72bd71fe
 SHA512:
-  metadata.gz: 9687c473ff657801db99a975fc9eb6ef3b126207272755b11613bae53612be7377736d4baefd8b241088a4820a641898334f55db3f7cf00b929971fa9a537383
-  data.tar.gz: 2730ed9dc127fba842d2ea91cb3b9ec3c094cad883cf4fb3b8f59ca793c1295f551ae26bba14a1091b52356af83fbf05b181d6340a5820c882519b511006c0c9
+  metadata.gz: a630e0a4bd3cfe9001b5207e4f9821412ceb4f4a8233a3a1519485865503433ccccd82aec3b04578779d609796ccd2b51e6d5d7364ffdede7f1ad3a7b67491bb
+  data.tar.gz: 00bd8b5e04a314b90a3ea86c73f563e2594e14192346b56934a36688a051df216e6372b2b45fcc973ffbe71bb441a16e68552f28c550ebacc9e3e4ce77f3a28d

data/lib/aws-sdk-shield.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -45,6 +47,6 @@ require_relative 'aws-sdk-shield/customizations'
 # @service
 module Aws::Shield
 
-  GEM_VERSION = '1.24.0'
+  GEM_VERSION = '1.29.0'
 
 end

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -24,6 +26,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
+require 'aws-sdk-core/plugins/http_checksum.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
@@ -69,6 +72,7 @@ module Aws::Shield
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
+    add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
 
@@ -161,7 +165,7 @@ module Aws::Shield
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be a valid HTTP(S) URI.
+    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -176,7 +180,7 @@ module Aws::Shield
     #     requests fetching endpoints information. Defaults to 60 sec.
     #
     #   @option options [Boolean] :endpoint_discovery (false)
-    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
@@ -318,7 +322,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 +355,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 +467,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
@@ -533,26 +594,11 @@ module Aws::Shield
 
     # Activates AWS Shield Advanced for an account.
     #
-    # As part of this request you can specify `EmergencySettings` that
-    # automaticaly grant the DDoS response team (DRT) needed permissions to
-    # assist you during a suspected DDoS attack. For more information see
-    # [Authorize the DDoS Response Team to Create Rules and Web ACLs on Your
-    # Behalf][1].
-    #
-    # To use the services of the DRT, you must be subscribed to the
-    # [Business Support plan][2] or the [Enterprise Support plan][3].
-    #
     # When you initally create a subscription, your subscription is set to
     # be automatically renewed at the end of the existing subscription
     # period. You can change this by submitting an `UpdateSubscription`
     # request.
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/authorize-DRT.html
-    # [2]: https://aws.amazon.com/premiumsupport/business-support/
-    # [3]: https://aws.amazon.com/premiumsupport/enterprise-support/
-    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/CreateSubscription AWS API Documentation
@@ -669,7 +715,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 +738,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 +751,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 +820,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 +831,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 +881,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 +946,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 +1028,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 +1087,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 +1115,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 +1137,8 @@ module Aws::Shield
     #     emergency_contact_list: [
     #       {
     #         email_address: "EmailAddress", # required
+    #         phone_number: "PhoneNumber",
+    #         contact_notes: "ContactNotes",
     #       },
     #     ],
     #   })
@@ -1099,7 +1193,7 @@ module Aws::Shield
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-shield'
-      context[:gem_version] = '1.24.0'
+      context[:gem_version] = '1.29.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -19,6 +21,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 +35,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 +55,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 +68,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 +99,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 +153,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 +244,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 +264,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 +371,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 +468,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 +580,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 +631,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 +662,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 +679,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/errors.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -19,12 +21,13 @@ module Aws::Shield
     #
     class AccessDeniedException < Struct.new(
       :message)
+      SENSITIVE = []
       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].
     #
@@ -39,6 +42,7 @@ module Aws::Shield
     #
     class AccessDeniedForDependencyException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -57,6 +61,7 @@ module Aws::Shield
     #
     class AssociateDRTLogBucketRequest < Struct.new(
       :log_bucket)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -89,6 +94,7 @@ module Aws::Shield
     #
     class AssociateDRTRoleRequest < Struct.new(
       :role_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -119,6 +125,7 @@ module Aws::Shield
     class AssociateHealthCheckRequest < Struct.new(
       :protection_id,
       :health_check_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -126,6 +133,47 @@ 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)
+      SENSITIVE = []
+      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
@@ -183,6 +231,7 @@ module Aws::Shield
       :attack_counters,
       :attack_properties,
       :mitigations)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -223,6 +272,7 @@ module Aws::Shield
       :top_contributors,
       :unit,
       :total)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -266,6 +316,7 @@ module Aws::Shield
       :start_time,
       :end_time,
       :attack_vectors)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -315,6 +366,7 @@ module Aws::Shield
     #
     class AttackVectorDescription < Struct.new(
       :vector_type)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -337,6 +389,7 @@ module Aws::Shield
     class Contributor < Struct.new(
       :name,
       :value)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -384,6 +437,7 @@ module Aws::Shield
     class CreateProtectionRequest < Struct.new(
       :name,
       :resource_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -396,6 +450,7 @@ module Aws::Shield
     #
     class CreateProtectionResponse < Struct.new(
       :protection_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -424,6 +479,7 @@ module Aws::Shield
     #
     class DeleteProtectionRequest < Struct.new(
       :protection_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -456,6 +512,7 @@ module Aws::Shield
     #
     class DescribeAttackRequest < Struct.new(
       :attack_id)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -467,6 +524,7 @@ module Aws::Shield
     #
     class DescribeAttackResponse < Struct.new(
       :attack)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -490,6 +548,7 @@ module Aws::Shield
     class DescribeDRTAccessResponse < Struct.new(
       :role_arn,
       :log_bucket_list)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -500,14 +559,17 @@ 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
     #
     class DescribeEmergencyContactSettingsResponse < Struct.new(
       :emergency_contact_list)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -538,6 +600,7 @@ module Aws::Shield
     class DescribeProtectionRequest < Struct.new(
       :protection_id,
       :resource_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -549,6 +612,7 @@ module Aws::Shield
     #
     class DescribeProtectionResponse < Struct.new(
       :protection)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -566,9 +630,20 @@ module Aws::Shield
     #
     class DescribeSubscriptionResponse < Struct.new(
       :subscription)
+      SENSITIVE = []
       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:
     #
@@ -584,6 +659,7 @@ module Aws::Shield
     #
     class DisassociateDRTLogBucketRequest < Struct.new(
       :log_bucket)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -624,6 +700,7 @@ module Aws::Shield
     class DisassociateHealthCheckRequest < Struct.new(
       :protection_id,
       :health_check_arn)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -631,28 +708,51 @@ 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)
+      SENSITIVE = []
       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
@@ -667,6 +767,7 @@ module Aws::Shield
     #
     class GetSubscriptionStateResponse < Struct.new(
       :subscription_state)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -680,6 +781,7 @@ module Aws::Shield
     #
     class InternalErrorException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -693,6 +795,7 @@ module Aws::Shield
     #
     class InvalidOperationException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -707,6 +810,7 @@ module Aws::Shield
     #
     class InvalidPaginationTokenException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -720,6 +824,7 @@ module Aws::Shield
     #
     class InvalidParameterException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -733,6 +838,7 @@ module Aws::Shield
     #
     class InvalidResourceException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -752,6 +858,7 @@ module Aws::Shield
     class Limit < Struct.new(
       :type,
       :max)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -776,6 +883,7 @@ module Aws::Shield
       :message,
       :type,
       :limit)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -849,6 +957,7 @@ module Aws::Shield
       :end_time,
       :next_token,
       :max_results)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -873,6 +982,7 @@ module Aws::Shield
     class ListAttacksResponse < Struct.new(
       :attack_summaries,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -906,6 +1016,7 @@ module Aws::Shield
     class ListProtectionsRequest < Struct.new(
       :next_token,
       :max_results)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -933,6 +1044,7 @@ module Aws::Shield
     class ListProtectionsResponse < Struct.new(
       :protections,
       :next_token)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -948,6 +1060,7 @@ module Aws::Shield
     #
     class LockedSubscriptionException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -961,6 +1074,7 @@ module Aws::Shield
     #
     class Mitigation < Struct.new(
       :mitigation_name)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -973,11 +1087,12 @@ module Aws::Shield
     #
     class NoAssociatedRoleException < Struct.new(
       :message)
+      SENSITIVE = []
       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]
@@ -986,6 +1101,7 @@ module Aws::Shield
     #
     class OptimisticLockException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1017,6 +1133,7 @@ module Aws::Shield
       :name,
       :resource_arn,
       :health_check_ids)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1029,6 +1146,7 @@ module Aws::Shield
     #
     class ResourceAlreadyExistsException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1041,6 +1159,7 @@ module Aws::Shield
     #
     class ResourceNotFoundException < Struct.new(
       :message)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1069,6 +1188,7 @@ module Aws::Shield
       :id,
       :attack_vectors,
       :counters)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1107,6 +1227,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 +1247,9 @@ module Aws::Shield
       :end_time,
       :time_commitment_in_seconds,
       :auto_renew,
-      :limits)
+      :limits,
+      :proactive_engagement_status)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1133,6 +1268,7 @@ module Aws::Shield
     class SummarizedAttackVector < Struct.new(
       :vector_type,
       :vector_counters)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1171,6 +1307,7 @@ module Aws::Shield
       :sum,
       :n,
       :unit)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1207,6 +1344,7 @@ module Aws::Shield
     class TimeRange < Struct.new(
       :from_inclusive,
       :to_exclusive)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1217,19 +1355,27 @@ 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
     #
     class UpdateEmergencyContactSettingsRequest < Struct.new(
       :emergency_contact_list)
+      SENSITIVE = []
       include Aws::Structure
     end
 
@@ -1257,6 +1403,7 @@ module Aws::Shield
     #
     class UpdateSubscriptionRequest < Struct.new(
       :auto_renew)
+      SENSITIVE = []
       include Aws::Structure
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-shield
 version: !ruby/object:Gem::Version
-  version: 1.24.0
+  version: 1.29.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-07 00:00:00.000000000 Z
+date: 2020-07-02 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.71.0
+        version: 3.99.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.71.0
+        version: 3.99.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement