aws-sdk-shield 1.37.0 → 1.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 879c6b88e06bd722d2015a9f8970f372ae2485a60775d7f7b02fd75797503fbf
-  data.tar.gz: ca8a001ad6a7d3c4ae4470549cb87b5bc707166652634da9b6b7a4d20d1d1ae6
+  metadata.gz: 326588a64c345c4bcd07a2da9cd82f6b2533c105c4db833008ef39e72d9274da
+  data.tar.gz: e697b7c957fffbf4798d1287e09b217e947fb25a8980f059c53385fc65b6df41
 SHA512:
-  metadata.gz: 22c72a55bc53073aa29422b028b6c8a2cdfb5157b49f9dbd1db75e62c5146c732f5b4562a8d36155cda5611486afb4fb3718406d64d3629cedf2e35f7c7a0627
-  data.tar.gz: 8396bc9a95170b6d8a85876f0efec7202fe6b4d38364c2f9d86fd47cc47db6b45ecb77b5ad37473aa267d386c2f336b37305601ef4acc495fe16646ba5c94fde
+  metadata.gz: df6865b5f1bb201321fd3b2149de5e5f18a51fcb8479d28090cddedb108445eb6a1ebec7fcbcd79d02efdf83d2039688e048cef9dbfe52c45f0c00baab4a8377
+  data.tar.gz: 0b797117f138bdce1e50b7b453526913efccbb01372a7d677c80bb68e99d6815daeaa51cfb60106c4071bba37d3af43bef197cbb514d8bdf835f30e05f850ee3

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.38.0 (2021-07-27)
+------------------
+
+* Feature - Change name of DDoS Response Team (DRT) to Shield Response Team (SRT)
+
 1.37.0 (2021-04-09)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.37.0
+1.38.0

data/lib/aws-sdk-shield.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-shield/customizations'
 # @!group service
 module Aws::Shield
 
-  GEM_VERSION = '1.37.0'
+  GEM_VERSION = '1.38.0'
 
 end

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

@@ -337,11 +337,12 @@ module Aws::Shield
 
     # @!group API Operations
 
-    # 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.
+    # Authorizes the Shield Response Team (SRT) to access the specified
+    # Amazon S3 bucket containing log data such as Application Load Balancer
+    # access logs, CloudFront logs, or logs from third party sources. You
+    # can associate up to 10 Amazon S3 buckets with your subscription.
     #
-    # To use the services of the DRT and make an `AssociateDRTLogBucket`
+    # To use the services of the SRT and make an `AssociateDRTLogBucket`
     # request, you must be subscribed to the [Business Support plan][1] or
     # the [Enterprise Support plan][2].
     #
@@ -351,7 +352,7 @@ module Aws::Shield
     # [2]: https://aws.amazon.com/premiumsupport/enterprise-support/
     #
     # @option params [required, String] :log_bucket
-    #   The Amazon S3 bucket that contains your AWS WAF logs.
+    #   The Amazon S3 bucket that contains the logs that you want to share.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -370,10 +371,10 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # 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.
+    # Authorizes the Shield Response Team (SRT) using the specified role, to
+    # access your Amazon Web Services account to assist with DDoS attack
+    # mitigation during potential attacks. This enables the SRT to inspect
+    # your WAF configuration and create or update WAF rules and web ACLs.
     #
     # You can associate only one `RoleArn` with your subscription. If you
     # submit an `AssociateDRTRole` request for an account that already has
@@ -389,17 +390,17 @@ module Aws::Shield
     # drt.shield.amazonaws.com`. For more information, see [IAM JSON Policy
     # Elements: Principal][2].
     #
-    # The DRT will have access only to your AWS WAF and Shield resources. By
-    # submitting this request, you authorize the DRT to inspect your AWS WAF
-    # and Shield configuration and create and update AWS WAF rules and web
-    # ACLs on your behalf. The DRT takes these actions only if explicitly
-    # authorized by you.
+    # The SRT will have access only to your WAF and Shield resources. By
+    # submitting this request, you authorize the SRT to inspect your WAF and
+    # Shield configuration and create and update WAF rules and web ACLs on
+    # your behalf. The SRT takes these actions only if explicitly authorized
+    # by you.
     #
     # You must have the `iam:PassRole` permission to make an
     # `AssociateDRTRole` request. For more information, see [Granting a User
-    # Permissions to Pass a Role to an AWS Service][3].
+    # Permissions to Pass a Role to an Amazon Web Services Service][3].
     #
-    # To use the services of the DRT and make an `AssociateDRTRole` request,
+    # To use the services of the SRT and make an `AssociateDRTRole` request,
     # you must be subscribed to the [Business Support plan][4] or the
     # [Enterprise Support plan][5].
     #
@@ -412,8 +413,8 @@ module Aws::Shield
     # [5]: https://aws.amazon.com/premiumsupport/enterprise-support/
     #
     # @option params [required, String] :role_arn
-    #   The Amazon Resource Name (ARN) of the role the DRT will use to access
-    #   your AWS account.
+    #   The Amazon Resource Name (ARN) of the role the SRT will use to access
+    #   your Amazon Web Services account.
     #
     #   Prior to making the `AssociateDRTRole` request, you must attach the
     #   [AWSShieldDRTAccessPolicy][1] managed policy to this role. For more
@@ -443,18 +444,16 @@ module Aws::Shield
 
     # Adds health-based detection to the Shield Advanced protection for a
     # resource. Shield Advanced health-based detection uses the health of
-    # your AWS resource to improve responsiveness and accuracy in attack
-    # detection and mitigation.
+    # your Amazon Web Services resource to improve responsiveness and
+    # accuracy in attack detection and mitigation.
     #
     # You define the health check in Route 53 and then associate it with
     # your Shield Advanced protection. For more information, see [Shield
-    # Advanced Health-Based Detection][1] in the [AWS WAF and AWS Shield
-    # Developer Guide][2].
+    # Advanced Health-Based Detection][1] in the *WAF Developer Guide*.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/ddos-overview.html#ddos-advanced-health-check-option
-    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :protection_id
     #   The unique identifier (ID) for the Protection object to add the health
@@ -483,7 +482,7 @@ module Aws::Shield
     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
+    # Shield Response Team (SRT) 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
@@ -491,8 +490,8 @@ module Aws::Shield
     # `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 SRT can use to contact you for escalations to the SRT 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
@@ -502,8 +501,8 @@ module Aws::Shield
     #  </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
+    #   A list of email addresses and phone numbers that the Shield Response
+    #   Team (SRT) can use to contact you for escalations to the SRT and to
     #   initiate proactive customer support.
     #
     #   To enable proactive engagement, the contact list must include at least
@@ -539,16 +538,16 @@ module Aws::Shield
       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
-    # an Amazon Route 53 hosted zone.
+    # Enables Shield Advanced for a specific Amazon Web Services resource.
+    # The resource can be an Amazon CloudFront distribution, Elastic Load
+    # Balancing load balancer, Global Accelerator accelerator, Elastic IP
+    # Address, or an Amazon Route 53 hosted zone.
     #
     # You can add protection to only a single resource with each
     # CreateProtection request. If you want to add protection to multiple
-    # resources at once, use the [AWS WAF console][1]. For more information
-    # see [Getting Started with AWS Shield Advanced][2] and [Add AWS Shield
-    # Advanced Protection to more AWS Resources][3].
+    # resources at once, use the [WAF console][1]. For more information see
+    # [Getting Started with Shield Advanced][2] and [Add Shield Advanced
+    # Protection to more Amazon Web Services Resources][3].
     #
     #
     #
@@ -572,10 +571,10 @@ module Aws::Shield
     #     `arn:aws:elasticloadbalancing:region:account-id:loadbalancer/load-balancer-name
     #     `
     #
-    #   * For an AWS CloudFront distribution:
+    #   * For an Amazon CloudFront distribution:
     #     `arn:aws:cloudfront::account-id:distribution/distribution-id `
     #
-    #   * For an AWS Global Accelerator accelerator:
+    #   * For an Global Accelerator accelerator:
     #     `arn:aws:globalaccelerator::account-id:accelerator/accelerator-id `
     #
     #   * For Amazon Route 53: `arn:aws:route53:::hostedzone/hosted-zone-id `
@@ -627,8 +626,8 @@ module Aws::Shield
     #   example to update, delete, or describe it.
     #
     # @option params [required, String] :aggregation
-    #   Defines how AWS Shield combines resource data for the group in order
-    #   to detect, mitigate, and report events.
+    #   Defines how Shield combines resource data for the group in order to
+    #   detect, mitigate, and report events.
     #
     #   * Sum - Use the total traffic across the group. This is a good choice
     #     for most cases. Examples include Elastic IP addresses for EC2
@@ -640,8 +639,8 @@ module Aws::Shield
     #
     #   * Max - Use the highest traffic from each resource. This is useful for
     #     resources that don't share traffic and for resources that share
-    #     that traffic in a non-uniform way. Examples include CloudFront
-    #     distributions and origin resources for CloudFront distributions.
+    #     that traffic in a non-uniform way. Examples include Amazon
+    #     CloudFront and origin resources for CloudFront distributions.
     #
     # @option params [required, String] :pattern
     #   The criteria to use to choose the protected resources for inclusion in
@@ -691,7 +690,7 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Activates AWS Shield Advanced for an account.
+    # Activates Shield Advanced for an account.
     #
     # When you initally create a subscription, your subscription is set to
     # be automatically renewed at the end of the existing subscription
@@ -709,7 +708,7 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Deletes an AWS Shield Advanced Protection.
+    # Deletes an Shield Advanced Protection.
     #
     # @option params [required, String] :protection_id
     #   The unique identifier (ID) for the Protection object to be deleted.
@@ -755,9 +754,9 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Removes AWS Shield Advanced from an account. AWS Shield Advanced
-    # requires a 1-year subscription commitment. You cannot delete a
-    # subscription prior to the completion of that commitment.
+    # Removes Shield Advanced from an account. Shield Advanced requires a
+    # 1-year subscription commitment. You cannot delete a subscription prior
+    # to the completion of that commitment.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -837,8 +836,8 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Provides information about the number and type of attacks AWS Shield
-    # has detected in the last year for all resources that belong to your
+    # Provides information about the number and type of attacks Shield has
+    # detected in the last year for all resources that belong to your
     # account, regardless of whether you've defined Shield protections for
     # them. This operation is available to Shield customers as well as to
     # Shield Advanced customers.
@@ -877,8 +876,8 @@ 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
-    # with attack mitigation.
+    # Shield Response Team (SRT) to access your Amazon Web Services account
+    # while assisting with attack mitigation.
     #
     # @return [Types::DescribeDRTAccessResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -900,9 +899,9 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # 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
+    # A list of email addresses and phone numbers that the Shield Response
+    # Team (SRT) can use to contact you if you have proactive engagement
+    # enabled, for escalations to the SRT and to initiate proactive customer
     # support.
     #
     # @return [Types::DescribeEmergencyContactSettingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -933,10 +932,10 @@ module Aws::Shield
     #   provide either the `ResourceArn` or the `ProtectionID`, but not both.
     #
     # @option params [String] :resource_arn
-    #   The ARN (Amazon Resource Name) of the AWS resource for the Protection
-    #   object that is described. When submitting the `DescribeProtection`
-    #   request you must provide either the `ResourceArn` or the
-    #   `ProtectionID`, but not both.
+    #   The ARN (Amazon Resource Name) of the Amazon Web Services resource for
+    #   the Protection object that is described. When submitting the
+    #   `DescribeProtection` request you must provide either the `ResourceArn`
+    #   or the `ProtectionID`, but not both.
     #
     # @return [Types::DescribeProtectionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1003,7 +1002,7 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Provides details about the AWS Shield Advanced subscription for an
+    # Provides details about the Shield Advanced subscription for an
     # account.
     #
     # @return [Types::DescribeSubscriptionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1036,8 +1035,8 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Removes authorization from the DDoS Response Team (DRT) to notify
-    # contacts about escalations to the DRT and to initiate proactive
+    # Removes authorization from the Shield Response Team (SRT) to notify
+    # contacts about escalations to the SRT and to initiate proactive
     # customer support.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -1051,13 +1050,13 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Removes the DDoS Response Team's (DRT) access to the specified Amazon
-    # S3 bucket containing your AWS WAF logs.
+    # Removes the Shield Response Team's (SRT) access to the specified
+    # Amazon S3 bucket containing the logs that you shared previously.
     #
     # To make a `DisassociateDRTLogBucket` request, you must be subscribed
     # to the [Business Support plan][1] or the [Enterprise Support plan][2].
     # However, if you are not subscribed to one of these support plans, but
-    # had been previously and had granted the DRT access to your account,
+    # had been previously and had granted the SRT access to your account,
     # you can submit a `DisassociateDRTLogBucket` request to remove this
     # access.
     #
@@ -1067,7 +1066,7 @@ module Aws::Shield
     # [2]: https://aws.amazon.com/premiumsupport/enterprise-support/
     #
     # @option params [required, String] :log_bucket
-    #   The Amazon S3 bucket that contains your AWS WAF logs.
+    #   The Amazon S3 bucket that contains the logs that you want to share.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1086,12 +1085,13 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Removes the DDoS Response Team's (DRT) access to your AWS account.
+    # Removes the Shield Response Team's (SRT) access to your Amazon Web
+    # Services account.
     #
     # To make a `DisassociateDRTRole` request, you must be subscribed to the
     # [Business Support plan][1] or the [Enterprise Support plan][2].
     # However, if you are not subscribed to one of these support plans, but
-    # had been previously and had granted the DRT access to your account,
+    # had been previously and had granted the SRT access to your account,
     # you can submit a `DisassociateDRTRole` request to remove this access.
     #
     #
@@ -1112,18 +1112,17 @@ module Aws::Shield
 
     # Removes health-based detection from the Shield Advanced protection for
     # a resource. Shield Advanced health-based detection uses the health of
-    # your AWS resource to improve responsiveness and accuracy in attack
-    # detection and mitigation.
+    # your Amazon Web Services resource to improve responsiveness and
+    # accuracy in attack detection and mitigation.
     #
     # You define the health check in Route 53 and then associate or
     # disassociate it with your Shield Advanced protection. For more
     # information, see [Shield Advanced Health-Based Detection][1] in the
-    # [AWS WAF and AWS Shield Developer Guide][2].
+    # *WAF Developer Guide*.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/waf/latest/developerguide/ddos-overview.html#ddos-advanced-health-check-option
-    # [2]: https://docs.aws.amazon.com/waf/latest/developerguide/
     #
     # @option params [required, String] :protection_id
     #   The unique identifier (ID) for the Protection object to remove the
@@ -1151,8 +1150,8 @@ 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
+    # Authorizes the Shield Response Team (SRT) to use email and phone to
+    # notify contacts about escalations to the SRT and to initiate proactive
     # customer support.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -1426,8 +1425,8 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Gets information about AWS tags for a specified Amazon Resource Name
-    # (ARN) in AWS Shield.
+    # Gets information about Amazon Web Services tags for a specified Amazon
+    # Resource Name (ARN) in Shield.
     #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the resource to get tags for.
@@ -1457,7 +1456,7 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Adds or updates tags for a resource in AWS Shield.
+    # Adds or updates tags for a resource in Shield.
     #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the resource that you want to add or
@@ -1489,7 +1488,7 @@ module Aws::Shield
       req.send_request(options)
     end
 
-    # Removes tags from a resource in AWS Shield.
+    # Removes tags from a resource in Shield.
     #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the resource that you want to remove
@@ -1517,14 +1516,14 @@ module Aws::Shield
     end
 
     # 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
+    # that the Shield Response Team (SRT) can use to contact you if you have
+    # proactive engagement enabled, for escalations to the SRT and to
     # initiate proactive customer support.
     #
     # @option params [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 if you have proactive engagement
-    #   enabled, for escalations to the DRT and to initiate proactive customer
+    #   A list of email addresses and phone numbers that the Shield Response
+    #   Team (SRT) can use to contact you if you have proactive engagement
+    #   enabled, for escalations to the SRT and to initiate proactive customer
     #   support.
     #
     #   If you have proactive engagement enabled, the contact list must
@@ -1564,8 +1563,8 @@ module Aws::Shield
     #   example to update, delete, or describe it.
     #
     # @option params [required, String] :aggregation
-    #   Defines how AWS Shield combines resource data for the group in order
-    #   to detect, mitigate, and report events.
+    #   Defines how Shield combines resource data for the group in order to
+    #   detect, mitigate, and report events.
     #
     #   * Sum - Use the total traffic across the group. This is a good choice
     #     for most cases. Examples include Elastic IP addresses for EC2
@@ -1577,8 +1576,9 @@ module Aws::Shield
     #
     #   * Max - Use the highest traffic from each resource. This is useful for
     #     resources that don't share traffic and for resources that share
-    #     that traffic in a non-uniform way. Examples include CloudFront
-    #     distributions and origin resources for CloudFront distributions.
+    #     that traffic in a non-uniform way. Examples include Amazon
+    #     CloudFront distributions and origin resources for CloudFront
+    #     distributions.
     #
     # @option params [required, String] :pattern
     #   The criteria to use to choose the protected resources for inclusion in
@@ -1659,7 +1659,7 @@ module Aws::Shield
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-shield'
-      context[:gem_version] = '1.37.0'
+      context[:gem_version] = '1.38.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -25,11 +25,11 @@ module Aws::Shield
       include Aws::Structure
     end
 
-    # In order to grant the necessary access to the DDoS Response Team
-    # (DRT), the user submitting the request must have the `iam:PassRole`
+    # In order to grant the necessary access to the Shield Response Team
+    # (SRT) 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].
+    # Pass a Role to an Amazon Web Services Service][1].
     #
     #
     #
@@ -54,7 +54,7 @@ module Aws::Shield
     #       }
     #
     # @!attribute [rw] log_bucket
-    #   The Amazon S3 bucket that contains your AWS WAF logs.
+    #   The Amazon S3 bucket that contains the logs that you want to share.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/AssociateDRTLogBucketRequest AWS API Documentation
@@ -77,8 +77,8 @@ module Aws::Shield
     #       }
     #
     # @!attribute [rw] role_arn
-    #   The Amazon Resource Name (ARN) of the role the DRT will use to
-    #   access your AWS account.
+    #   The Amazon Resource Name (ARN) of the role the SRT will use to
+    #   access your Amazon Web Services account.
     #
     #   Prior to making the `AssociateDRTRole` request, you must attach the
     #   [AWSShieldDRTAccessPolicy][1] managed policy to this role. For more
@@ -147,8 +147,8 @@ module Aws::Shield
     #       }
     #
     # @!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
+    #   A list of email addresses and phone numbers that the Shield Response
+    #   Team (SRT) can use to contact you for escalations to the SRT and to
     #   initiate proactive customer support.
     #
     #   To enable proactive engagement, the contact list must include at
@@ -213,7 +213,16 @@ module Aws::Shield
     #   @return [Array<Types::SummarizedCounter>]
     #
     # @!attribute [rw] attack_properties
-    #   The array of AttackProperty objects.
+    #   The array of objects that provide details of the Shield event.
+    #
+    #   For infrastructure layer events (L3 and L4 events) after January 25,
+    #   2021, you can view metrics for top contributors in Amazon CloudWatch
+    #   metrics. For more information, see [Shield metrics and alarms][1] in
+    #   the *WAF Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/waf/latest/developerguide/monitoring-cloudwatch.html#set-ddos-alarms
     #   @return [Array<Types::AttackProperty>]
     #
     # @!attribute [rw] mitigations
@@ -235,33 +244,41 @@ module Aws::Shield
       include Aws::Structure
     end
 
-    # Details of the described attack.
+    # Details of a Shield event. This is provided as part of an
+    # AttackDetail.
     #
     # @!attribute [rw] attack_layer
-    #   The type of distributed denial of service (DDoS) event that was
-    #   observed. `NETWORK` indicates layer 3 and layer 4 events and
-    #   `APPLICATION` indicates layer 7 events.
+    #   The type of Shield event that was observed. `NETWORK` indicates
+    #   layer 3 and layer 4 events and `APPLICATION` indicates layer 7
+    #   events.
+    #
+    #   For infrastructure layer events (L3 and L4 events) after January 25,
+    #   2021, you can view metrics for top contributors in Amazon CloudWatch
+    #   metrics. For more information, see [Shield metrics and alarms][1] in
+    #   the *WAF Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/waf/latest/developerguide/monitoring-cloudwatch.html#set-ddos-alarms
     #   @return [String]
     #
     # @!attribute [rw] attack_property_identifier
-    #   Defines the DDoS attack property information that is provided. The
+    #   Defines the Shield event property information that is provided. The
     #   `WORDPRESS_PINGBACK_REFLECTOR` and `WORDPRESS_PINGBACK_SOURCE`
-    #   values are valid only for WordPress reflective pingback DDoS
-    #   attacks.
+    #   values are valid only for WordPress reflective pingback events.
     #   @return [String]
     #
     # @!attribute [rw] top_contributors
-    #   The array of contributor objects that includes the top five
-    #   contributors to an attack.
+    #   Contributor objects for the top five contributors to a Shield event.
     #   @return [Array<Types::Contributor>]
     #
     # @!attribute [rw] unit
-    #   The unit of the `Value` of the contributions.
+    #   The unit used for the `Contributor` `Value` property.
     #   @return [String]
     #
     # @!attribute [rw] total
-    #   The total contributions made to this attack by all contributors, not
-    #   just the five listed in the `TopContributors` list.
+    #   The total contributions made to this Shield event by all
+    #   contributors.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/AttackProperty AWS API Documentation
@@ -485,8 +502,8 @@ module Aws::Shield
     #   @return [String]
     #
     # @!attribute [rw] aggregation
-    #   Defines how AWS Shield combines resource data for the group in order
-    #   to detect, mitigate, and report events.
+    #   Defines how Shield combines resource data for the group in order to
+    #   detect, mitigate, and report events.
     #
     #   * Sum - Use the total traffic across the group. This is a good
     #     choice for most cases. Examples include Elastic IP addresses for
@@ -498,9 +515,8 @@ module Aws::Shield
     #
     #   * Max - Use the highest traffic from each resource. This is useful
     #     for resources that don't share traffic and for resources that
-    #     share that traffic in a non-uniform way. Examples include
-    #     CloudFront distributions and origin resources for CloudFront
-    #     distributions.
+    #     share that traffic in a non-uniform way. Examples include Amazon
+    #     CloudFront and origin resources for CloudFront distributions.
     #   @return [String]
     #
     # @!attribute [rw] pattern
@@ -577,10 +593,10 @@ module Aws::Shield
     #     `arn:aws:elasticloadbalancing:region:account-id:loadbalancer/load-balancer-name
     #     `
     #
-    #   * For an AWS CloudFront distribution:
+    #   * For an Amazon CloudFront distribution:
     #     `arn:aws:cloudfront::account-id:distribution/distribution-id `
     #
-    #   * For an AWS Global Accelerator accelerator:
+    #   * For an Global Accelerator accelerator:
     #     `arn:aws:globalaccelerator::account-id:accelerator/accelerator-id
     #     `
     #
@@ -748,12 +764,12 @@ module Aws::Shield
     class DescribeDRTAccessRequest < Aws::EmptyStructure; end
 
     # @!attribute [rw] role_arn
-    #   The Amazon Resource Name (ARN) of the role the DRT used to access
-    #   your AWS account.
+    #   The Amazon Resource Name (ARN) of the role the SRT used to access
+    #   your Amazon Web Services account.
     #   @return [String]
     #
     # @!attribute [rw] log_bucket_list
-    #   The list of Amazon S3 buckets accessed by the DRT.
+    #   The list of Amazon S3 buckets accessed by the SRT.
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DescribeDRTAccessResponse AWS API Documentation
@@ -772,9 +788,9 @@ module Aws::Shield
     class DescribeEmergencyContactSettingsRequest < Aws::EmptyStructure; end
 
     # @!attribute [rw] emergency_contact_list
-    #   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
+    #   A list of email addresses and phone numbers that the Shield Response
+    #   Team (SRT) can use to contact you if you have proactive engagement
+    #   enabled, for escalations to the SRT and to initiate proactive
     #   customer support.
     #   @return [Array<Types::EmergencyContact>]
     #
@@ -808,8 +824,8 @@ module Aws::Shield
     end
 
     # @!attribute [rw] protection_group
-    #   A grouping of protected resources that you and AWS Shield Advanced
-    #   can monitor as a collective. This resource grouping improves the
+    #   A grouping of protected resources that you and Shield Advanced can
+    #   monitor as a collective. This resource grouping improves the
     #   accuracy of detection and reduces false positives.
     #   @return [Types::ProtectionGroup]
     #
@@ -837,8 +853,8 @@ module Aws::Shield
     #   @return [String]
     #
     # @!attribute [rw] resource_arn
-    #   The ARN (Amazon Resource Name) of the AWS resource for the
-    #   Protection object that is described. When submitting the
+    #   The ARN (Amazon Resource Name) of the Amazon Web Services resource
+    #   for the Protection object that is described. When submitting the
     #   `DescribeProtection` request you must provide either the
     #   `ResourceArn` or the `ProtectionID`, but not both.
     #   @return [String]
@@ -871,7 +887,7 @@ module Aws::Shield
     class DescribeSubscriptionRequest < Aws::EmptyStructure; end
 
     # @!attribute [rw] subscription
-    #   The AWS Shield Advanced subscription details for an account.
+    #   The Shield Advanced subscription details for an account.
     #   @return [Types::Subscription]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DescribeSubscriptionResponse AWS API Documentation
@@ -900,7 +916,7 @@ module Aws::Shield
     #       }
     #
     # @!attribute [rw] log_bucket
-    #   The Amazon S3 bucket that contains your AWS WAF logs.
+    #   The Amazon S3 bucket that contains the logs that you want to share.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DisassociateDRTLogBucketRequest AWS API Documentation
@@ -956,8 +972,8 @@ module Aws::Shield
     #
     class DisassociateHealthCheckResponse < Aws::EmptyStructure; end
 
-    # Contact information that the DRT can use to contact you if you have
-    # proactive engagement enabled, for escalations to the DRT and to
+    # Contact information that the SRT can use to contact you if you have
+    # proactive engagement enabled, for escalations to the SRT and to
     # initiate proactive customer support.
     #
     # @note When making an API call, you may pass EmergencyContact
@@ -1282,9 +1298,9 @@ module Aws::Shield
     #
     # @!attribute [rw] next_token
     #   If you specify a value for `MaxResults` and you have more protection
-    #   groups than the value of MaxResults, AWS Shield Advanced returns
-    #   this token that you can use in your next request, to get the next
-    #   batch of objects.
+    #   groups than the value of MaxResults, Shield Advanced returns this
+    #   token that you can use in your next request, to get the next batch
+    #   of objects.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/ListProtectionGroupsResponse AWS API Documentation
@@ -1336,12 +1352,11 @@ module Aws::Shield
     #
     # @!attribute [rw] next_token
     #   If you specify a value for `MaxResults` and you have more
-    #   Protections than the value of MaxResults, AWS Shield Advanced
-    #   returns a NextToken value in the response that allows you to list
-    #   another group of Protections. For the second and subsequent
-    #   ListProtections requests, specify the value of NextToken from the
-    #   previous response to get information about another batch of
-    #   Protections.
+    #   Protections than the value of MaxResults, Shield Advanced returns a
+    #   NextToken value in the response that allows you to list another
+    #   group of Protections. For the second and subsequent ListProtections
+    #   requests, specify the value of NextToken from the previous response
+    #   to get information about another batch of Protections.
     #
     #   Shield Advanced might return the list of Protection objects in
     #   batches smaller than the number specified by MaxResults. If there
@@ -1408,7 +1423,7 @@ module Aws::Shield
     #
     # @!attribute [rw] next_token
     #   If you specify a value for `MaxResults` and you have more resources
-    #   in the protection group than the value of MaxResults, AWS Shield
+    #   in the protection group than the value of MaxResults, Shield
     #   Advanced returns this token that you can use in your next request,
     #   to get the next batch of objects.
     #   @return [String]
@@ -1523,8 +1538,8 @@ module Aws::Shield
     #   @return [String]
     #
     # @!attribute [rw] resource_arn
-    #   The ARN (Amazon Resource Name) of the AWS resource that is
-    #   protected.
+    #   The ARN (Amazon Resource Name) of the Amazon Web Services resource
+    #   that is protected.
     #   @return [String]
     #
     # @!attribute [rw] health_check_ids
@@ -1548,7 +1563,7 @@ module Aws::Shield
       include Aws::Structure
     end
 
-    # A grouping of protected resources that you and AWS Shield Advanced can
+    # A grouping of protected resources that you and Shield Advanced can
     # monitor as a collective. This resource grouping improves the accuracy
     # of detection and reduces false positives.
     #
@@ -1559,8 +1574,8 @@ module Aws::Shield
     #   @return [String]
     #
     # @!attribute [rw] aggregation
-    #   Defines how AWS Shield combines resource data for the group in order
-    #   to detect, mitigate, and report events.
+    #   Defines how Shield combines resource data for the group in order to
+    #   detect, mitigate, and report events.
     #
     #   * Sum - Use the total traffic across the group. This is a good
     #     choice for most cases. Examples include Elastic IP addresses for
@@ -1572,7 +1587,7 @@ module Aws::Shield
     #
     #   * Max - Use the highest traffic from each resource. This is useful
     #     for resources that don't share traffic and for resources that
-    #     share that traffic in a non-uniform way. Examples include
+    #     share that traffic in a non-uniform way. Examples include Amazon
     #     CloudFront distributions and origin resources for CloudFront
     #     distributions.
     #   @return [String]
@@ -1747,7 +1762,7 @@ module Aws::Shield
       include Aws::Structure
     end
 
-    # Information about the AWS Shield Advanced subscription for an account.
+    # Information about the Shield Advanced subscription for an account.
     #
     # @!attribute [rw] start_time
     #   The start time of the subscription, in Unix time in seconds. For
@@ -1763,8 +1778,8 @@ module Aws::Shield
     #   @return [Time]
     #
     # @!attribute [rw] time_commitment_in_seconds
-    #   The length, in seconds, of the AWS Shield Advanced subscription for
-    #   the account.
+    #   The length, in seconds, of the Shield Advanced subscription for the
+    #   account.
     #   @return [Integer]
     #
     # @!attribute [rw] auto_renew
@@ -1783,15 +1798,15 @@ module Aws::Shield
     #   @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 `ENABLED`, the Shield Response Team (SRT) will use email and
+    #   phone to notify contacts about escalations to the SRT 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
+    #   If `DISABLED`, the SRT will not proactively notify contacts about
     #   escalations or to initiate proactive customer support.
     #   @return [String]
     #
@@ -1895,15 +1910,15 @@ module Aws::Shield
       include Aws::Structure
     end
 
-    # A tag associated with an AWS resource. Tags are key:value pairs that
-    # you can use to categorize and manage your resources, for purposes like
-    # billing or other management. Typically, the tag key represents a
-    # category, such as "environment", and the tag value represents a
-    # specific value within that category, such as "test,"
-    # "development," or "production". Or you might set the tag key to
-    # "customer" and the value to the customer name or ID. You can specify
-    # one or more tags to add to each AWS resource, up to 50 tags for a
-    # resource.
+    # A tag associated with an Amazon Web Services resource. Tags are
+    # key:value pairs that you can use to categorize and manage your
+    # resources, for purposes like billing or other management. Typically,
+    # the tag key represents a category, such as "environment", and the
+    # tag value represents a specific value within that category, such as
+    # "test," "development," or "production". Or you might set the tag
+    # key to "customer" and the value to the customer name or ID. You can
+    # specify one or more tags to add to each Amazon Web Services resource,
+    # up to 50 tags for a resource.
     #
     # @note When making an API call, you may pass Tag
     #   data as a hash:
@@ -2050,9 +2065,9 @@ module Aws::Shield
     #       }
     #
     # @!attribute [rw] emergency_contact_list
-    #   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
+    #   A list of email addresses and phone numbers that the Shield Response
+    #   Team (SRT) can use to contact you if you have proactive engagement
+    #   enabled, for escalations to the SRT and to initiate proactive
     #   customer support.
     #
     #   If you have proactive engagement enabled, the contact list must
@@ -2089,8 +2104,8 @@ module Aws::Shield
     #   @return [String]
     #
     # @!attribute [rw] aggregation
-    #   Defines how AWS Shield combines resource data for the group in order
-    #   to detect, mitigate, and report events.
+    #   Defines how Shield combines resource data for the group in order to
+    #   detect, mitigate, and report events.
     #
     #   * Sum - Use the total traffic across the group. This is a good
     #     choice for most cases. Examples include Elastic IP addresses for
@@ -2102,7 +2117,7 @@ module Aws::Shield
     #
     #   * Max - Use the highest traffic from each resource. This is useful
     #     for resources that don't share traffic and for resources that
-    #     share that traffic in a non-uniform way. Examples include
+    #     share that traffic in a non-uniform way. Examples include Amazon
     #     CloudFront distributions and origin resources for CloudFront
     #     distributions.
     #   @return [String]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-shield
 version: !ruby/object:Gem::Version
-  version: 1.37.0
+  version: 1.38.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-09 00:00:00.000000000 Z
+date: 2021-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -83,8 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6.2
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: AWS SDK for Ruby - AWS Shield