aws-sdk-cloudformation 1.101.0 → 1.102.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 72ed6b352211215a4b5c4bf0ad457dbd1b1e21bcb2318993aebe3b9c43780010
-  data.tar.gz: c84b8eba834abba113a7d6fc49c6156a80c31aaad5769cd070e44a4ba04c1390
+  metadata.gz: 5e8370b27119126eb875a0ae81933d87f068890dd3b3cc9b596532a3589e7e86
+  data.tar.gz: c9615dac798a30893625f8b2e819b0238fbd8b126acc8eab3a6cbcd9ae29c520
 SHA512:
-  metadata.gz: ccd7d12fd240affed2043ad22e32598ce571013e7b38cef270d71a27a482b3a52f9e34b2d9c62c939bcaefe51976ec2302c635998a3c34498f56beaeb03c8054
-  data.tar.gz: 6d23078df1f4135087ea46e31ac2a1086ffa118e9e7cbaec5dc51f900dd0766189a74f5e20b835f7e392c6a88afff581e1bedcc830870cdd7c96979fa11df8ce
+  metadata.gz: 4d1bbb5342d7521682bc01b782c7078da6474d57648820c4c9d5ee5dd75bed5c492804ebfdecfc5410d52c60b1b54f55686d57c76c8dc29cf5efd69beaf0b7dd
+  data.tar.gz: cef6cfafdc204df92793d7fe023930c2768bb0b6180acc392feb7189dfcd2773ae5146e0cd330aa8652e6712c33bf126d83e3e43d346da321287dea3411d6dfb

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.102.0 (2024-03-18)
+------------------
+
+* Feature - This release supports for a new API ListStackSetAutoDeploymentTargets, which provider auto-deployment configuration as a describable resource. Customers can now view the specific combinations of regions and OUs that are being auto-deployed.
+
 1.101.0 (2024-03-12)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.101.0
+1.102.0

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

@@ -1305,7 +1305,7 @@ module Aws::CloudFormation
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
     #
-    #     * [ `AWS::IAM::AccessKey` AWS::IAM::AccessKey][1]
+    #     * [ `AWS::IAM::AccessKey` ][1]
     #
     #     * [ `AWS::IAM::Group` ][2]
     #
@@ -5574,6 +5574,75 @@ module Aws::CloudFormation
       req.send_request(options)
     end
 
+    # Returns summary information about deployment targets for a stack set.
+    #
+    # @option params [required, String] :stack_set_name
+    #   The name or unique ID of the stack set that you want to get automatic
+    #   deployment targets for.
+    #
+    # @option params [String] :next_token
+    #   A string that identifies the next page of stack set deployment targets
+    #   that you want to retrieve.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to be returned with a single call. If
+    #   the number of available results exceeds this maximum, the response
+    #   includes a `NextToken` value that you can assign to the `NextToken`
+    #   request parameter to get the next set of results.
+    #
+    # @option params [String] :call_as
+    #   Specifies whether you are acting as an account administrator in the
+    #   organization's management account or as a delegated administrator in
+    #   a member account.
+    #
+    #   By default, `SELF` is specified. Use `SELF` for StackSets with
+    #   self-managed permissions.
+    #
+    #   * If you are signed in to the management account, specify `SELF`.
+    #
+    #   * If you are signed in to a delegated administrator account, specify
+    #     `DELEGATED_ADMIN`.
+    #
+    #     Your Amazon Web Services account must be registered as a delegated
+    #     administrator in the management account. For more information, see
+    #     [Register a delegated administrator][1] in the *CloudFormation User
+    #     Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
+    #
+    # @return [Types::ListStackSetAutoDeploymentTargetsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListStackSetAutoDeploymentTargetsOutput#summaries #summaries} => Array<Types::StackSetAutoDeploymentTargetSummary>
+    #   * {Types::ListStackSetAutoDeploymentTargetsOutput#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_stack_set_auto_deployment_targets({
+    #     stack_set_name: "StackSetNameOrId", # required
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #     call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.summaries #=> Array
+    #   resp.summaries[0].organizational_unit_id #=> String
+    #   resp.summaries[0].regions #=> Array
+    #   resp.summaries[0].regions[0] #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackSetAutoDeploymentTargets AWS API Documentation
+    #
+    # @overload list_stack_set_auto_deployment_targets(params = {})
+    # @param [Hash] params ({})
+    def list_stack_set_auto_deployment_targets(params = {}, options = {})
+      req = build_request(:list_stack_set_auto_deployment_targets, params)
+      req.send_request(options)
+    end
+
     # Returns summary information about the results of a stack set
     # operation.
     #
@@ -8259,7 +8328,7 @@ module Aws::CloudFormation
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-cloudformation'
-      context[:gem_version] = '1.101.0'
+      context[:gem_version] = '1.102.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -240,6 +240,8 @@ module Aws::CloudFormation
     ListStackInstancesOutput = Shapes::StructureShape.new(name: 'ListStackInstancesOutput')
     ListStackResourcesInput = Shapes::StructureShape.new(name: 'ListStackResourcesInput')
     ListStackResourcesOutput = Shapes::StructureShape.new(name: 'ListStackResourcesOutput')
+    ListStackSetAutoDeploymentTargetsInput = Shapes::StructureShape.new(name: 'ListStackSetAutoDeploymentTargetsInput')
+    ListStackSetAutoDeploymentTargetsOutput = Shapes::StructureShape.new(name: 'ListStackSetAutoDeploymentTargetsOutput')
     ListStackSetOperationResultsInput = Shapes::StructureShape.new(name: 'ListStackSetOperationResultsInput')
     ListStackSetOperationResultsOutput = Shapes::StructureShape.new(name: 'ListStackSetOperationResultsOutput')
     ListStackSetOperationsInput = Shapes::StructureShape.new(name: 'ListStackSetOperationsInput')
@@ -459,6 +461,8 @@ module Aws::CloudFormation
     StackResources = Shapes::ListShape.new(name: 'StackResources')
     StackSet = Shapes::StructureShape.new(name: 'StackSet')
     StackSetARN = Shapes::StringShape.new(name: 'StackSetARN')
+    StackSetAutoDeploymentTargetSummaries = Shapes::ListShape.new(name: 'StackSetAutoDeploymentTargetSummaries')
+    StackSetAutoDeploymentTargetSummary = Shapes::StructureShape.new(name: 'StackSetAutoDeploymentTargetSummary')
     StackSetDriftDetectionDetails = Shapes::StructureShape.new(name: 'StackSetDriftDetectionDetails')
     StackSetDriftDetectionStatus = Shapes::StringShape.new(name: 'StackSetDriftDetectionStatus')
     StackSetDriftStatus = Shapes::StringShape.new(name: 'StackSetDriftStatus')
@@ -1280,6 +1284,16 @@ module Aws::CloudFormation
     ListStackResourcesOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
     ListStackResourcesOutput.struct_class = Types::ListStackResourcesOutput
 
+    ListStackSetAutoDeploymentTargetsInput.add_member(:stack_set_name, Shapes::ShapeRef.new(shape: StackSetNameOrId, required: true, location_name: "StackSetName"))
+    ListStackSetAutoDeploymentTargetsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    ListStackSetAutoDeploymentTargetsInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
+    ListStackSetAutoDeploymentTargetsInput.add_member(:call_as, Shapes::ShapeRef.new(shape: CallAs, location_name: "CallAs"))
+    ListStackSetAutoDeploymentTargetsInput.struct_class = Types::ListStackSetAutoDeploymentTargetsInput
+
+    ListStackSetAutoDeploymentTargetsOutput.add_member(:summaries, Shapes::ShapeRef.new(shape: StackSetAutoDeploymentTargetSummaries, location_name: "Summaries"))
+    ListStackSetAutoDeploymentTargetsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
+    ListStackSetAutoDeploymentTargetsOutput.struct_class = Types::ListStackSetAutoDeploymentTargetsOutput
+
     ListStackSetOperationResultsInput.add_member(:stack_set_name, Shapes::ShapeRef.new(shape: StackSetName, required: true, location_name: "StackSetName"))
     ListStackSetOperationResultsInput.add_member(:operation_id, Shapes::ShapeRef.new(shape: ClientRequestToken, required: true, location_name: "OperationId"))
     ListStackSetOperationResultsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "NextToken"))
@@ -1827,6 +1841,12 @@ module Aws::CloudFormation
     StackSet.add_member(:regions, Shapes::ShapeRef.new(shape: RegionList, location_name: "Regions"))
     StackSet.struct_class = Types::StackSet
 
+    StackSetAutoDeploymentTargetSummaries.member = Shapes::ShapeRef.new(shape: StackSetAutoDeploymentTargetSummary)
+
+    StackSetAutoDeploymentTargetSummary.add_member(:organizational_unit_id, Shapes::ShapeRef.new(shape: OrganizationalUnitId, location_name: "OrganizationalUnitId"))
+    StackSetAutoDeploymentTargetSummary.add_member(:regions, Shapes::ShapeRef.new(shape: RegionList, location_name: "Regions"))
+    StackSetAutoDeploymentTargetSummary.struct_class = Types::StackSetAutoDeploymentTargetSummary
+
     StackSetDriftDetectionDetails.add_member(:drift_status, Shapes::ShapeRef.new(shape: StackSetDriftStatus, location_name: "DriftStatus"))
     StackSetDriftDetectionDetails.add_member(:drift_detection_status, Shapes::ShapeRef.new(shape: StackSetDriftDetectionStatus, location_name: "DriftDetectionStatus"))
     StackSetDriftDetectionDetails.add_member(:last_drift_check_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastDriftCheckTimestamp"))
@@ -2779,6 +2799,15 @@ module Aws::CloudFormation
         )
       end)
 
+      api.add_operation(:list_stack_set_auto_deployment_targets, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListStackSetAutoDeploymentTargets"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListStackSetAutoDeploymentTargetsInput)
+        o.output = Shapes::ShapeRef.new(shape: ListStackSetAutoDeploymentTargetsOutput)
+        o.errors << Shapes::ShapeRef.new(shape: StackSetNotFoundException)
+      end)
+
       api.add_operation(:list_stack_set_operation_results, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListStackSetOperationResults"
         o.http_method = "POST"

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

@@ -796,6 +796,20 @@ module Aws::CloudFormation
       end
     end
 
+    class ListStackSetAutoDeploymentTargets
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::CloudFormation::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 ListStackSetOperationResults
       def self.build(context)
         unless context.config.regional_endpoint

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

@@ -170,6 +170,8 @@ module Aws::CloudFormation
             Aws::CloudFormation::Endpoints::ListStackInstances.build(context)
           when :list_stack_resources
             Aws::CloudFormation::Endpoints::ListStackResources.build(context)
+          when :list_stack_set_auto_deployment_targets
+            Aws::CloudFormation::Endpoints::ListStackSetAutoDeploymentTargets.build(context)
           when :list_stack_set_operation_results
             Aws::CloudFormation::Endpoints::ListStackSetOperationResults.build(context)
           when :list_stack_set_operations

data/lib/aws-sdk-cloudformation/resource.rb

@@ -164,7 +164,7 @@ module Aws::CloudFormation
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
     #
-    #     * [ `AWS::IAM::AccessKey` AWS::IAM::AccessKey][1]
+    #     * [ `AWS::IAM::AccessKey` ][1]
     #
     #     * [ `AWS::IAM::Group` ][2]
     #

data/lib/aws-sdk-cloudformation/stack.rb

@@ -545,7 +545,7 @@ module Aws::CloudFormation
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
     #
-    #     * [ `AWS::IAM::AccessKey` AWS::IAM::AccessKey][1]
+    #     * [ `AWS::IAM::AccessKey` ][1]
     #
     #     * [ `AWS::IAM::Group` ][2]
     #

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

@@ -1198,7 +1198,7 @@ module Aws::CloudFormation
     #     you review all permissions associated with them and edit their
     #     permissions if necessary.
     #
-    #     * [ `AWS::IAM::AccessKey` AWS::IAM::AccessKey][1]
+    #     * [ `AWS::IAM::AccessKey` ][1]
     #
     #     * [ `AWS::IAM::Group` ][2]
     #
@@ -5185,6 +5185,82 @@ module Aws::CloudFormation
       include Aws::Structure
     end
 
+    # @!attribute [rw] stack_set_name
+    #   The name or unique ID of the stack set that you want to get
+    #   automatic deployment targets for.
+    #   @return [String]
+    #
+    # @!attribute [rw] next_token
+    #   A string that identifies the next page of stack set deployment
+    #   targets that you want to retrieve.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of results to be returned with a single call. If
+    #   the number of available results exceeds this maximum, the response
+    #   includes a `NextToken` value that you can assign to the `NextToken`
+    #   request parameter to get the next set of results.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] call_as
+    #   Specifies whether you are acting as an account administrator in the
+    #   organization's management account or as a delegated administrator
+    #   in a member account.
+    #
+    #   By default, `SELF` is specified. Use `SELF` for StackSets with
+    #   self-managed permissions.
+    #
+    #   * If you are signed in to the management account, specify `SELF`.
+    #
+    #   * If you are signed in to a delegated administrator account, specify
+    #     `DELEGATED_ADMIN`.
+    #
+    #     Your Amazon Web Services account must be registered as a delegated
+    #     administrator in the management account. For more information, see
+    #     [Register a delegated administrator][1] in the *CloudFormation
+    #     User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackSetAutoDeploymentTargetsInput AWS API Documentation
+    #
+    class ListStackSetAutoDeploymentTargetsInput < Struct.new(
+      :stack_set_name,
+      :next_token,
+      :max_results,
+      :call_as)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] summaries
+    #   An array of summaries of the deployment targets for the stack set.
+    #   @return [Array<Types::StackSetAutoDeploymentTargetSummary>]
+    #
+    # @!attribute [rw] next_token
+    #   If the request doesn't return all the remaining results,
+    #   `NextToken` is set to a token. To retrieve the next set of results,
+    #   call [ `ListStackSetAutoDeploymentTargets` ][1] again and use that
+    #   value for the `NextToken` parameter. If the request returns all
+    #   results, `NextToken` is set to an empty string.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ListStackSetAutoDeploymentTargets.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStackSetAutoDeploymentTargetsOutput AWS API Documentation
+    #
+    class ListStackSetAutoDeploymentTargetsOutput < Struct.new(
+      :summaries,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] stack_set_name
     #   The name or unique ID of the stack set that you want to get
     #   operation results for.
@@ -7939,6 +8015,13 @@ module Aws::CloudFormation
     #     a Region, the failure tolerance for the stack set operation as a
     #     whole might be exceeded.
     #
+    #   * `FAILED_IMPORT`: The import of the stack instance in the specified
+    #     account and Region failed and left the stack in an unstable state.
+    #     Once the issues causing the failure are fixed, the import
+    #     operation can be retried. If enough stack set operations fail in
+    #     enough accounts within a Region, the failure tolerance for the
+    #     stack set operation as a whole might be exceeded.
+    #
     #   * `INOPERABLE`: A `DeleteStackInstances` operation has failed and
     #     left the stack in an unstable state. Stacks in this state are
     #     excluded from further `UpdateStackSet` operations. You might need
@@ -8789,6 +8872,31 @@ module Aws::CloudFormation
       include Aws::Structure
     end
 
+    # One of the targets for the stack set. Returned by the [
+    # `ListStackSetAutoDeploymentTargets` ][1] API operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ListStackSetAutoDeploymentTargets.html
+    #
+    # @!attribute [rw] organizational_unit_id
+    #   The organization root ID or organizational unit (OU) IDs where the
+    #   stack set is targeted.
+    #   @return [String]
+    #
+    # @!attribute [rw] regions
+    #   The list of Regions targeted for this organization or OU.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/StackSetAutoDeploymentTargetSummary AWS API Documentation
+    #
+    class StackSetAutoDeploymentTargetSummary < Struct.new(
+      :organizational_unit_id,
+      :regions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Detailed information about the drift status of the stack set.
     #
     # For stack sets, contains information about the last *completed* drift

data/lib/aws-sdk-cloudformation.rb

@@ -57,6 +57,6 @@ require_relative 'aws-sdk-cloudformation/customizations'
 # @!group service
 module Aws::CloudFormation
 
-  GEM_VERSION = '1.101.0'
+  GEM_VERSION = '1.102.0'
 
 end

data/sig/client.rbs

@@ -1036,6 +1036,20 @@ module Aws
                                 ) -> _ListStackResourcesResponseSuccess
                               | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListStackResourcesResponseSuccess
 
+      interface _ListStackSetAutoDeploymentTargetsResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ListStackSetAutoDeploymentTargetsOutput]
+        def summaries: () -> ::Array[Types::StackSetAutoDeploymentTargetSummary]
+        def next_token: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudFormation/Client.html#list_stack_set_auto_deployment_targets-instance_method
+      def list_stack_set_auto_deployment_targets: (
+                                                    stack_set_name: ::String,
+                                                    ?next_token: ::String,
+                                                    ?max_results: ::Integer,
+                                                    ?call_as: ("SELF" | "DELEGATED_ADMIN")
+                                                  ) -> _ListStackSetAutoDeploymentTargetsResponseSuccess
+                                                | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListStackSetAutoDeploymentTargetsResponseSuccess
+
       interface _ListStackSetOperationResultsResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::ListStackSetOperationResultsOutput]
         def summaries: () -> ::Array[Types::StackSetOperationResultSummary]

data/sig/types.rbs

@@ -930,6 +930,20 @@ module Aws::CloudFormation
       SENSITIVE: []
     end
 
+    class ListStackSetAutoDeploymentTargetsInput
+      attr_accessor stack_set_name: ::String
+      attr_accessor next_token: ::String
+      attr_accessor max_results: ::Integer
+      attr_accessor call_as: ("SELF" | "DELEGATED_ADMIN")
+      SENSITIVE: []
+    end
+
+    class ListStackSetAutoDeploymentTargetsOutput
+      attr_accessor summaries: ::Array[Types::StackSetAutoDeploymentTargetSummary]
+      attr_accessor next_token: ::String
+      SENSITIVE: []
+    end
+
     class ListStackSetOperationResultsInput
       attr_accessor stack_set_name: ::String
       attr_accessor operation_id: ::String
@@ -1548,6 +1562,12 @@ module Aws::CloudFormation
       SENSITIVE: []
     end
 
+    class StackSetAutoDeploymentTargetSummary
+      attr_accessor organizational_unit_id: ::String
+      attr_accessor regions: ::Array[::String]
+      SENSITIVE: []
+    end
+
     class StackSetDriftDetectionDetails
       attr_accessor drift_status: ("DRIFTED" | "IN_SYNC" | "NOT_CHECKED")
       attr_accessor drift_detection_status: ("COMPLETED" | "FAILED" | "PARTIAL_SUCCESS" | "IN_PROGRESS" | "STOPPED")

metadata

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