aws-sdk-controltower 1.23.0 → 1.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: adeba4d8b40d87740caba195d9137c1d3b2efc5d6c0483382d6e4164f1b7375d
-  data.tar.gz: 3bb42606561d44a4455616fc887ac8609a64340c037e39192ab06a77ceda70f0
+  metadata.gz: c81d1d4e5596eda7ac04d10625057271e47ce98e0581c689b1ff194a4dba6d36
+  data.tar.gz: fb65efbdece38796b41559bf8e600510d0cb20a5aeaa8b7277f3ed3ad5825a7d
 SHA512:
-  metadata.gz: 4064613812d43d0f217ec8a3fcbf715836fca43e50eb8e91224fb7f93fecfe883a733f675d1d510956a65f643019e84ed6d8b8b62323f47d7ad53a4748a77dee
-  data.tar.gz: 670fc058348b389ed08dd799d62903076f42ec87e237f23dba84d2f66340103c1b106b2fbd53b21d58dc77aeea66c9155be422bf687d9ee4c4c512f06a489369
+  metadata.gz: 9b7f046462f04d4ba61a27b18be3aef979536ce3acaf6f35be704fc309d2b603b54182d8392113c3b4db40a2d83469680ac8167a72c4050efaa2ae817fa9bd94
+  data.tar.gz: 10924c573ec3223f54274985fdc5566a9a3b61428cb91702e523941f5a56db1f0326c5f775fa8f2e55e3e0511664c70fd6fbc350ef6e84a058e6af729602155c

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.25.0 (2024-06-26)
+------------------
+
+* Feature - Added ListLandingZoneOperations API.
+
+1.24.0 (2024-06-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.23.0 (2024-06-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.23.0
+1.25.0

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

@@ -538,14 +538,14 @@ module Aws::ControlTower
     end
 
     # This API call turns off a control. It starts an asynchronous operation
-    # that deletes AWS resources on the specified organizational unit and
-    # the accounts it contains. The resources will vary according to the
-    # control that you specify. For usage examples, see [ *the Amazon Web
-    # Services Control Tower User Guide* ][1].
+    # that deletes Amazon Web Services resources on the specified
+    # organizational unit and the accounts it contains. The resources will
+    # vary according to the control that you specify. For usage examples,
+    # see the [ *Controls Reference Guide* ][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
+    # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
     #
     # @option params [required, String] :control_identifier
     #   The ARN of the control. Only **Strongly recommended** and **Elective**
@@ -656,12 +656,11 @@ module Aws::ControlTower
     # that creates Amazon Web Services resources on the specified
     # organizational unit and the accounts it contains. The resources
     # created will vary according to the control that you specify. For usage
-    # examples, see [ *the Amazon Web Services Control Tower User Guide*
-    # ][1].
+    # examples, see the [ *Controls Reference Guide* ][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
+    # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
     #
     # @option params [required, String] :control_identifier
     #   The ARN of the control. Only **Strongly recommended** and **Elective**
@@ -806,12 +805,12 @@ module Aws::ControlTower
 
     # Returns the status of a particular `EnableControl` or `DisableControl`
     # operation. Displays a message in case of error. Details for an
-    # operation are available for 90 days. For usage examples, see [ *the
-    # Amazon Web Services Control Tower User Guide* ][1].
+    # operation are available for 90 days. For usage examples, see the [
+    # *Controls Reference Guide* ][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
+    # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
     #
     # @option params [required, String] :operation_identifier
     #   The ID of the asynchronous operation, which is used to track status.
@@ -885,12 +884,12 @@ module Aws::ControlTower
       req.send_request(options)
     end
 
-    # Retrieves details about an enabled control. For usage examples, see [
-    # *the Amazon Web Services Control Tower User Guide* ][1].
+    # Retrieves details about an enabled control. For usage examples, see
+    # the [ *Controls Reference Guide* ][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
+    # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
     #
     # @option params [required, String] :enabled_control_identifier
     #   The `controlIdentifier` of the enabled control.
@@ -979,6 +978,7 @@ module Aws::ControlTower
     # @example Response structure
     #
     #   resp.operation_details.end_time #=> Time
+    #   resp.operation_details.operation_identifier #=> String
     #   resp.operation_details.operation_type #=> String, one of "DELETE", "CREATE", "UPDATE", "RESET"
     #   resp.operation_details.start_time #=> Time
     #   resp.operation_details.status #=> String, one of "SUCCEEDED", "FAILED", "IN_PROGRESS"
@@ -1037,7 +1037,12 @@ module Aws::ControlTower
       req.send_request(options)
     end
 
-    # Provides a list of operations in progress or queued.
+    # Provides a list of operations in progress or queued. For usage
+    # examples, see [ListControlOperation examples][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html#list-control-operations-api-examples
     #
     # @option params [Types::ControlOperationFilter] :filter
     #   An input filter for the `ListControlOperations` API that lets you
@@ -1153,16 +1158,15 @@ module Aws::ControlTower
 
     # Lists the controls enabled by Amazon Web Services Control Tower on the
     # specified organizational unit and the accounts it contains. For usage
-    # examples, see [ *the Amazon Web Services Control Tower User Guide*
-    # ][1].
+    # examples, see the [ *Controls Reference Guide* ][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
+    # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
     #
     # @option params [Types::EnabledControlFilter] :filter
-    #   An input filter for the `ListCEnabledControls` API that lets you
-    #   select the types of control operations to view.
+    #   An input filter for the `ListEnabledControls` API that lets you select
+    #   the types of control operations to view.
     #
     # @option params [Integer] :max_results
     #   How many results to return per API call.
@@ -1219,6 +1223,55 @@ module Aws::ControlTower
       req.send_request(options)
     end
 
+    # Lists all landing zone operations from the past 90 days. Results are
+    # sorted by time, with the most recent operation first.
+    #
+    # @option params [Types::LandingZoneOperationFilter] :filter
+    #   An input filter for the `ListLandingZoneOperations` API that lets you
+    #   select the types of landing zone operations to view.
+    #
+    # @option params [Integer] :max_results
+    #   How many results to return per API call.
+    #
+    # @option params [String] :next_token
+    #   The token to continue the list from a previous API call with the same
+    #   parameters.
+    #
+    # @return [Types::ListLandingZoneOperationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListLandingZoneOperationsOutput#landing_zone_operations #landing_zone_operations} => Array<Types::LandingZoneOperationSummary>
+    #   * {Types::ListLandingZoneOperationsOutput#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_landing_zone_operations({
+    #     filter: {
+    #       statuses: ["SUCCEEDED"], # accepts SUCCEEDED, FAILED, IN_PROGRESS
+    #       types: ["DELETE"], # accepts DELETE, CREATE, UPDATE, RESET
+    #     },
+    #     max_results: 1,
+    #     next_token: "String",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.landing_zone_operations #=> Array
+    #   resp.landing_zone_operations[0].operation_identifier #=> String
+    #   resp.landing_zone_operations[0].operation_type #=> String, one of "DELETE", "CREATE", "UPDATE", "RESET"
+    #   resp.landing_zone_operations[0].status #=> String, one of "SUCCEEDED", "FAILED", "IN_PROGRESS"
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/ListLandingZoneOperations AWS API Documentation
+    #
+    # @overload list_landing_zone_operations(params = {})
+    # @param [Hash] params ({})
+    def list_landing_zone_operations(params = {}, options = {})
+      req = build_request(:list_landing_zone_operations, params)
+      req.send_request(options)
+    end
+
     # Returns the landing zone ARN for the landing zone deployed in your
     # managed account. This API also creates an ARN for existing accounts
     # that do not yet have a landing zone ARN.
@@ -1262,12 +1315,11 @@ module Aws::ControlTower
     end
 
     # Returns a list of tags associated with the resource. For usage
-    # examples, see [ *the Amazon Web Services Control Tower User Guide*
-    # ][1].
+    # examples, see the [ *Controls Reference Guide* ][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
+    # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
     #
     # @option params [required, String] :resource_arn
     #   The ARN of the resource.
@@ -1334,7 +1386,11 @@ module Aws::ControlTower
 
     # This API call resets a landing zone. It starts an asynchronous
     # operation that resets the landing zone to the parameters specified in
-    # its original configuration.
+    # the original configuration, which you specified in the manifest file.
+    # Nothing in the manifest file's original landing zone configuration is
+    # changed during the reset process, by default. This API is not the same
+    # as a rollback of a landing zone version, which is not a supported
+    # operation.
     #
     # @option params [required, String] :landing_zone_identifier
     #   The unique identifier of the landing zone.
@@ -1362,12 +1418,12 @@ module Aws::ControlTower
       req.send_request(options)
     end
 
-    # Applies tags to a resource. For usage examples, see [ *the Amazon Web
-    # Services Control Tower User Guide* ][1].
+    # Applies tags to a resource. For usage examples, see the [ *Controls
+    # Reference Guide* ][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
+    # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
     #
     # @option params [required, String] :resource_arn
     #   The ARN of the resource to be tagged.
@@ -1395,12 +1451,12 @@ module Aws::ControlTower
       req.send_request(options)
     end
 
-    # Removes tags from a resource. For usage examples, see [ *the Amazon
-    # Web Services Control Tower User Guide* ][1].
+    # Removes tags from a resource. For usage examples, see the [ *Controls
+    # Reference Guide* ][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
+    # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
     #
     # @option params [required, String] :resource_arn
     #   The ARN of the resource.
@@ -1483,18 +1539,18 @@ module Aws::ControlTower
     # accept the request.
     #
     # If the enabled control shows an `EnablementStatus` of FAILED, Amazon
-    # Web Services Control Tower will update the control to match any valid
+    # 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
     # 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 Amazon
-    # Web Services Control Tower User Guide* ][1]
+    # extending governance operation. For usage examples, see the [
+    # *Controls Reference Guide* ][1].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/controltower/latest/userguide/control-api-examples-short.html
+    # [1]: https://docs.aws.amazon.com/controltower/latest/controlreference/control-api-examples-short.html
     #
     # @option params [required, String] :enabled_control_identifier
     #   The ARN of the enabled control that will be updated.
@@ -1542,9 +1598,11 @@ module Aws::ControlTower
     #   The unique identifier of the landing zone.
     #
     # @option params [required, Hash,Array,String,Numeric,Boolean] :manifest
-    #   The manifest JSON file is a text file that describes your Amazon Web
-    #   Services resources. For examples, review [Launch your landing
-    #   zone][1].
+    #   The manifest file (JSON) is a text file that describes your Amazon Web
+    #   Services resources. For an example, review [Launch your landing
+    #   zone][1]. The example manifest file contains each of the available
+    #   parameters. The schema for the landing zone's JSON manifest file is
+    #   not published, by design.
     #
     #   Document type used to carry open content
     #   (Hash,Array,String,Numeric,Boolean). A document type value is
@@ -1597,7 +1655,7 @@ module Aws::ControlTower
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-controltower'
-      context[:gem_version] = '1.23.0'
+      context[:gem_version] = '1.25.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -92,8 +92,13 @@ module Aws::ControlTower
     LandingZoneDriftStatus = Shapes::StringShape.new(name: 'LandingZoneDriftStatus')
     LandingZoneDriftStatusSummary = Shapes::StructureShape.new(name: 'LandingZoneDriftStatusSummary')
     LandingZoneOperationDetail = Shapes::StructureShape.new(name: 'LandingZoneOperationDetail')
+    LandingZoneOperationFilter = Shapes::StructureShape.new(name: 'LandingZoneOperationFilter')
     LandingZoneOperationStatus = Shapes::StringShape.new(name: 'LandingZoneOperationStatus')
+    LandingZoneOperationStatuses = Shapes::ListShape.new(name: 'LandingZoneOperationStatuses')
+    LandingZoneOperationSummary = Shapes::StructureShape.new(name: 'LandingZoneOperationSummary')
     LandingZoneOperationType = Shapes::StringShape.new(name: 'LandingZoneOperationType')
+    LandingZoneOperationTypes = Shapes::ListShape.new(name: 'LandingZoneOperationTypes')
+    LandingZoneOperations = Shapes::ListShape.new(name: 'LandingZoneOperations')
     LandingZoneStatus = Shapes::StringShape.new(name: 'LandingZoneStatus')
     LandingZoneSummary = Shapes::StructureShape.new(name: 'LandingZoneSummary')
     LandingZoneVersion = Shapes::StringShape.new(name: 'LandingZoneVersion')
@@ -110,6 +115,9 @@ module Aws::ControlTower
     ListEnabledBaselinesOutput = Shapes::StructureShape.new(name: 'ListEnabledBaselinesOutput')
     ListEnabledControlsInput = Shapes::StructureShape.new(name: 'ListEnabledControlsInput')
     ListEnabledControlsOutput = Shapes::StructureShape.new(name: 'ListEnabledControlsOutput')
+    ListLandingZoneOperationsInput = Shapes::StructureShape.new(name: 'ListLandingZoneOperationsInput')
+    ListLandingZoneOperationsMaxResults = Shapes::IntegerShape.new(name: 'ListLandingZoneOperationsMaxResults')
+    ListLandingZoneOperationsOutput = Shapes::StructureShape.new(name: 'ListLandingZoneOperationsOutput')
     ListLandingZonesInput = Shapes::StructureShape.new(name: 'ListLandingZonesInput')
     ListLandingZonesMaxResults = Shapes::IntegerShape.new(name: 'ListLandingZonesMaxResults')
     ListLandingZonesOutput = Shapes::StructureShape.new(name: 'ListLandingZonesOutput')
@@ -401,12 +409,28 @@ module Aws::ControlTower
     LandingZoneDriftStatusSummary.struct_class = Types::LandingZoneDriftStatusSummary
 
     LandingZoneOperationDetail.add_member(:end_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "endTime"))
+    LandingZoneOperationDetail.add_member(:operation_identifier, Shapes::ShapeRef.new(shape: OperationIdentifier, location_name: "operationIdentifier"))
     LandingZoneOperationDetail.add_member(:operation_type, Shapes::ShapeRef.new(shape: LandingZoneOperationType, location_name: "operationType"))
     LandingZoneOperationDetail.add_member(:start_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "startTime"))
     LandingZoneOperationDetail.add_member(:status, Shapes::ShapeRef.new(shape: LandingZoneOperationStatus, location_name: "status"))
     LandingZoneOperationDetail.add_member(:status_message, Shapes::ShapeRef.new(shape: String, location_name: "statusMessage"))
     LandingZoneOperationDetail.struct_class = Types::LandingZoneOperationDetail
 
+    LandingZoneOperationFilter.add_member(:statuses, Shapes::ShapeRef.new(shape: LandingZoneOperationStatuses, location_name: "statuses"))
+    LandingZoneOperationFilter.add_member(:types, Shapes::ShapeRef.new(shape: LandingZoneOperationTypes, location_name: "types"))
+    LandingZoneOperationFilter.struct_class = Types::LandingZoneOperationFilter
+
+    LandingZoneOperationStatuses.member = Shapes::ShapeRef.new(shape: LandingZoneOperationStatus)
+
+    LandingZoneOperationSummary.add_member(:operation_identifier, Shapes::ShapeRef.new(shape: OperationIdentifier, location_name: "operationIdentifier"))
+    LandingZoneOperationSummary.add_member(:operation_type, Shapes::ShapeRef.new(shape: LandingZoneOperationType, location_name: "operationType"))
+    LandingZoneOperationSummary.add_member(:status, Shapes::ShapeRef.new(shape: LandingZoneOperationStatus, location_name: "status"))
+    LandingZoneOperationSummary.struct_class = Types::LandingZoneOperationSummary
+
+    LandingZoneOperationTypes.member = Shapes::ShapeRef.new(shape: LandingZoneOperationType)
+
+    LandingZoneOperations.member = Shapes::ShapeRef.new(shape: LandingZoneOperationSummary)
+
     LandingZoneSummary.add_member(:arn, Shapes::ShapeRef.new(shape: Arn, location_name: "arn"))
     LandingZoneSummary.struct_class = Types::LandingZoneSummary
 
@@ -446,6 +470,15 @@ module Aws::ControlTower
     ListEnabledControlsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
     ListEnabledControlsOutput.struct_class = Types::ListEnabledControlsOutput
 
+    ListLandingZoneOperationsInput.add_member(:filter, Shapes::ShapeRef.new(shape: LandingZoneOperationFilter, location_name: "filter"))
+    ListLandingZoneOperationsInput.add_member(:max_results, Shapes::ShapeRef.new(shape: ListLandingZoneOperationsMaxResults, location_name: "maxResults"))
+    ListLandingZoneOperationsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
+    ListLandingZoneOperationsInput.struct_class = Types::ListLandingZoneOperationsInput
+
+    ListLandingZoneOperationsOutput.add_member(:landing_zone_operations, Shapes::ShapeRef.new(shape: LandingZoneOperations, required: true, location_name: "landingZoneOperations"))
+    ListLandingZoneOperationsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
+    ListLandingZoneOperationsOutput.struct_class = Types::ListLandingZoneOperationsOutput
+
     ListLandingZonesInput.add_member(:max_results, Shapes::ShapeRef.new(shape: ListLandingZonesMaxResults, location_name: "maxResults"))
     ListLandingZonesInput.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
     ListLandingZonesInput.struct_class = Types::ListLandingZonesInput
@@ -544,6 +577,7 @@ module Aws::ControlTower
 
       api.metadata = {
         "apiVersion" => "2018-05-10",
+        "auth" => ["aws.auth#sigv4"],
         "endpointPrefix" => "controltower",
         "jsonVersion" => "1.1",
         "protocol" => "rest-json",
@@ -806,6 +840,24 @@ module Aws::ControlTower
         )
       end)
 
+      api.add_operation(:list_landing_zone_operations, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListLandingZoneOperations"
+        o.http_method = "POST"
+        o.http_request_uri = "/list-landingzone-operations"
+        o.input = Shapes::ShapeRef.new(shape: ListLandingZoneOperationsInput)
+        o.output = Shapes::ShapeRef.new(shape: ListLandingZoneOperationsOutput)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_landing_zones, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListLandingZones"
         o.http_method = "POST"

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

@@ -250,6 +250,20 @@ module Aws::ControlTower
       end
     end
 
+    class ListLandingZoneOperations
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::ControlTower::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class ListLandingZones
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-controltower/plugins/endpoints.rb

@@ -92,6 +92,8 @@ module Aws::ControlTower
             Aws::ControlTower::Endpoints::ListEnabledBaselines.build(context)
           when :list_enabled_controls
             Aws::ControlTower::Endpoints::ListEnabledControls.build(context)
+          when :list_landing_zone_operations
+            Aws::ControlTower::Endpoints::ListLandingZoneOperations.build(context)
           when :list_landing_zones
             Aws::ControlTower::Endpoints::ListLandingZones.build(context)
           when :list_tags_for_resource

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

@@ -159,7 +159,7 @@ module Aws::ControlTower
       include Aws::Structure
     end
 
-    # A filter object that lets you call `ListCOntrolOperations` with a
+    # A filter object that lets you call `ListControlOperations` with a
     # specific filter.
     #
     # @!attribute [rw] control_identifiers
@@ -559,7 +559,8 @@ module Aws::ControlTower
     #   @return [Array<Types::EnabledBaselineParameterSummary>]
     #
     # @!attribute [rw] status_summary
-    #   The deployment summary of the enabled control.
+    #   The deployment summary of an `EnabledControl` or `EnabledBaseline`
+    #   resource.
     #   @return [Types::EnablementStatusSummary]
     #
     # @!attribute [rw] target_identifier
@@ -657,7 +658,8 @@ module Aws::ControlTower
     #   @return [String]
     #
     # @!attribute [rw] status_summary
-    #   The deployment summary of the enabled control.
+    #   The deployment summary of an `EnabledControl` or `EnabledBaseline`
+    #   resource.
     #   @return [Types::EnablementStatusSummary]
     #
     # @!attribute [rw] target_identifier
@@ -830,23 +832,26 @@ module Aws::ControlTower
       include Aws::Structure
     end
 
-    # The deployment summary of the enabled control.
+    # The deployment summary of an `EnabledControl` or `EnabledBaseline`
+    # resource.
     #
     # @!attribute [rw] last_operation_identifier
-    #   The last operation identifier for the enabled control.
+    #   The last operation identifier for the enabled resource.
     #   @return [String]
     #
     # @!attribute [rw] status
-    #   The deployment status of the enabled control.
+    #   The deployment status of the enabled resource.
     #
     #   Valid values:
     #
-    #   * `SUCCEEDED`: The `enabledControl` configuration was deployed
-    #     successfully.
+    #   * `SUCCEEDED`: The `EnabledControl` or `EnabledBaseline`
+    #     configuration was deployed successfully.
     #
-    #   * `UNDER_CHANGE`: The `enabledControl` configuration is changing.
+    #   * `UNDER_CHANGE`: The `EnabledControl` or `EnabledBaseline`
+    #     configuration is changing.
     #
-    #   * `FAILED`: The `enabledControl` configuration failed to deploy.
+    #   * `FAILED`: The `EnabledControl` or `EnabledBaseline` configuration
+    #     failed to deploy.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/EnablementStatusSummary AWS API Documentation
@@ -1127,6 +1132,10 @@ module Aws::ControlTower
     #   The landing zone operation end time.
     #   @return [Time]
     #
+    # @!attribute [rw] operation_identifier
+    #   The `operationIdentifier` of the landing zone operation.
+    #   @return [String]
+    #
     # @!attribute [rw] operation_type
     #   The landing zone operation type.
     #
@@ -1164,6 +1173,7 @@ module Aws::ControlTower
     #
     class LandingZoneOperationDetail < Struct.new(
       :end_time,
+      :operation_identifier,
       :operation_type,
       :start_time,
       :status,
@@ -1172,6 +1182,51 @@ module Aws::ControlTower
       include Aws::Structure
     end
 
+    # A filter object that lets you call `ListLandingZoneOperations` with a
+    # specific filter.
+    #
+    # @!attribute [rw] statuses
+    #   The statuses of the set of landing zone operations selected by the
+    #   filter.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] types
+    #   The set of landing zone operation types selected by the filter.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/LandingZoneOperationFilter AWS API Documentation
+    #
+    class LandingZoneOperationFilter < Struct.new(
+      :statuses,
+      :types)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Returns a summary of information about a landing zone operation.
+    #
+    # @!attribute [rw] operation_identifier
+    #   The `operationIdentifier` of the landing zone operation.
+    #   @return [String]
+    #
+    # @!attribute [rw] operation_type
+    #   The type of the landing zone operation.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The status of the landing zone operation.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/LandingZoneOperationSummary AWS API Documentation
+    #
+    class LandingZoneOperationSummary < Struct.new(
+      :operation_identifier,
+      :operation_type,
+      :status)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Returns a summary of information about a landing zone.
     #
     # @!attribute [rw] arn
@@ -1244,7 +1299,7 @@ module Aws::ControlTower
     end
 
     # @!attribute [rw] control_operations
-    #   Returns a list of output from control operations. PLACEHOLDER
+    #   Returns a list of output from control operations.
     #   @return [Array<Types::ControlOperationSummary>]
     #
     # @!attribute [rw] next_token
@@ -1302,7 +1357,7 @@ module Aws::ControlTower
     end
 
     # @!attribute [rw] filter
-    #   An input filter for the `ListCEnabledControls` API that lets you
+    #   An input filter for the `ListEnabledControls` API that lets you
     #   select the types of control operations to view.
     #   @return [Types::EnabledControlFilter]
     #
@@ -1354,6 +1409,48 @@ module Aws::ControlTower
       include Aws::Structure
     end
 
+    # @!attribute [rw] filter
+    #   An input filter for the `ListLandingZoneOperations` API that lets
+    #   you select the types of landing zone operations to view.
+    #   @return [Types::LandingZoneOperationFilter]
+    #
+    # @!attribute [rw] max_results
+    #   How many results to return per API call.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The token to continue the list from a previous API call with the
+    #   same parameters.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/ListLandingZoneOperationsInput AWS API Documentation
+    #
+    class ListLandingZoneOperationsInput < Struct.new(
+      :filter,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] landing_zone_operations
+    #   Lists landing zone operations.
+    #   @return [Array<Types::LandingZoneOperationSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   Retrieves the next page of results. If the string is empty, the
+    #   response is the end of the results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/controltower-2018-05-10/ListLandingZoneOperationsOutput AWS API Documentation
+    #
+    class ListLandingZoneOperationsOutput < Struct.new(
+      :landing_zone_operations,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] max_results
     #   The maximum number of returned landing zone ARNs, which is one.
     #   @return [Integer]
@@ -1660,9 +1757,11 @@ module Aws::ControlTower
     #   @return [String]
     #
     # @!attribute [rw] manifest
-    #   The manifest JSON file is a text file that describes your Amazon Web
-    #   Services resources. For examples, review [Launch your landing
-    #   zone][1].
+    #   The manifest file (JSON) is a text file that describes your Amazon
+    #   Web Services resources. For an example, review [Launch your landing
+    #   zone][1]. The example manifest file contains each of the available
+    #   parameters. The schema for the landing zone's JSON manifest file is
+    #   not published, by design.
     #
     #
     #

data/lib/aws-sdk-controltower.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-controltower/customizations'
 # @!group service
 module Aws::ControlTower
 
-  GEM_VERSION = '1.23.0'
+  GEM_VERSION = '1.25.0'
 
 end

data/sig/client.rbs

@@ -295,6 +295,22 @@ module Aws
                                  ) -> _ListEnabledControlsResponseSuccess
                                | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListEnabledControlsResponseSuccess
 
+      interface _ListLandingZoneOperationsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ListLandingZoneOperationsOutput]
+        def landing_zone_operations: () -> ::Array[Types::LandingZoneOperationSummary]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/ControlTower/Client.html#list_landing_zone_operations-instance_method
+      def list_landing_zone_operations: (
+                                          ?filter: {
+                                            statuses: Array[("SUCCEEDED" | "FAILED" | "IN_PROGRESS")]?,
+                                            types: Array[("DELETE" | "CREATE" | "UPDATE" | "RESET")]?
+                                          },
+                                          ?max_results: ::Integer,
+                                          ?next_token: ::String
+                                        ) -> _ListLandingZoneOperationsResponseSuccess
+                                      | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListLandingZoneOperationsResponseSuccess
+
       interface _ListLandingZonesResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ListLandingZonesOutput]
         def landing_zones: () -> ::Array[Types::LandingZoneSummary]

data/sig/types.rbs

@@ -324,6 +324,7 @@ module Aws::ControlTower
 
     class LandingZoneOperationDetail
       attr_accessor end_time: ::Time
+      attr_accessor operation_identifier: ::String
       attr_accessor operation_type: ("DELETE" | "CREATE" | "UPDATE" | "RESET")
       attr_accessor start_time: ::Time
       attr_accessor status: ("SUCCEEDED" | "FAILED" | "IN_PROGRESS")
@@ -331,6 +332,19 @@ module Aws::ControlTower
       SENSITIVE: []
     end
 
+    class LandingZoneOperationFilter
+      attr_accessor statuses: ::Array[("SUCCEEDED" | "FAILED" | "IN_PROGRESS")]
+      attr_accessor types: ::Array[("DELETE" | "CREATE" | "UPDATE" | "RESET")]
+      SENSITIVE: []
+    end
+
+    class LandingZoneOperationSummary
+      attr_accessor operation_identifier: ::String
+      attr_accessor operation_type: ("DELETE" | "CREATE" | "UPDATE" | "RESET")
+      attr_accessor status: ("SUCCEEDED" | "FAILED" | "IN_PROGRESS")
+      SENSITIVE: []
+    end
+
     class LandingZoneSummary
       attr_accessor arn: ::String
       SENSITIVE: []
@@ -388,6 +402,19 @@ module Aws::ControlTower
       SENSITIVE: []
     end
 
+    class ListLandingZoneOperationsInput
+      attr_accessor filter: Types::LandingZoneOperationFilter
+      attr_accessor max_results: ::Integer
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
+    class ListLandingZoneOperationsOutput
+      attr_accessor landing_zone_operations: ::Array[Types::LandingZoneOperationSummary]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
     class ListLandingZonesInput
       attr_accessor max_results: ::Integer
       attr_accessor next_token: ::String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-controltower
 version: !ruby/object:Gem::Version
-  version: 1.23.0
+  version: 1.25.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-24 00:00:00.000000000 Z
+date: 2024-06-26 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.198.0
+        version: 3.199.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.198.0
+        version: 3.199.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement