aws-sdk-shield 1.21.0 → 1.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bf2b5f4ed8603990312668c846eef13010164bba
-  data.tar.gz: a2e77785b00ae370b183bc2ed61b250450bb1f88
+  metadata.gz: bf80c0a4bb5eba49b6f3d3bbac237a8b459c0a6d
+  data.tar.gz: '018327507ab5013ec326504ce6dbadcfc1fc4677'
 SHA512:
-  metadata.gz: 0ee0bbb44f33eb330beecda84f3aaa8ddcfde86c277f197c721e01e36aef2d8ac3a2f539deac47d869e385aafd19fb5ead690f7e4cb05cd4231eb2284e84805c
-  data.tar.gz: 364f60d68c47e5abfb8015519b45ecf9f780acf11601b1e09c4cd6de653eb214a7c579d2680c249e2329d71b163311b04e3999deb6c976b3a54445f5360507e8
+  metadata.gz: 45b02384d9db5782d0a73beb9cf8ccf072a3abfc6327154c7ddd3cbc39e5ca3039e2eabc5cb9add3516a9a4a2b1d7fbcc3e7017c5c4c8d7554b2f35ce241aa18
+  data.tar.gz: a74eacd974c669c16e4a9704fa07d76a668767067974ae93e37a478e2e9e182c6e06c4e4a3e3f05cfbe85737d72c6b6e75eabbe452a325c9148b22c6915c5a7e

data/lib/aws-sdk-shield.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-shield/customizations'
 # @service
 module Aws::Shield
 
-  GEM_VERSION = '1.21.0'
+  GEM_VERSION = '1.22.0'
 
 end

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

@@ -368,6 +368,47 @@ module Aws::Shield
       req.send_request(options)
     end
 
+    # 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.
+    #
+    # 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].
+    #
+    #
+    #
+    # [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
+    #   check association to.
+    #
+    # @option params [required, String] :health_check_arn
+    #   The Amazon Resource Name (ARN) of the health check to associate with
+    #   the protection.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.associate_health_check({
+    #     protection_id: "ProtectionId", # required
+    #     health_check_arn: "HealthCheckArn", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/AssociateHealthCheck AWS API Documentation
+    #
+    # @overload associate_health_check(params = {})
+    # @param [Hash] params ({})
+    def associate_health_check(params = {}, options = {})
+      req = build_request(:associate_health_check, 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
@@ -647,6 +688,8 @@ module Aws::Shield
     #   resp.protection.id #=> String
     #   resp.protection.name #=> String
     #   resp.protection.resource_arn #=> String
+    #   resp.protection.health_check_ids #=> Array
+    #   resp.protection.health_check_ids[0] #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DescribeProtection AWS API Documentation
     #
@@ -742,6 +785,47 @@ module Aws::Shield
       req.send_request(options)
     end
 
+    # 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.
+    #
+    # 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].
+    #
+    #
+    #
+    # [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
+    #   health check association from.
+    #
+    # @option params [required, String] :health_check_arn
+    #   The Amazon Resource Name (ARN) of the health check that is associated
+    #   with the protection.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.disassociate_health_check({
+    #     protection_id: "ProtectionId", # required
+    #     health_check_arn: "HealthCheckArn", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DisassociateHealthCheck AWS API Documentation
+    #
+    # @overload disassociate_health_check(params = {})
+    # @param [Hash] params ({})
+    def disassociate_health_check(params = {}, options = {})
+      req = build_request(:disassociate_health_check, 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:
@@ -879,6 +963,8 @@ module Aws::Shield
     #   resp.protections[0].id #=> String
     #   resp.protections[0].name #=> String
     #   resp.protections[0].resource_arn #=> String
+    #   resp.protections[0].health_check_ids #=> Array
+    #   resp.protections[0].health_check_ids[0] #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/ListProtections AWS API Documentation
@@ -959,7 +1045,7 @@ module Aws::Shield
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-shield'
-      context[:gem_version] = '1.21.0'
+      context[:gem_version] = '1.22.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -17,6 +17,8 @@ module Aws::Shield
     AssociateDRTLogBucketResponse = Shapes::StructureShape.new(name: 'AssociateDRTLogBucketResponse')
     AssociateDRTRoleRequest = Shapes::StructureShape.new(name: 'AssociateDRTRoleRequest')
     AssociateDRTRoleResponse = Shapes::StructureShape.new(name: 'AssociateDRTRoleResponse')
+    AssociateHealthCheckRequest = Shapes::StructureShape.new(name: 'AssociateHealthCheckRequest')
+    AssociateHealthCheckResponse = Shapes::StructureShape.new(name: 'AssociateHealthCheckResponse')
     AttackDetail = Shapes::StructureShape.new(name: 'AttackDetail')
     AttackId = Shapes::StringShape.new(name: 'AttackId')
     AttackLayer = Shapes::StringShape.new(name: 'AttackLayer')
@@ -52,6 +54,8 @@ module Aws::Shield
     DisassociateDRTLogBucketResponse = Shapes::StructureShape.new(name: 'DisassociateDRTLogBucketResponse')
     DisassociateDRTRoleRequest = Shapes::StructureShape.new(name: 'DisassociateDRTRoleRequest')
     DisassociateDRTRoleResponse = Shapes::StructureShape.new(name: 'DisassociateDRTRoleResponse')
+    DisassociateHealthCheckRequest = Shapes::StructureShape.new(name: 'DisassociateHealthCheckRequest')
+    DisassociateHealthCheckResponse = Shapes::StructureShape.new(name: 'DisassociateHealthCheckResponse')
     Double = Shapes::FloatShape.new(name: 'Double')
     DurationInSeconds = Shapes::IntegerShape.new(name: 'DurationInSeconds')
     EmailAddress = Shapes::StringShape.new(name: 'EmailAddress')
@@ -59,6 +63,9 @@ module Aws::Shield
     EmergencyContactList = Shapes::ListShape.new(name: 'EmergencyContactList')
     GetSubscriptionStateRequest = Shapes::StructureShape.new(name: 'GetSubscriptionStateRequest')
     GetSubscriptionStateResponse = Shapes::StructureShape.new(name: 'GetSubscriptionStateResponse')
+    HealthCheckArn = Shapes::StringShape.new(name: 'HealthCheckArn')
+    HealthCheckId = Shapes::StringShape.new(name: 'HealthCheckId')
+    HealthCheckIds = Shapes::ListShape.new(name: 'HealthCheckIds')
     Integer = Shapes::IntegerShape.new(name: 'Integer')
     InternalErrorException = Shapes::StructureShape.new(name: 'InternalErrorException')
     InvalidOperationException = Shapes::StructureShape.new(name: 'InvalidOperationException')
@@ -129,6 +136,12 @@ module Aws::Shield
 
     AssociateDRTRoleResponse.struct_class = Types::AssociateDRTRoleResponse
 
+    AssociateHealthCheckRequest.add_member(:protection_id, Shapes::ShapeRef.new(shape: ProtectionId, required: true, location_name: "ProtectionId"))
+    AssociateHealthCheckRequest.add_member(:health_check_arn, Shapes::ShapeRef.new(shape: HealthCheckArn, required: true, location_name: "HealthCheckArn"))
+    AssociateHealthCheckRequest.struct_class = Types::AssociateHealthCheckRequest
+
+    AssociateHealthCheckResponse.struct_class = Types::AssociateHealthCheckResponse
+
     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"))
@@ -224,6 +237,12 @@ module Aws::Shield
 
     DisassociateDRTRoleResponse.struct_class = Types::DisassociateDRTRoleResponse
 
+    DisassociateHealthCheckRequest.add_member(:protection_id, Shapes::ShapeRef.new(shape: ProtectionId, required: true, location_name: "ProtectionId"))
+    DisassociateHealthCheckRequest.add_member(:health_check_arn, Shapes::ShapeRef.new(shape: HealthCheckArn, required: true, location_name: "HealthCheckArn"))
+    DisassociateHealthCheckRequest.struct_class = Types::DisassociateHealthCheckRequest
+
+    DisassociateHealthCheckResponse.struct_class = Types::DisassociateHealthCheckResponse
+
     EmergencyContact.add_member(:email_address, Shapes::ShapeRef.new(shape: EmailAddress, required: true, location_name: "EmailAddress"))
     EmergencyContact.struct_class = Types::EmergencyContact
 
@@ -234,6 +253,8 @@ module Aws::Shield
     GetSubscriptionStateResponse.add_member(:subscription_state, Shapes::ShapeRef.new(shape: SubscriptionState, required: true, location_name: "SubscriptionState"))
     GetSubscriptionStateResponse.struct_class = Types::GetSubscriptionStateResponse
 
+    HealthCheckIds.member = Shapes::ShapeRef.new(shape: HealthCheckId)
+
     InternalErrorException.add_member(:message, Shapes::ShapeRef.new(shape: errorMessage, location_name: "message"))
     InternalErrorException.struct_class = Types::InternalErrorException
 
@@ -298,6 +319,7 @@ module Aws::Shield
     Protection.add_member(:id, Shapes::ShapeRef.new(shape: ProtectionId, location_name: "Id"))
     Protection.add_member(:name, Shapes::ShapeRef.new(shape: ProtectionName, location_name: "Name"))
     Protection.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ResourceArn, location_name: "ResourceArn"))
+    Protection.add_member(:health_check_ids, Shapes::ShapeRef.new(shape: HealthCheckIds, location_name: "HealthCheckIds"))
     Protection.struct_class = Types::Protection
 
     Protections.member = Shapes::ShapeRef.new(shape: Protection)
@@ -406,6 +428,19 @@ module Aws::Shield
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
 
+      api.add_operation(:associate_health_check, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "AssociateHealthCheck"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: AssociateHealthCheckRequest)
+        o.output = Shapes::ShapeRef.new(shape: AssociateHealthCheckResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitsExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        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"
@@ -531,6 +566,18 @@ module Aws::Shield
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
 
+      api.add_operation(:disassociate_health_check, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DisassociateHealthCheck"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DisassociateHealthCheckRequest)
+        o.output = Shapes::ShapeRef.new(shape: DisassociateHealthCheckResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
+        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"

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

@@ -23,8 +23,8 @@ module Aws::Shield
     end
 
     # In order to grant the necessary access to the DDoS Response Team, the
-    # user submitting `AssociateDRTRole` must have the `iam:PassRole`
-    # permission. This error indicates the user did not have the appropriate
+    # 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].
     #
@@ -96,6 +96,36 @@ module Aws::Shield
     #
     class AssociateDRTRoleResponse < Aws::EmptyStructure; end
 
+    # @note When making an API call, you may pass AssociateHealthCheckRequest
+    #   data as a hash:
+    #
+    #       {
+    #         protection_id: "ProtectionId", # required
+    #         health_check_arn: "HealthCheckArn", # required
+    #       }
+    #
+    # @!attribute [rw] protection_id
+    #   The unique identifier (ID) for the Protection object to add the
+    #   health check association to.
+    #   @return [String]
+    #
+    # @!attribute [rw] health_check_arn
+    #   The Amazon Resource Name (ARN) of the health check to associate with
+    #   the protection.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/AssociateHealthCheckRequest AWS API Documentation
+    #
+    class AssociateHealthCheckRequest < Struct.new(
+      :protection_id,
+      :health_check_arn)
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/AssociateHealthCheckResponse AWS API Documentation
+    #
+    class AssociateHealthCheckResponse < Aws::EmptyStructure; end
+
     # The details of a DDoS attack.
     #
     # @!attribute [rw] attack_id
@@ -571,6 +601,36 @@ module Aws::Shield
     #
     class DisassociateDRTRoleResponse < Aws::EmptyStructure; end
 
+    # @note When making an API call, you may pass DisassociateHealthCheckRequest
+    #   data as a hash:
+    #
+    #       {
+    #         protection_id: "ProtectionId", # required
+    #         health_check_arn: "HealthCheckArn", # required
+    #       }
+    #
+    # @!attribute [rw] protection_id
+    #   The unique identifier (ID) for the Protection object to remove the
+    #   health check association from.
+    #   @return [String]
+    #
+    # @!attribute [rw] health_check_arn
+    #   The Amazon Resource Name (ARN) of the health check that is
+    #   associated with the protection.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DisassociateHealthCheckRequest AWS API Documentation
+    #
+    class DisassociateHealthCheckRequest < Struct.new(
+      :protection_id,
+      :health_check_arn)
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/DisassociateHealthCheckResponse AWS API Documentation
+    #
+    class DisassociateHealthCheckResponse < Aws::EmptyStructure; end
+
     # Contact information that the DRT can use to contact you during a
     # suspected attack.
     #
@@ -945,12 +1005,18 @@ module Aws::Shield
     #   protected.
     #   @return [String]
     #
+    # @!attribute [rw] health_check_ids
+    #   The unique identifier (ID) for the Route 53 health check that's
+    #   associated with the protection.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/shield-2016-06-02/Protection AWS API Documentation
     #
     class Protection < Struct.new(
       :id,
       :name,
-      :resource_arn)
+      :resource_arn,
+      :health_check_ids)
       include Aws::Structure
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-shield
 version: !ruby/object:Gem::Version
-  version: 1.21.0
+  version: 1.22.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-23 00:00:00.000000000 Z
+date: 2020-02-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core