Interface StackSet.Builder
- All Superinterfaces:
Buildable
,CopyableBuilder<StackSet.Builder,
,StackSet> SdkBuilder<StackSet.Builder,
,StackSet> SdkPojo
- Enclosing class:
StackSet
-
Method Summary
Modifier and TypeMethodDescriptionadministrationRoleARN
(String administrationRoleARN) The Amazon Resource Name (ARN) of the IAM role used to create or update the stack set.default StackSet.Builder
autoDeployment
(Consumer<AutoDeployment.Builder> autoDeployment) [Service-managed permissions] Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit (OU).autoDeployment
(AutoDeployment autoDeployment) [Service-managed permissions] Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit (OU).capabilities
(Collection<Capability> capabilities) The capabilities that are allowed in the stack set.capabilities
(Capability... capabilities) The capabilities that are allowed in the stack set.capabilitiesWithStrings
(String... capabilities) The capabilities that are allowed in the stack set.capabilitiesWithStrings
(Collection<String> capabilities) The capabilities that are allowed in the stack set.description
(String description) A description of the stack set that you specify when the stack set is created or updated.executionRoleName
(String executionRoleName) The name of the IAM execution role used to create or update the stack set.default StackSet.Builder
managedExecution
(Consumer<ManagedExecution.Builder> managedExecution) Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.managedExecution
(ManagedExecution managedExecution) Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.organizationalUnitIds
(String... organizationalUnitIds) [Service-managed permissions] The organization root ID or organizational unit (OU) IDs that you specified for DeploymentTargets.organizationalUnitIds
(Collection<String> organizationalUnitIds) [Service-managed permissions] The organization root ID or organizational unit (OU) IDs that you specified for DeploymentTargets.parameters
(Collection<Parameter> parameters) A list of input parameters for a stack set.parameters
(Consumer<Parameter.Builder>... parameters) A list of input parameters for a stack set.parameters
(Parameter... parameters) A list of input parameters for a stack set.permissionModel
(String permissionModel) Describes how the IAM roles required for stack set operations are created.permissionModel
(PermissionModels permissionModel) Describes how the IAM roles required for stack set operations are created.Returns a list of all Amazon Web Services Regions the given StackSet has stack instances deployed in.regions
(Collection<String> regions) Returns a list of all Amazon Web Services Regions the given StackSet has stack instances deployed in.stackSetARN
(String stackSetARN) The Amazon Resource Name (ARN) of the stack set.default StackSet.Builder
stackSetDriftDetectionDetails
(Consumer<StackSetDriftDetectionDetails.Builder> stackSetDriftDetectionDetails) Detailed information about the drift status of the stack set.stackSetDriftDetectionDetails
(StackSetDriftDetectionDetails stackSetDriftDetectionDetails) Detailed information about the drift status of the stack set.stackSetId
(String stackSetId) The ID of the stack set.stackSetName
(String stackSetName) The name that's associated with the stack set.The status of the stack set.status
(StackSetStatus status) The status of the stack set.tags
(Collection<Tag> tags) A list of tags that specify information about the stack set.tags
(Consumer<Tag.Builder>... tags) A list of tags that specify information about the stack set.A list of tags that specify information about the stack set.templateBody
(String templateBody) The structure that contains the body of the template that was used to create or update the stack set.Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFields
-
Method Details
-
stackSetName
The name that's associated with the stack set.
- Parameters:
stackSetName
- The name that's associated with the stack set.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
stackSetId
The ID of the stack set.
- Parameters:
stackSetId
- The ID of the stack set.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
description
A description of the stack set that you specify when the stack set is created or updated.
- Parameters:
description
- A description of the stack set that you specify when the stack set is created or updated.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
status
The status of the stack set.
- Parameters:
status
- The status of the stack set.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
status
The status of the stack set.
- Parameters:
status
- The status of the stack set.- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
templateBody
The structure that contains the body of the template that was used to create or update the stack set.
- Parameters:
templateBody
- The structure that contains the body of the template that was used to create or update the stack set.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
parameters
A list of input parameters for a stack set.
- Parameters:
parameters
- A list of input parameters for a stack set.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
parameters
A list of input parameters for a stack set.
- Parameters:
parameters
- A list of input parameters for a stack set.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
parameters
A list of input parameters for a stack set.
This is a convenience method that creates an instance of theParameter.Builder
avoiding the need to create one manually viaParameter.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toparameters(List<Parameter>)
.- Parameters:
parameters
- a consumer that will call methods onParameter.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
capabilitiesWithStrings
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.
- Parameters:
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.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
capabilitiesWithStrings
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.
- Parameters:
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.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
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.
- Parameters:
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.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
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.
- Parameters:
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.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
A list of tags that specify information about the stack set. A maximum number of 50 tags can be specified.
- Parameters:
tags
- A list of tags that specify information about the stack set. A maximum number of 50 tags can be specified.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
A list of tags that specify information about the stack set. A maximum number of 50 tags can be specified.
- Parameters:
tags
- A list of tags that specify information about the stack set. A maximum number of 50 tags can be specified.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
tags
A list of tags that specify information about the stack set. A maximum number of 50 tags can be specified.
This is a convenience method that creates an instance of theTag.Builder
avoiding the need to create one manually viaTag.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed totags(List<Tag>)
.- Parameters:
tags
- a consumer that will call methods onTag.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
stackSetARN
The Amazon Resource Name (ARN) of the stack set.
- Parameters:
stackSetARN
- The Amazon Resource Name (ARN) of the stack set.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
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.
- Parameters:
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.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
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.
- Parameters:
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.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
stackSetDriftDetectionDetails
StackSet.Builder stackSetDriftDetectionDetails(StackSetDriftDetectionDetails 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.
- Parameters:
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.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
stackSetDriftDetectionDetails
default StackSet.Builder stackSetDriftDetectionDetails(Consumer<StackSetDriftDetectionDetails.Builder> 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.
This is a convenience method that creates an instance of theStackSetDriftDetectionDetails.Builder
avoiding the need to create one manually viaStackSetDriftDetectionDetails.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tostackSetDriftDetectionDetails(StackSetDriftDetectionDetails)
.- Parameters:
stackSetDriftDetectionDetails
- a consumer that will call methods onStackSetDriftDetectionDetails.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
autoDeployment
[Service-managed permissions] Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit (OU).
- Parameters:
autoDeployment
- [Service-managed permissions] Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit (OU).- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
autoDeployment
[Service-managed permissions] Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit (OU).
This is a convenience method that creates an instance of theAutoDeployment.Builder
avoiding the need to create one manually viaAutoDeployment.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toautoDeployment(AutoDeployment)
.- Parameters:
autoDeployment
- a consumer that will call methods onAutoDeployment.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
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.
- Parameters:
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.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
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.
- Parameters:
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.
-
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
-
organizationalUnitIds
[Service-managed permissions] The organization root ID or organizational unit (OU) IDs that you specified for DeploymentTargets.
- Parameters:
organizationalUnitIds
- [Service-managed permissions] The organization root ID or organizational unit (OU) IDs that you specified for DeploymentTargets.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
organizationalUnitIds
[Service-managed permissions] The organization root ID or organizational unit (OU) IDs that you specified for DeploymentTargets.
- Parameters:
organizationalUnitIds
- [Service-managed permissions] The organization root ID or organizational unit (OU) IDs that you specified for DeploymentTargets.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
managedExecution
Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.
- Parameters:
managedExecution
- Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
managedExecution
Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.
This is a convenience method that creates an instance of theManagedExecution.Builder
avoiding the need to create one manually viaManagedExecution.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed tomanagedExecution(ManagedExecution)
.- Parameters:
managedExecution
- a consumer that will call methods onManagedExecution.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
regions
Returns a list of all Amazon Web Services Regions the given StackSet has stack instances deployed in. The Amazon Web Services Regions list output is in no particular order.
- Parameters:
regions
- Returns a list of all Amazon Web Services Regions the given StackSet has stack instances deployed in. The Amazon Web Services Regions list output is in no particular order.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
regions
Returns a list of all Amazon Web Services Regions the given StackSet has stack instances deployed in. The Amazon Web Services Regions list output is in no particular order.
- Parameters:
regions
- Returns a list of all Amazon Web Services Regions the given StackSet has stack instances deployed in. The Amazon Web Services Regions list output is in no particular order.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-