aws-sdk-controltower 1.34.0 → 1.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '00591f69d511d4c509655f227935c9befdd02a2ef803defb989302fa4af0a93f'
-  data.tar.gz: 827d8eb58414521077c29d9896a5c5818ad4078f2a0584580c974d9cc55f6ba0
+  metadata.gz: d9ff1de29f393987010b2669d7f91e6e72e0d41d31bb28ca96621d94e696d64f
+  data.tar.gz: c5918e927d19a28f1048c627b9f1b26bc01c82f0885a4db9b0668f2a6c34daf2
 SHA512:
-  metadata.gz: 46341a9ade2d90e4f2025a63d5796cb6855f4f3bcf4bfb9f47a06130dde4bdf01b988f0f51e73ef3c6532b79b73e1217c4d433e34af7aad77991cf3ff16bfeb5
-  data.tar.gz: cca205d215200e899148999b8603c3d97b8836d62e843586c84c2e08dd3ead3123a361c882df61e6cd05eb2e0021373692ec0ec485caa187567385cfb3cae11b
+  metadata.gz: 8ed3be31e3ca302b639ee7e98404d91f2433c52f494e31004055cc582001e3f99da88337ac8de8d79c6d17b4690b78d1e85848ff69058ef2a29762646d46a24c
+  data.tar.gz: 07b7455fd74efeedea6b240cd41e4b623af39ba519ca6295e0fb552076245a1b5a54823464794947130ea2c2f1d30cf715017c2689a4b88e31fe37ffe6c3538f

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.35.0 (2024-11-12)
+------------------
+
+* Feature - Added ResetEnabledControl API.
+
 1.34.0 (2024-10-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.34.0
+1.35.0

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

@@ -863,7 +863,7 @@ module Aws::ControlTower
     #   resp.control_operation.enabled_control_identifier #=> String
     #   resp.control_operation.end_time #=> Time
     #   resp.control_operation.operation_identifier #=> String
-    #   resp.control_operation.operation_type #=> String, one of "ENABLE_CONTROL", "DISABLE_CONTROL", "UPDATE_ENABLED_CONTROL"
+    #   resp.control_operation.operation_type #=> String, one of "ENABLE_CONTROL", "DISABLE_CONTROL", "UPDATE_ENABLED_CONTROL", "RESET_ENABLED_CONTROL"
     #   resp.control_operation.start_time #=> Time
     #   resp.control_operation.status #=> String, one of "SUCCEEDED", "FAILED", "IN_PROGRESS"
     #   resp.control_operation.status_message #=> String
@@ -1097,7 +1097,7 @@ module Aws::ControlTower
     #   resp = client.list_control_operations({
     #     filter: {
     #       control_identifiers: ["ControlIdentifier"],
-    #       control_operation_types: ["ENABLE_CONTROL"], # accepts ENABLE_CONTROL, DISABLE_CONTROL, UPDATE_ENABLED_CONTROL
+    #       control_operation_types: ["ENABLE_CONTROL"], # accepts ENABLE_CONTROL, DISABLE_CONTROL, UPDATE_ENABLED_CONTROL, RESET_ENABLED_CONTROL
     #       enabled_control_identifiers: ["Arn"],
     #       statuses: ["SUCCEEDED"], # accepts SUCCEEDED, FAILED, IN_PROGRESS
     #       target_identifiers: ["TargetIdentifier"],
@@ -1113,7 +1113,7 @@ module Aws::ControlTower
     #   resp.control_operations[0].enabled_control_identifier #=> String
     #   resp.control_operations[0].end_time #=> Time
     #   resp.control_operations[0].operation_identifier #=> String
-    #   resp.control_operations[0].operation_type #=> String, one of "ENABLE_CONTROL", "DISABLE_CONTROL", "UPDATE_ENABLED_CONTROL"
+    #   resp.control_operations[0].operation_type #=> String, one of "ENABLE_CONTROL", "DISABLE_CONTROL", "UPDATE_ENABLED_CONTROL", "RESET_ENABLED_CONTROL"
     #   resp.control_operations[0].start_time #=> Time
     #   resp.control_operations[0].status #=> String, one of "SUCCEEDED", "FAILED", "IN_PROGRESS"
     #   resp.control_operations[0].status_message #=> String
@@ -1415,6 +1415,34 @@ module Aws::ControlTower
       req.send_request(options)
     end
 
+    # Resets an enabled control.
+    #
+    # @option params [required, String] :enabled_control_identifier
+    #   The ARN of the enabled control to be reset.
+    #
+    # @return [Types::ResetEnabledControlOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ResetEnabledControlOutput#operation_identifier #operation_identifier} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.reset_enabled_control({
+    #     enabled_control_identifier: "Arn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.operation_identifier #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/ResetEnabledControl AWS API Documentation
+    #
+    # @overload reset_enabled_control(params = {})
+    # @param [Hash] params ({})
+    def reset_enabled_control(params = {}, options = {})
+      req = build_request(:reset_enabled_control, params)
+      req.send_request(options)
+    end
+
     # This API call resets a landing zone. It starts an asynchronous
     # operation that resets the landing zone to the parameters specified in
     # the original configuration, which you specified in the manifest file.
@@ -1573,11 +1601,12 @@ module Aws::ControlTower
     # Web Services Control Tower updates the control to match any valid
     # parameters that you supply.
     #
-    # If the `DriftSummary` status for the control shows as DRIFTED, you
+    # If the `DriftSummary` status for the control shows as `DRIFTED`, you
     # cannot call this API. Instead, you can update the control by calling
-    # `DisableControl` and again calling `EnableControl`, or you can run an
-    # extending governance operation. For usage examples, see the [
-    # *Controls Reference Guide* ][1].
+    # the `ResetEnabledControl` API. Alternatively, you can call
+    # `DisableControl` and then call `EnableControl` again. Also, you can
+    # run an extending governance operation to repair drift. For usage
+    # examples, see the [ *Controls Reference Guide* ][1].
     #
     #
     #
@@ -1691,7 +1720,7 @@ module Aws::ControlTower
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-controltower'
-      context[:gem_version] = '1.34.0'
+      context[:gem_version] = '1.35.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -132,6 +132,8 @@ module Aws::ControlTower
     RegionName = Shapes::StringShape.new(name: 'RegionName')
     ResetEnabledBaselineInput = Shapes::StructureShape.new(name: 'ResetEnabledBaselineInput')
     ResetEnabledBaselineOutput = Shapes::StructureShape.new(name: 'ResetEnabledBaselineOutput')
+    ResetEnabledControlInput = Shapes::StructureShape.new(name: 'ResetEnabledControlInput')
+    ResetEnabledControlOutput = Shapes::StructureShape.new(name: 'ResetEnabledControlOutput')
     ResetLandingZoneInput = Shapes::StructureShape.new(name: 'ResetLandingZoneInput')
     ResetLandingZoneOutput = Shapes::StructureShape.new(name: 'ResetLandingZoneOutput')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
@@ -505,6 +507,12 @@ module Aws::ControlTower
     ResetEnabledBaselineOutput.add_member(:operation_identifier, Shapes::ShapeRef.new(shape: OperationIdentifier, required: true, location_name: "operationIdentifier"))
     ResetEnabledBaselineOutput.struct_class = Types::ResetEnabledBaselineOutput
 
+    ResetEnabledControlInput.add_member(:enabled_control_identifier, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "enabledControlIdentifier"))
+    ResetEnabledControlInput.struct_class = Types::ResetEnabledControlInput
+
+    ResetEnabledControlOutput.add_member(:operation_identifier, Shapes::ShapeRef.new(shape: OperationIdentifier, required: true, location_name: "operationIdentifier"))
+    ResetEnabledControlOutput.struct_class = Types::ResetEnabledControlOutput
+
     ResetLandingZoneInput.add_member(:landing_zone_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "landingZoneIdentifier"))
     ResetLandingZoneInput.struct_class = Types::ResetLandingZoneInput
 
@@ -903,6 +911,21 @@ module Aws::ControlTower
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
 
+      api.add_operation(:reset_enabled_control, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ResetEnabledControl"
+        o.http_method = "POST"
+        o.http_request_uri = "/reset-enabled-control"
+        o.input = Shapes::ShapeRef.new(shape: ResetEnabledControlInput)
+        o.output = Shapes::ShapeRef.new(shape: ResetEnabledControlOutput)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: ConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+      end)
+
       api.add_operation(:reset_landing_zone, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ResetLandingZone"
         o.http_method = "POST"

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

@@ -1562,6 +1562,30 @@ module Aws::ControlTower
       include Aws::Structure
     end
 
+    # @!attribute [rw] enabled_control_identifier
+    #   The ARN of the enabled control to be reset.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/ResetEnabledControlInput AWS API Documentation
+    #
+    class ResetEnabledControlInput < Struct.new(
+      :enabled_control_identifier)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] operation_identifier
+    #   The operation identifier for this `ResetEnabledControl` operation.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/ResetEnabledControlOutput AWS API Documentation
+    #
+    class ResetEnabledControlOutput < Struct.new(
+      :operation_identifier)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] landing_zone_identifier
     #   The unique identifier of the landing zone.
     #   @return [String]

data/lib/aws-sdk-controltower.rb

@@ -54,7 +54,7 @@ module Aws::ControlTower
   autoload :EndpointProvider, 'aws-sdk-controltower/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-controltower/endpoints'
 
-  GEM_VERSION = '1.34.0'
+  GEM_VERSION = '1.35.0'
 
 end
 

data/sig/client.rbs

@@ -254,7 +254,7 @@ module Aws
       def list_control_operations: (
                                      ?filter: {
                                        control_identifiers: Array[::String]?,
-                                       control_operation_types: Array[("ENABLE_CONTROL" | "DISABLE_CONTROL" | "UPDATE_ENABLED_CONTROL")]?,
+                                       control_operation_types: Array[("ENABLE_CONTROL" | "DISABLE_CONTROL" | "UPDATE_ENABLED_CONTROL" | "RESET_ENABLED_CONTROL")]?,
                                        enabled_control_identifiers: Array[::String]?,
                                        statuses: Array[("SUCCEEDED" | "FAILED" | "IN_PROGRESS")]?,
                                        target_identifiers: Array[::String]?
@@ -346,6 +346,16 @@ module Aws
                                   ) -> _ResetEnabledBaselineResponseSuccess
                                 | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ResetEnabledBaselineResponseSuccess
 
+      interface _ResetEnabledControlResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ResetEnabledControlOutput]
+        def operation_identifier: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ControlTower/Client.html#reset_enabled_control-instance_method
+      def reset_enabled_control: (
+                                   enabled_control_identifier: ::String
+                                 ) -> _ResetEnabledControlResponseSuccess
+                               | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ResetEnabledControlResponseSuccess
+
       interface _ResetLandingZoneResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ResetLandingZoneOutput]
         def operation_identifier: () -> ::String

data/sig/types.rbs

@@ -40,7 +40,7 @@ module Aws::ControlTower
       attr_accessor enabled_control_identifier: ::String
       attr_accessor end_time: ::Time
       attr_accessor operation_identifier: ::String
-      attr_accessor operation_type: ("ENABLE_CONTROL" | "DISABLE_CONTROL" | "UPDATE_ENABLED_CONTROL")
+      attr_accessor operation_type: ("ENABLE_CONTROL" | "DISABLE_CONTROL" | "UPDATE_ENABLED_CONTROL" | "RESET_ENABLED_CONTROL")
       attr_accessor start_time: ::Time
       attr_accessor status: ("SUCCEEDED" | "FAILED" | "IN_PROGRESS")
       attr_accessor status_message: ::String
@@ -50,7 +50,7 @@ module Aws::ControlTower
 
     class ControlOperationFilter
       attr_accessor control_identifiers: ::Array[::String]
-      attr_accessor control_operation_types: ::Array[("ENABLE_CONTROL" | "DISABLE_CONTROL" | "UPDATE_ENABLED_CONTROL")]
+      attr_accessor control_operation_types: ::Array[("ENABLE_CONTROL" | "DISABLE_CONTROL" | "UPDATE_ENABLED_CONTROL" | "RESET_ENABLED_CONTROL")]
       attr_accessor enabled_control_identifiers: ::Array[::String]
       attr_accessor statuses: ::Array[("SUCCEEDED" | "FAILED" | "IN_PROGRESS")]
       attr_accessor target_identifiers: ::Array[::String]
@@ -62,7 +62,7 @@ module Aws::ControlTower
       attr_accessor enabled_control_identifier: ::String
       attr_accessor end_time: ::Time
       attr_accessor operation_identifier: ::String
-      attr_accessor operation_type: ("ENABLE_CONTROL" | "DISABLE_CONTROL" | "UPDATE_ENABLED_CONTROL")
+      attr_accessor operation_type: ("ENABLE_CONTROL" | "DISABLE_CONTROL" | "UPDATE_ENABLED_CONTROL" | "RESET_ENABLED_CONTROL")
       attr_accessor start_time: ::Time
       attr_accessor status: ("SUCCEEDED" | "FAILED" | "IN_PROGRESS")
       attr_accessor status_message: ::String
@@ -452,6 +452,16 @@ module Aws::ControlTower
       SENSITIVE: []
     end
 
+    class ResetEnabledControlInput
+      attr_accessor enabled_control_identifier: ::String
+      SENSITIVE: []
+    end
+
+    class ResetEnabledControlOutput
+      attr_accessor operation_identifier: ::String
+      SENSITIVE: []
+    end
+
     class ResetLandingZoneInput
       attr_accessor landing_zone_identifier: ::String
       SENSITIVE: []

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-controltower
 version: !ruby/object:Gem::Version
-  version: 1.34.0
+  version: 1.35.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-18 00:00:00.000000000 Z
+date: 2024-11-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core