Table Of Contents


User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . cloudformation ]



Returns the description of the specified stack set.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.


--stack-set-name <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]


--stack-set-name (string)

The name or unique ID of the stack set whose description you want.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.


StackSet -> (structure)

The specified stack set.

StackSetName -> (string)

The name that's associated with the stack set.

StackSetId -> (string)

The ID of the stack set.

Description -> (string)

A description of the stack set that you specify when the stack set is created or updated.

Status -> (string)

The status of the stack set.

TemplateBody -> (string)

The structure that contains the body of the template that was used to create or update the stack set.

Parameters -> (list)

A list of input parameters for a stack set.


The Parameter data type.

ParameterKey -> (string)

The key associated with the parameter. If you don't specify a key and value for a particular parameter, AWS CloudFormation uses the default value that is specified in your template.

ParameterValue -> (string)

The input value associated with the parameter.

UsePreviousValue -> (boolean)

During a stack update, use the existing parameter value that the stack is using for a given parameter key. If you specify true , do not specify a parameter value.

ResolvedValue -> (string)

Read-only. The value that corresponds to a Systems Manager parameter key. This field is returned only for ` SSM parameter types <>`__ in the template.

Capabilities -> (list)

The capabilities that are allowed in the stack set. Some stack set templates might include resources that can affect permissions in your AWS account—for example, by creating new AWS Identity and Access Management (IAM) users. For more information, see Acknowledging IAM Resources in AWS CloudFormation Templates.


Tags -> (list)

A list of tags that specify information about the stack set. A maximum number of 50 tags can be specified.


The Tag type enables you to specify a key-value pair that can be used to store information about an AWS CloudFormation stack.

Key -> (string)

Required . A string used to identify this tag. You can specify a maximum of 128 characters for a tag key. Tags owned by Amazon Web Services (AWS) have the reserved prefix: aws: .

Value -> (string)

Required . A string containing the value for this tag. You can specify a maximum of 256 characters for a tag value.

StackSetARN -> (string)

The Amazon Resource Number (ARN) of the stack set.

AdministrationRoleARN -> (string)

The Amazon Resource Number (ARN) of the IAM role used to create or update the stack set.

Use customized administrator roles to control which users or groups can manage specific stack sets within the same administrator account. For more information, see Prerequisites: Granting Permissions for Stack Set Operations in the AWS CloudFormation User Guide .

ExecutionRoleName -> (string)

The name of the IAM execution role used to create or update the stack set.

Use customized execution roles to control which stack resources users and groups can include in their stack sets.