Class StackSet
- java.lang.Object
-
- software.amazon.awssdk.services.cloudformation.model.StackSet
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<StackSet.Builder,StackSet>
@Generated("software.amazon.awssdk:codegen") public final class StackSet extends Object implements SdkPojo, Serializable, ToCopyableBuilder<StackSet.Builder,StackSet>
A structure that contains information about a StackSet. With StackSets, you can provision stacks across Amazon Web Services accounts and Regions from a single CloudFormation template. Each stack is based on the same CloudFormation template, but you can customize individual stacks using parameters.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceStackSet.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description StringadministrationRoleARN()The Amazon Resource Name (ARN) of the IAM role used to create or update the stack set.AutoDeploymentautoDeployment()Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit (OU).static StackSet.Builderbuilder()List<Capability>capabilities()The capabilities that are allowed in the StackSet.List<String>capabilitiesAsStrings()The capabilities that are allowed in the StackSet.Stringdescription()A description of the StackSet that you specify when the StackSet is created or updated.booleanequals(Object obj)booleanequalsBySdkFields(Object obj)StringexecutionRoleName()The name of the IAM execution role used to create or update the StackSet.<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)booleanhasCapabilities()For responses, this returns true if the service returned a value for the Capabilities property.inthashCode()booleanhasOrganizationalUnitIds()For responses, this returns true if the service returned a value for the OrganizationalUnitIds property.booleanhasParameters()For responses, this returns true if the service returned a value for the Parameters property.booleanhasRegions()For responses, this returns true if the service returned a value for the Regions property.booleanhasTags()For responses, this returns true if the service returned a value for the Tags property.ManagedExecutionmanagedExecution()Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.List<String>organizationalUnitIds()[Service-managed permissions] The organization root ID or organizational unit (OU) IDs that you specified for DeploymentTargets.List<Parameter>parameters()A list of input parameters for a StackSet.PermissionModelspermissionModel()Describes how the IAM roles required for StackSet operations are created.StringpermissionModelAsString()Describes how the IAM roles required for StackSet operations are created.List<String>regions()Returns a list of all Amazon Web Services Regions the given StackSet has stack instances deployed in.Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends StackSet.Builder>serializableBuilderClass()StringstackSetARN()The Amazon Resource Name (ARN) of the StackSet.StackSetDriftDetectionDetailsstackSetDriftDetectionDetails()Detailed information about the drift status of the StackSet.StringstackSetId()The ID of the StackSet.StringstackSetName()The name that's associated with the StackSet.StackSetStatusstatus()The status of the StackSet.StringstatusAsString()The status of the StackSet.List<Tag>tags()A list of tags that specify information about the StackSet.StringtemplateBody()The structure that contains the body of the template that was used to create or update the StackSet.StackSet.BuildertoBuilder()StringtoString()Returns a string representation of this object.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
stackSetName
public final String stackSetName()
The name that's associated with the StackSet.
- Returns:
- The name that's associated with the StackSet.
-
stackSetId
public final String stackSetId()
The ID of the StackSet.
- Returns:
- The ID of the StackSet.
-
description
public final String description()
A description of the StackSet that you specify when the StackSet is created or updated.
- Returns:
- A description of the StackSet that you specify when the StackSet is created or updated.
-
status
public final StackSetStatus status()
The status of the StackSet.
If the service returns an enum value that is not available in the current SDK version,
statuswill returnStackSetStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- The status of the StackSet.
- See Also:
StackSetStatus
-
statusAsString
public final String statusAsString()
The status of the StackSet.
If the service returns an enum value that is not available in the current SDK version,
statuswill returnStackSetStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromstatusAsString().- Returns:
- The status of the StackSet.
- See Also:
StackSetStatus
-
templateBody
public final String templateBody()
The structure that contains the body of the template that was used to create or update the StackSet.
- Returns:
- The structure that contains the body of the template that was used to create or update the StackSet.
-
hasParameters
public final boolean hasParameters()
For responses, this returns true if the service returned a value for the Parameters property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
parameters
public final List<Parameter> parameters()
A list of input parameters for a StackSet.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasParameters()method.- Returns:
- A list of input parameters for a StackSet.
-
capabilities
public final List<Capability> capabilities()
The capabilities that are allowed in the StackSet. Some StackSet 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.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasCapabilities()method.- Returns:
- The capabilities that are allowed in the StackSet. Some StackSet 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.
-
hasCapabilities
public final boolean hasCapabilities()
For responses, this returns true if the service returned a value for the Capabilities property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
capabilitiesAsStrings
public final List<String> capabilitiesAsStrings()
The capabilities that are allowed in the StackSet. Some StackSet 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.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasCapabilities()method.- Returns:
- The capabilities that are allowed in the StackSet. Some StackSet 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.
-
hasTags
public final boolean hasTags()
For responses, this returns true if the service returned a value for the Tags property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
tags
public final List<Tag> tags()
A list of tags that specify information about the StackSet. A maximum number of 50 tags can be specified.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasTags()method.- Returns:
- A list of tags that specify information about the StackSet. A maximum number of 50 tags can be specified.
-
stackSetARN
public final String stackSetARN()
The Amazon Resource Name (ARN) of the StackSet.
- Returns:
- The Amazon Resource Name (ARN) of the StackSet.
-
administrationRoleARN
public final String 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 StackSets within the same administrator account. For more information, see Prerequisites for using CloudFormation StackSets in the CloudFormation User Guide.
- Returns:
- 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 StackSets within the same administrator account. For more information, see Prerequisites for using CloudFormation StackSets in the CloudFormation User Guide.
-
executionRoleName
public final String executionRoleName()
The name of the IAM execution role used to create or update the StackSet.
Use customized execution roles to control which stack resources users and groups can include in their StackSets.
- Returns:
- The name of the IAM execution role used to create or update the StackSet.
Use customized execution roles to control which stack resources users and groups can include in their StackSets.
-
stackSetDriftDetectionDetails
public final StackSetDriftDetectionDetails stackSetDriftDetectionDetails()
Detailed information about the drift status of the StackSet.
For StackSets, contains information about the last completed drift operation performed on the StackSet. Information about drift operations currently in progress isn't included.
- Returns:
- Detailed information about the drift status of the StackSet.
For StackSets, contains information about the last completed drift operation performed on the StackSet. Information about drift operations currently in progress isn't included.
-
autoDeployment
public final AutoDeployment autoDeployment()
Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit (OU). Valid only if the StackSet uses service-managed permissions.
- Returns:
- Describes whether StackSets automatically deploys to Organizations accounts that are added to a target organization or organizational unit (OU). Valid only if the StackSet uses service-managed permissions.
-
permissionModel
public final PermissionModels permissionModel()
Describes how the IAM roles required for StackSet operations are created.
-
With
self-managedpermissions, you must create the administrator and execution roles required to deploy to target accounts. For more information, see Grant self-managed permissions. -
With
service-managedpermissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by Organizations. For more information, see Activate trusted access for StackSets with Organizations.
If the service returns an enum value that is not available in the current SDK version,
permissionModelwill returnPermissionModels.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available frompermissionModelAsString().- Returns:
- Describes how the IAM roles required for StackSet operations are created.
-
With
self-managedpermissions, you must create the administrator and execution roles required to deploy to target accounts. For more information, see Grant self-managed permissions. -
With
service-managedpermissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by Organizations. For more information, see Activate trusted access for StackSets with Organizations.
-
- See Also:
PermissionModels
-
-
permissionModelAsString
public final String permissionModelAsString()
Describes how the IAM roles required for StackSet operations are created.
-
With
self-managedpermissions, you must create the administrator and execution roles required to deploy to target accounts. For more information, see Grant self-managed permissions. -
With
service-managedpermissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by Organizations. For more information, see Activate trusted access for StackSets with Organizations.
If the service returns an enum value that is not available in the current SDK version,
permissionModelwill returnPermissionModels.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available frompermissionModelAsString().- Returns:
- Describes how the IAM roles required for StackSet operations are created.
-
With
self-managedpermissions, you must create the administrator and execution roles required to deploy to target accounts. For more information, see Grant self-managed permissions. -
With
service-managedpermissions, StackSets automatically creates the IAM roles required to deploy to accounts managed by Organizations. For more information, see Activate trusted access for StackSets with Organizations.
-
- See Also:
PermissionModels
-
-
hasOrganizationalUnitIds
public final boolean hasOrganizationalUnitIds()
For responses, this returns true if the service returned a value for the OrganizationalUnitIds property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
organizationalUnitIds
public final List<String> organizationalUnitIds()
[Service-managed permissions] The organization root ID or organizational unit (OU) IDs that you specified for DeploymentTargets.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasOrganizationalUnitIds()method.- Returns:
- [Service-managed permissions] The organization root ID or organizational unit (OU) IDs that you specified for DeploymentTargets.
-
managedExecution
public final ManagedExecution managedExecution()
Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.
- Returns:
- Describes whether StackSets performs non-conflicting operations concurrently and queues conflicting operations.
-
hasRegions
public final boolean hasRegions()
For responses, this returns true if the service returned a value for the Regions property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
-
regions
public final List<String> 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.
Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasRegions()method.- Returns:
- 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.
-
toBuilder
public StackSet.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<StackSet.Builder,StackSet>
-
builder
public static StackSet.Builder builder()
-
serializableBuilderClass
public static Class<? extends StackSet.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-