aws-sdk-route53recoverycluster 1.7.0 → 1.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b49cc7c4133b336aec708004d5c947ac62f29af47c5a09c6e6229cd8c5ba438d
-  data.tar.gz: 020ea5aa327a2c42d84463aed2e923218fa3a08e6832a97203a46da668a5580c
+  metadata.gz: f056cc69373080730ec362738dadfae29b85b71725c5fb4a115dffe9a0d93a7b
+  data.tar.gz: 41c963fcdad2d37d117b5d098ed9654b484a50838d13f8802f15c59ad458eec3
 SHA512:
-  metadata.gz: ffae0fdebce5235b0b16eebf7ba46f7150bc085a460ae1df8dd4e75a389c41aa016b51d8df90f28e638ed86b2751e99f3d82f9aadff19825945d34e59ef87f4b
-  data.tar.gz: 4f48faca949134412930272ab7e033a999235a5f2bb8f2d09acfb9a006bdc8d72afb1db6993522fb49d919170b5711974ffeeb2d16d6ab6c74d9ba0ae4ccce53
+  metadata.gz: fdcb8d7886a77419677e60b5691754f187344d6ad179e6d77bc74dae6224010009c50c37a9829e997883b471994170383b4ba689335c8ab9563ce6a427471709
+  data.tar.gz: f6c72de1f9feb7b61c6cb53c84afca7f1df171d3e6abb1ff015850eb4f69fb7862b8a94ac1f81ebf2c634d35d845171b0e76f56f3e1114602167005466a27919

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.10.0 (2022-02-28)
+------------------
+
+* Feature - This release adds a new API option to enable overriding safety rules to allow routing control state updates.
+
+1.9.0 (2022-02-24)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.8.0 (2022-02-03)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.7.0 (2021-12-21)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.7.0
+1.10.0

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

@@ -27,7 +27,9 @@ 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/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
+require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
@@ -74,7 +76,9 @@ module Aws::Route53RecoveryCluster
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
+    add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
 
@@ -359,22 +363,39 @@ module Aws::Route53RecoveryCluster
 
     # Get the state for a routing control. A routing control is a simple
     # on/off switch that you can use to route traffic to cells. When the
-    # state is On, traffic flows to a cell. When it's off, traffic does not
+    # state is On, traffic flows to a cell. When it's Off, traffic does not
     # flow.
     #
-    # Before you can create a routing control, you first must create a
-    # cluster to host the control. For more information, see
-    # [CreateCluster][1]. Access one of the endpoints for the cluster to get
-    # or update the routing control state to redirect traffic.
+    # Before you can create a routing control, you must first create a
+    # cluster to host the control in a control panel. For more information,
+    # see [ Create routing control structures][1] in the Amazon Route 53
+    # Application Recovery Controller Developer Guide. Then you access one
+    # of the endpoints for the cluster to get or update the routing control
+    # state to redirect traffic.
     #
-    # For more information about working with routing controls, see [Routing
-    # control][2] in the Route 53 Application Recovery Controller Developer
-    # Guide.
+    # *You must specify Regional endpoints when you work with API cluster
+    # operations to get or update routing control states in Application
+    # Recovery Controller.*
     #
+    # To see a code example for getting a routing control state, including
+    # accessing Regional cluster endpoints in sequence, see [API
+    # examples][2] in the Amazon Route 53 Application Recovery Controller
+    # Developer Guide.
     #
+    # Learn more about working with routing controls in the following topics
+    # in the Amazon Route 53 Application Recovery Controller Developer
+    # Guide:
     #
-    # [1]: https://docs.aws.amazon.com/recovery-cluster/latest/api/cluster.html
-    # [2]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.html
+    # * [ Viewing and updating routing control states][3]
+    #
+    # * [Working with routing controls overall][4]
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.create.html
+    # [2]: https://docs.aws.amazon.com/r53recovery/latest/dg/service_code_examples_actions.html
+    # [3]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.update.html
+    # [4]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.html
     #
     # @option params [required, String] :routing_control_arn
     #   The Amazon Resource Number (ARN) for the routing control that you want
@@ -407,15 +428,44 @@ module Aws::Route53RecoveryCluster
 
     # Set the state of the routing control to reroute traffic. You can set
     # the value to be On or Off. When the state is On, traffic flows to a
-    # cell. When it's off, traffic does not flow.
+    # cell. When it's Off, traffic does not flow.
+    #
+    # With Application Recovery Controller, you can add safety rules for
+    # routing controls, which are safeguards for routing control state
+    # updates that help prevent unexpected outcomes, like fail open traffic
+    # routing. However, there are scenarios when you might want to bypass
+    # the routing control safeguards that are enforced with safety rules
+    # that you've configured. For example, you might want to fail over
+    # quickly for disaster recovery, and one or more safety rules might be
+    # unexpectedly preventing you from updating a routing control state to
+    # reroute traffic. In a "break glass" scenario like this, you can
+    # override one or more safety rules to change a routing control state
+    # and fail over your application.
+    #
+    # The `SafetyRulesToOverride` property enables you override one or more
+    # safety rules and update routing control states. For more information,
+    # see [ Override safety rules to reroute traffic][1] in the Amazon Route
+    # 53 Application Recovery Controller Developer Guide.
     #
-    # For more information about working with routing controls, see [Routing
-    # control][1] in the Route 53 Application Recovery Controller Developer
-    # Guide.
+    # *You must specify Regional endpoints when you work with API cluster
+    # operations to get or update routing control states in Application
+    # Recovery Controller.*
     #
+    # To see a code example for getting a routing control state, including
+    # accessing Regional cluster endpoints in sequence, see [API
+    # examples][2] in the Amazon Route 53 Application Recovery Controller
+    # Developer Guide.
     #
+    # * [ Viewing and updating routing control states][3]
     #
-    # [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.html
+    # * [Working with routing controls overall][4]
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.override-safety-rule.html
+    # [2]: https://docs.aws.amazon.com/r53recovery/latest/dg/service_code_examples_actions.html
+    # [3]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.update.html
+    # [4]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.html
     #
     # @option params [required, String] :routing_control_arn
     #   The Amazon Resource Number (ARN) for the routing control that you want
@@ -425,6 +475,20 @@ module Aws::Route53RecoveryCluster
     #   The state of the routing control. You can set the value to be On or
     #   Off.
     #
+    # @option params [Array<String>] :safety_rules_to_override
+    #   The Amazon Resource Numbers (ARNs) for the safety rules that you want
+    #   to override when you're updating the state of a routing control. You
+    #   can override one safety rule or multiple safety rules by including one
+    #   or more ARNs, separated by commas.
+    #
+    #   For more information, see [ Override safety rules to reroute
+    #   traffic][1] in the Amazon Route 53 Application Recovery Controller
+    #   Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.override-safety-rule.html
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -432,6 +496,7 @@ module Aws::Route53RecoveryCluster
     #   resp = client.update_routing_control_state({
     #     routing_control_arn: "Arn", # required
     #     routing_control_state: "On", # required, accepts On, Off
+    #     safety_rules_to_override: ["Arn"],
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/UpdateRoutingControlState AWS API Documentation
@@ -445,19 +510,62 @@ module Aws::Route53RecoveryCluster
 
     # Set multiple routing control states. You can set the value for each
     # state to be On or Off. When the state is On, traffic flows to a cell.
-    # When it's off, traffic does not flow.
+    # When it's Off, traffic does not flow.
+    #
+    # With Application Recovery Controller, you can add safety rules for
+    # routing controls, which are safeguards for routing control state
+    # updates that help prevent unexpected outcomes, like fail open traffic
+    # routing. However, there are scenarios when you might want to bypass
+    # the routing control safeguards that are enforced with safety rules
+    # that you've configured. For example, you might want to fail over
+    # quickly for disaster recovery, and one or more safety rules might be
+    # unexpectedly preventing you from updating a routing control state to
+    # reroute traffic. In a "break glass" scenario like this, you can
+    # override one or more safety rules to change a routing control state
+    # and fail over your application.
+    #
+    # The `SafetyRulesToOverride` property enables you override one or more
+    # safety rules and update routing control states. For more information,
+    # see [ Override safety rules to reroute traffic][1] in the Amazon Route
+    # 53 Application Recovery Controller Developer Guide.
+    #
+    # *You must specify Regional endpoints when you work with API cluster
+    # operations to get or update routing control states in Application
+    # Recovery Controller.*
+    #
+    # To see a code example for getting a routing control state, including
+    # accessing Regional cluster endpoints in sequence, see [API
+    # examples][2] in the Amazon Route 53 Application Recovery Controller
+    # Developer Guide.
     #
-    # For more information about working with routing controls, see [Routing
-    # control][1] in the Route 53 Application Recovery Controller Developer
-    # Guide.
+    # * [ Viewing and updating routing control states][3]
     #
+    # * [Working with routing controls overall][4]
     #
     #
-    # [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.html
+    #
+    # [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.override-safety-rule.html
+    # [2]: https://docs.aws.amazon.com/r53recovery/latest/dg/service_code_examples_actions.html
+    # [3]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.update.html
+    # [4]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.html
     #
     # @option params [required, Array<Types::UpdateRoutingControlStateEntry>] :update_routing_control_state_entries
     #   A set of routing control entries that you want to update.
     #
+    # @option params [Array<String>] :safety_rules_to_override
+    #   The Amazon Resource Numbers (ARNs) for the safety rules that you want
+    #   to override when you're updating routing control states. You can
+    #   override one safety rule or multiple safety rules by including one or
+    #   more ARNs, separated by commas.
+    #
+    #   For more information, see [ Override safety rules to reroute
+    #   traffic][1] in the Amazon Route 53 Application Recovery Controller
+    #   Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.override-safety-rule.html
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -469,6 +577,7 @@ module Aws::Route53RecoveryCluster
     #         routing_control_state: "On", # required, accepts On, Off
     #       },
     #     ],
+    #     safety_rules_to_override: ["Arn"],
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/UpdateRoutingControlStates AWS API Documentation
@@ -493,7 +602,7 @@ module Aws::Route53RecoveryCluster
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-route53recoverycluster'
-      context[:gem_version] = '1.7.0'
+      context[:gem_version] = '1.10.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -15,6 +15,7 @@ module Aws::Route53RecoveryCluster
 
     AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException')
     Arn = Shapes::StringShape.new(name: 'Arn')
+    Arns = Shapes::ListShape.new(name: 'Arns')
     ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
     EndpointTemporarilyUnavailableException = Shapes::StructureShape.new(name: 'EndpointTemporarilyUnavailableException')
     GetRoutingControlStateRequest = Shapes::StructureShape.new(name: 'GetRoutingControlStateRequest')
@@ -39,6 +40,8 @@ module Aws::Route53RecoveryCluster
     AccessDeniedException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
     AccessDeniedException.struct_class = Types::AccessDeniedException
 
+    Arns.member = Shapes::ShapeRef.new(shape: Arn)
+
     ConflictException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
     ConflictException.add_member(:resource_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "resourceId"))
     ConflictException.add_member(:resource_type, Shapes::ShapeRef.new(shape: String, required: true, location_name: "resourceType"))
@@ -75,11 +78,13 @@ module Aws::Route53RecoveryCluster
 
     UpdateRoutingControlStateRequest.add_member(:routing_control_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "RoutingControlArn"))
     UpdateRoutingControlStateRequest.add_member(:routing_control_state, Shapes::ShapeRef.new(shape: RoutingControlState, required: true, location_name: "RoutingControlState"))
+    UpdateRoutingControlStateRequest.add_member(:safety_rules_to_override, Shapes::ShapeRef.new(shape: Arns, location_name: "SafetyRulesToOverride"))
     UpdateRoutingControlStateRequest.struct_class = Types::UpdateRoutingControlStateRequest
 
     UpdateRoutingControlStateResponse.struct_class = Types::UpdateRoutingControlStateResponse
 
     UpdateRoutingControlStatesRequest.add_member(:update_routing_control_state_entries, Shapes::ShapeRef.new(shape: UpdateRoutingControlStateEntries, required: true, location_name: "UpdateRoutingControlStateEntries"))
+    UpdateRoutingControlStatesRequest.add_member(:safety_rules_to_override, Shapes::ShapeRef.new(shape: Arns, location_name: "SafetyRulesToOverride"))
     UpdateRoutingControlStatesRequest.struct_class = Types::UpdateRoutingControlStatesRequest
 
     UpdateRoutingControlStatesResponse.struct_class = Types::UpdateRoutingControlStatesResponse

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

@@ -157,7 +157,7 @@ module Aws::Route53RecoveryCluster
       include Aws::Structure
     end
 
-    # A routing control state.
+    # A routing control state entry.
     #
     # @note When making an API call, you may pass UpdateRoutingControlStateEntry
     #   data as a hash:
@@ -168,8 +168,7 @@ module Aws::Route53RecoveryCluster
     #       }
     #
     # @!attribute [rw] routing_control_arn
-    #   The Amazon Resource Number (ARN) for the routing control state
-    #   entry.
+    #   The Amazon Resource Number (ARN) for a routing control state entry.
     #   @return [String]
     #
     # @!attribute [rw] routing_control_state
@@ -191,6 +190,7 @@ module Aws::Route53RecoveryCluster
     #       {
     #         routing_control_arn: "Arn", # required
     #         routing_control_state: "On", # required, accepts On, Off
+    #         safety_rules_to_override: ["Arn"],
     #       }
     #
     # @!attribute [rw] routing_control_arn
@@ -203,11 +203,27 @@ module Aws::Route53RecoveryCluster
     #   Off.
     #   @return [String]
     #
+    # @!attribute [rw] safety_rules_to_override
+    #   The Amazon Resource Numbers (ARNs) for the safety rules that you
+    #   want to override when you're updating the state of a routing
+    #   control. You can override one safety rule or multiple safety rules
+    #   by including one or more ARNs, separated by commas.
+    #
+    #   For more information, see [ Override safety rules to reroute
+    #   traffic][1] in the Amazon Route 53 Application Recovery Controller
+    #   Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.override-safety-rule.html
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/UpdateRoutingControlStateRequest AWS API Documentation
     #
     class UpdateRoutingControlStateRequest < Struct.new(
       :routing_control_arn,
-      :routing_control_state)
+      :routing_control_state,
+      :safety_rules_to_override)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -226,16 +242,33 @@ module Aws::Route53RecoveryCluster
     #             routing_control_state: "On", # required, accepts On, Off
     #           },
     #         ],
+    #         safety_rules_to_override: ["Arn"],
     #       }
     #
     # @!attribute [rw] update_routing_control_state_entries
     #   A set of routing control entries that you want to update.
     #   @return [Array<Types::UpdateRoutingControlStateEntry>]
     #
+    # @!attribute [rw] safety_rules_to_override
+    #   The Amazon Resource Numbers (ARNs) for the safety rules that you
+    #   want to override when you're updating routing control states. You
+    #   can override one safety rule or multiple safety rules by including
+    #   one or more ARNs, separated by commas.
+    #
+    #   For more information, see [ Override safety rules to reroute
+    #   traffic][1] in the Amazon Route 53 Application Recovery Controller
+    #   Developer Guide.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/r53recovery/latest/dg/routing-control.override-safety-rule.html
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/route53-recovery-cluster-2019-12-02/UpdateRoutingControlStatesRequest AWS API Documentation
     #
     class UpdateRoutingControlStatesRequest < Struct.new(
-      :update_routing_control_state_entries)
+      :update_routing_control_state_entries,
+      :safety_rules_to_override)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-route53recoverycluster.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-route53recoverycluster/customizations'
 # @!group service
 module Aws::Route53RecoveryCluster
 
-  GEM_VERSION = '1.7.0'
+  GEM_VERSION = '1.10.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-route53recoverycluster
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.10.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-21 00:00:00.000000000 Z
+date: 2022-02-28 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.125.0
+        version: 3.127.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.125.0
+        version: 3.127.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement