Method: Aws::CloudFormation::Client#import_stacks_to_stack_set

Defined in:

lib/aws-sdk-cloudformation/client.rb

#import_stacks_to_stack_set(params = {}) ⇒ Types::ImportStacksToStackSetOutput

Import existing stacks into a new StackSets. Use the stack import operation to import up to 10 stacks into a new StackSet in the same account as the source stack or in a different administrator account and Region, by specifying the stack ID of the stack you intend to import.

Examples:

Request syntax with placeholder values

resp = client.import_stacks_to_stack_set({
  stack_set_name: "StackSetNameOrId", # required
  stack_ids: ["StackId"],
  stack_ids_url: "StackIdsUrl",
  organizational_unit_ids: ["OrganizationalUnitId"],
  operation_preferences: {
    region_concurrency_type: "SEQUENTIAL", # accepts SEQUENTIAL, PARALLEL
    region_order: ["Region"],
    failure_tolerance_count: 1,
    failure_tolerance_percentage: 1,
    max_concurrent_count: 1,
    max_concurrent_percentage: 1,
    concurrency_mode: "STRICT_FAILURE_TOLERANCE", # accepts STRICT_FAILURE_TOLERANCE, SOFT_FAILURE_TOLERANCE
  },
  operation_id: "ClientRequestToken",
  call_as: "SELF", # accepts SELF, DELEGATED_ADMIN
})

Response structure

resp.operation_id #=> String

Parameters:

• params (Hash) (defaults to: {}) —

  ({})

Options Hash (params):

• :stack_set_name (required, String) —

  The name of the StackSet. The name must be unique in the Region where you create your StackSet.

• :stack_ids (Array<String>) —

  The IDs of the stacks you are importing into a StackSet. You import up to 10 stacks per StackSet at a time.

  Specify either StackIds or StackIdsUrl.

• :stack_ids_url (String) —

  The Amazon S3 URL which contains list of stack ids to be inputted.

  Specify either StackIds or StackIdsUrl.

• :organizational_unit_ids (Array<String>) —

  The list of OU ID’s to which the imported stacks must be mapped as deployment targets.

• :operation_preferences (Types::StackSetOperationPreferences) —

  The user-specified preferences for how CloudFormation performs a StackSet operation.

  For more information about maximum concurrent accounts and failure tolerance, see [StackSet operation options].

  [1]: docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-concepts.html#stackset-ops-options

• :operation_id (String) —

  A unique, user defined, identifier for the StackSet operation.

  **A suitable default value is auto-generated.** You should normally not need to pass this option.**

• :call_as (String) —

  By default, SELF is specified. Use SELF for StackSets with self-managed permissions.

  • If you are signed in to the management account, specify SELF.

  • For service managed StackSets, specify DELEGATED_ADMIN.

Returns:

• (Types::ImportStacksToStackSetOutput) —

  Returns a response object which responds to the following methods:

  • #operation_id => String

See Also:

• AWS API Documentation

# File 'lib/aws-sdk-cloudformation/client.rb', line 5262

def import_stacks_to_stack_set(params = {}, options = {})
  req = build_request(:import_stacks_to_stack_set, params)
  req.send_request(options)
end