ImportStacksToStackSet
Import existing stacks into a new stack sets. Use the stack import operation to import up to 10 stacks into a new stack set 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.
ImportStacksToStackSet
is only supported by self-managed
permissions.
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- CallAs
-
By default,
SELF
is specified. UseSELF
for stack sets with self-managed permissions.-
If you are signed in to the management account, specify
SELF
. -
For service managed stack sets, specify
DELEGATED_ADMIN
.
Type: String
Valid Values:
SELF | DELEGATED_ADMIN
Required: No
-
- OperationId
-
A unique, user defined, identifier for the stack set operation.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 128.
Pattern:
[a-zA-Z0-9][-a-zA-Z0-9]*
Required: No
- OperationPreferences
-
The user-specified preferences for how Amazon CloudFormation performs a stack set operation.
For more information about maximum concurrent accounts and failure tolerance, see Stack set operation options.
Type: StackSetOperationPreferences object
Required: No
- OrganizationalUnitIds.member.N
-
The list of OU ID's to which the stacks being imported has to be mapped as deployment target.
Type: Array of strings
Pattern:
^(ou-[a-z0-9]{4,32}-[a-z0-9]{8,32}|r-[a-z0-9]{4,32})$
Required: No
- StackIds.member.N
-
The IDs of the stacks you are importing into a stack set. You import up to 10 stacks per stack set at a time.
Specify either
StackIds
orStackIdsUrl
.Type: Array of strings
Required: No
- StackIdsUrl
-
The Amazon S3 URL which contains list of stack ids to be inputted.
Specify either
StackIds
orStackIdsUrl
.Type: String
Length Constraints: Minimum length of 1. Maximum length of 5120.
Pattern:
(s3://|http(s?)://).+
Required: No
- StackSetName
-
The name of the stack set. The name must be unique in the Region where you create your stack set.
Type: String
Pattern:
[a-zA-Z][-a-zA-Z0-9]*(?::[a-zA-Z0-9]{8}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{4}-[a-zA-Z0-9]{12})?
Required: Yes
Response Elements
The following element is returned by the service.
- OperationId
-
The unique identifier for the stack set operation.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 128.
Pattern:
[a-zA-Z0-9][-a-zA-Z0-9]*
Errors
For information about the errors that are common to all actions, see Common Errors.
- InvalidOperation
-
The specified operation isn't valid.
HTTP Status Code: 400
- LimitExceeded
-
The quota for the resource has already been reached.
For information about resource and stack limitations, see Amazon CloudFormation quotas in the Amazon CloudFormation User Guide.
HTTP Status Code: 400
- OperationIdAlreadyExists
-
The specified operation ID already exists.
HTTP Status Code: 409
- OperationInProgress
-
Another operation is currently in progress for this stack set. Only one operation can be performed for a stack set at a given time.
HTTP Status Code: 409
- StackNotFound
-
The specified stack ARN doesn't exist or stack doesn't exist corresponding to the ARN in input.
HTTP Status Code: 404
- StackSetNotFound
-
The specified stack set doesn't exist.
HTTP Status Code: 404
- StaleRequest
-
Another operation has been performed on this stack set since the specified operation was performed.
HTTP Status Code: 409
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: