Amazonka.CloudFormation.Types.StackSet

Documentation

data StackSet

A structure that contains information about a stack set. A stack set enables you to provision stacks into Amazon Web Services accounts and across Regions by using a single CloudFormation template. In the stack set, you specify the template to use, in addition to any parameters and capabilities that the template requires.

See: newStackSet smart constructor.

Constructors

StackSet'

Fields

• administrationRoleARN :: Maybe Text

  The Amazon Resource Name (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 CloudFormation User Guide.

• autoDeployment :: Maybe AutoDeployment

  Service-managed permissions

  Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit (OU).

• capabilities :: Maybe [Capability]

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

• description :: Maybe Text

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

• executionRoleName :: Maybe Text

  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.

• managedExecution :: Maybe ManagedExecution

  Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.

• organizationalUnitIds :: Maybe [Text]

  Service-managed permissions

  The organization root ID or organizational unit (OU) IDs that you specified for DeploymentTargets.

• parameters :: Maybe [Parameter]

  A list of input parameters for a stack set.

• permissionModel :: Maybe PermissionModels

  Describes how the IAM roles required for stack set operations are created.

  • With self-managed permissions, you must create the administrator and execution roles required to deploy to target accounts. For more information, see Grant Self-Managed Stack Set Permissions.
  • With service-managed permissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by Organizations. For more information, see Grant Service-Managed Stack Set Permissions.
• stackSetARN :: Maybe Text

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

• stackSetDriftDetectionDetails :: Maybe StackSetDriftDetectionDetails

  Detailed information about the drift status of the stack set.

  For stack sets, contains information about the last completed drift operation performed on the stack set. Information about drift operations currently in progress isn't included.

• stackSetId :: Maybe Text

  The ID of the stack set.

• stackSetName :: Maybe Text

  The name that's associated with the stack set.

• status :: Maybe StackSetStatus

  The status of the stack set.

• tags :: Maybe [Tag]

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

• templateBody :: Maybe Text

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

Instances

FromXML StackSet

Defined in Amazonka.CloudFormation.Types.StackSet

Methods

parseXML :: [Node] -> Either String StackSet

Generic StackSet

Defined in Amazonka.CloudFormation.Types.StackSet

Associated Types

type Rep StackSet :: Type -> Type

Methods

from :: StackSet -> Rep StackSet x

to :: Rep StackSet x -> StackSet

Read StackSet

Defined in Amazonka.CloudFormation.Types.StackSet

Methods

readsPrec :: Int -> ReadS StackSet

readList :: ReadS [StackSet]

readPrec :: ReadPrec StackSet

readListPrec :: ReadPrec [StackSet]

Show StackSet

Defined in Amazonka.CloudFormation.Types.StackSet

Methods

showsPrec :: Int -> StackSet -> ShowS

show :: StackSet -> String

showList :: [StackSet] -> ShowS

NFData StackSet

Defined in Amazonka.CloudFormation.Types.StackSet

Methods

rnf :: StackSet -> ()

Eq StackSet

Defined in Amazonka.CloudFormation.Types.StackSet

Methods

(==) :: StackSet -> StackSet -> Bool

(/=) :: StackSet -> StackSet -> Bool

Hashable StackSet

Defined in Amazonka.CloudFormation.Types.StackSet

Methods

hashWithSalt :: Int -> StackSet -> Int

hash :: StackSet -> Int

type Rep StackSet

Defined in Amazonka.CloudFormation.Types.StackSet

type Rep StackSet = D1 ('MetaData "StackSet" "Amazonka.CloudFormation.Types.StackSet" "amazonka-cloudformation-2.0-2g2oPzedi5AcwbDRlNZfB" 'False) (C1 ('MetaCons "StackSet'" 'PrefixI 'True) ((((S1 ('MetaSel ('Just "administrationRoleARN") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "autoDeployment") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe AutoDeployment))) :*: (S1 ('MetaSel ('Just "capabilities") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Capability])) :*: S1 ('MetaSel ('Just "description") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "executionRoleName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "managedExecution") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ManagedExecution))) :*: (S1 ('MetaSel ('Just "organizationalUnitIds") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Text])) :*: S1 ('MetaSel ('Just "parameters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Parameter]))))) :*: (((S1 ('MetaSel ('Just "permissionModel") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe PermissionModels)) :*: S1 ('MetaSel ('Just "stackSetARN") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "stackSetDriftDetectionDetails") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe StackSetDriftDetectionDetails)) :*: S1 ('MetaSel ('Just "stackSetId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))) :*: ((S1 ('MetaSel ('Just "stackSetName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "status") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe StackSetStatus))) :*: (S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Tag])) :*: S1 ('MetaSel ('Just "templateBody") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)))))))

newStackSet :: StackSet

Create a value of StackSet with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:administrationRoleARN:StackSet', stackSet_administrationRoleARN - The Amazon Resource Name (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 CloudFormation User Guide.

$sel:autoDeployment:StackSet', stackSet_autoDeployment - [Service-managed permissions] Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit (OU).

$sel:capabilities:StackSet', stackSet_capabilities - The capabilities that are allowed in the stack set. Some stack set templates might include resources that can affect permissions in your Amazon Web Services account—for example, by creating new Identity and Access Management (IAM) users. For more information, see Acknowledging IAM Resources in CloudFormation Templates.

$sel:description:StackSet', stackSet_description - A description of the stack set that you specify when the stack set is created or updated.

$sel:executionRoleName:StackSet', stackSet_executionRoleName - 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.

$sel:managedExecution:StackSet', stackSet_managedExecution - Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.

$sel:organizationalUnitIds:StackSet', stackSet_organizationalUnitIds - [Service-managed permissions] The organization root ID or organizational unit (OU) IDs that you specified for DeploymentTargets.

$sel:parameters:StackSet', stackSet_parameters - A list of input parameters for a stack set.

$sel:permissionModel:StackSet', stackSet_permissionModel - Describes how the IAM roles required for stack set operations are created.

• With self-managed permissions, you must create the administrator and execution roles required to deploy to target accounts. For more information, see Grant Self-Managed Stack Set Permissions.
• With service-managed permissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by Organizations. For more information, see Grant Service-Managed Stack Set Permissions.

$sel:stackSetARN:StackSet', stackSet_stackSetARN - The Amazon Resource Name (ARN) of the stack set.

$sel:stackSetDriftDetectionDetails:StackSet', stackSet_stackSetDriftDetectionDetails - Detailed information about the drift status of the stack set.

For stack sets, contains information about the last completed drift operation performed on the stack set. Information about drift operations currently in progress isn't included.

$sel:stackSetId:StackSet', stackSet_stackSetId - The ID of the stack set.

$sel:stackSetName:StackSet', stackSet_stackSetName - The name that's associated with the stack set.

$sel:status:StackSet', stackSet_status - The status of the stack set.

$sel:tags:StackSet', stackSet_tags - A list of tags that specify information about the stack set. A maximum number of 50 tags can be specified.

$sel:templateBody:StackSet', stackSet_templateBody - The structure that contains the body of the template that was used to create or update the stack set.

stackSet_administrationRoleARN :: Lens' StackSet (Maybe Text)

The Amazon Resource Name (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 CloudFormation User Guide.

stackSet_autoDeployment :: Lens' StackSet (Maybe AutoDeployment)

Service-managed permissions

Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit (OU).

stackSet_capabilities :: Lens' StackSet (Maybe [Capability])

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

stackSet_description :: Lens' StackSet (Maybe Text)

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

stackSet_executionRoleName :: Lens' StackSet (Maybe Text)

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.

stackSet_managedExecution :: Lens' StackSet (Maybe ManagedExecution)

Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.

stackSet_organizationalUnitIds :: Lens' StackSet (Maybe [Text])

Service-managed permissions

The organization root ID or organizational unit (OU) IDs that you specified for DeploymentTargets.

stackSet_parameters :: Lens' StackSet (Maybe [Parameter])

A list of input parameters for a stack set.

stackSet_permissionModel :: Lens' StackSet (Maybe PermissionModels)

Describes how the IAM roles required for stack set operations are created.

• With self-managed permissions, you must create the administrator and execution roles required to deploy to target accounts. For more information, see Grant Self-Managed Stack Set Permissions.
• With service-managed permissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by Organizations. For more information, see Grant Service-Managed Stack Set Permissions.

stackSet_stackSetARN :: Lens' StackSet (Maybe Text)

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

stackSet_stackSetDriftDetectionDetails :: Lens' StackSet (Maybe StackSetDriftDetectionDetails)

Detailed information about the drift status of the stack set.

For stack sets, contains information about the last completed drift operation performed on the stack set. Information about drift operations currently in progress isn't included.

stackSet_stackSetId :: Lens' StackSet (Maybe Text)

The ID of the stack set.

stackSet_stackSetName :: Lens' StackSet (Maybe Text)

The name that's associated with the stack set.

stackSet_status :: Lens' StackSet (Maybe StackSetStatus)

The status of the stack set.

stackSet_tags :: Lens' StackSet (Maybe [Tag])

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

stackSet_templateBody :: Lens' StackSet (Maybe Text)

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