stack_set

Gets an individual stack_set resource

Overview

Name	stack_set
Type	Resource
Description	stack_set
Id	awscc.cloudformation.stack_set

Fields

Name	Datatype	Description
stack_set_name	string	The name to associate with the stack set. The name must be unique in the Region where you create your stack set.
stack_set_id	string	The ID of the stack set that you're creating.
administration_role_arn	string	The Amazon Resource Number (ARN) of the IAM role to use to create this stack set. Specify an IAM role only if you are using customized administrator roles to control which users or groups can manage specific stack sets within the same administrator account.
auto_deployment	object	Describes whether StackSets automatically deploys to AWS Organizations accounts that are added to the target organization or organizational unit (OU). Specify only if PermissionModel is SERVICE_MANAGED.
capabilities	array	In some cases, you must explicitly acknowledge that your stack set template contains certain capabilities in order for AWS CloudFormation to create the stack set and related stack instances.
description	string	A description of the stack set. You can use the description to identify the stack set's purpose or other important information.
execution_role_name	string	The name of the IAM execution role to use to create the stack set. If you do not specify an execution role, AWS CloudFormation uses the AWSCloudFormationStackSetExecutionRole role for the stack set operation.
operation_preferences	object
stack_instances_group	array	A group of stack instances with parameters in some specific accounts and regions.
parameters	array	The input parameters for the stack set template.
permission_model	string	Describes how the IAM roles required for stack set operations are created. By default, SELF-MANAGED is specified.
tags	array	The key-value pairs to associate with this stack set and the stacks created from it. AWS CloudFormation also propagates these tags to supported resources that are created in the stacks. A maximum number of 50 tags can be specified.
template_body	string	The structure that contains the template body, with a minimum length of 1 byte and a maximum length of 51,200 bytes.
template_url	string	Location of file containing the template body. The URL must point to a template (max size: 460,800 bytes) that is located in an Amazon S3 bucket.
call_as	string	Specifies the AWS account that you are acting from. By default, SELF is specified. For self-managed permissions, specify SELF; for service-managed permissions, if you are signed in to the organization's management account, specify SELF. If you are signed in to a delegated administrator account, specify DELEGATED_ADMIN.
managed_execution	object	Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.
region	string	AWS region.

Methods

Currently only SELECT is supported for this resource resource.

Example

SELECT
region,
stack_set_name,
stack_set_id,
administration_role_arn,
auto_deployment,
capabilities,
description,
execution_role_name,
operation_preferences,
stack_instances_group,
parameters,
permission_model,
tags,
template_body,
template_url,
call_as,
managed_execution
FROM awscc.cloudformation.stack_set
WHERE data__Identifier = '<StackSetId>';

Permissions

To operate on the stack_set resource, the following permissions are required:

Read

cloudformation:DescribeStackSet,
cloudformation:ListStackInstances,
cloudformation:DescribeStackInstance

Update

cloudformation:GetTemplateSummary,
cloudformation:UpdateStackSet,
cloudformation:CreateStackInstances,
cloudformation:DeleteStackInstances,
cloudformation:UpdateStackInstances,
cloudformation:DescribeStackSet,
cloudformation:DescribeStackSetOperation,
cloudformation:ListStackSetOperationResults,
cloudformation:TagResource,
cloudformation:UntagResource,
iam:PassRole

Delete

cloudformation:DeleteStackSet,
cloudformation:DeleteStackInstances,
cloudformation:DescribeStackSet,
cloudformation:DescribeStackSetOperation,
cloudformation:ListStackSetOperationResults,
cloudformation:UntagResource