Package software.amazon.awssdk.services.cloudformation.model

Class Stack

    • Method Detail

      • stackId

        public final String stackId()

        Unique identifier of the stack.

        Returns:
        Unique identifier of the stack.

      • stackName

        public final String stackName()

        The name associated with the stack.

        Returns:
        The name associated with the stack.

      • changeSetId

        public final String changeSetId()

        The unique ID of the change set.

        Returns:
        The unique ID of the change set.

      • description

        public final String description()

        A user-defined description associated with the stack.

        Returns:
        A user-defined description associated with the stack.

      • 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 the isEmpty() 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 Parameter structures.

        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 Parameter structures.

      • creationTime

        public final Instant creationTime()

        The time at which the stack was created.

        Returns:
        The time at which the stack was created.

      • deletionTime

        public final Instant deletionTime()

        The time the stack was deleted.

        Returns:
        The time the stack was deleted.

      • lastUpdatedTime

        public final Instant lastUpdatedTime()

        The time the stack was last updated. This field will only be returned if the stack has been updated at least once.

        Returns:
        The time the stack was last updated. This field will only be returned if the stack has been updated at least once.

      • rollbackConfiguration

        public final RollbackConfiguration rollbackConfiguration()

        The rollback triggers for CloudFormation to monitor during stack creation and updating operations, and for the specified monitoring period afterwards.

        Returns:
        The rollback triggers for CloudFormation to monitor during stack creation and updating operations, and for the specified monitoring period afterwards.

      • stackStatusReason

        public final String stackStatusReason()

        Success/failure message associated with the stack status.

        Returns:
        Success/failure message associated with the stack status.

      • disableRollback

        public final Boolean disableRollback()

        Boolean to enable or disable rollback on stack creation failures:

        • true: disable rollback.

        • false: enable rollback.

        Returns:
        Boolean to enable or disable rollback on stack creation failures:

        • true: disable rollback.

        • false: enable rollback.

      • hasNotificationARNs

        public final boolean hasNotificationARNs()
        For responses, this returns true if the service returned a value for the NotificationARNs property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

      • notificationARNs

        public final List<String> notificationARNs()

        Amazon SNS topic Amazon Resource Names (ARNs) to which stack related events are published.

        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 hasNotificationARNs() method.

        Returns:
        Amazon SNS topic Amazon Resource Names (ARNs) to which stack related events are published.

      • timeoutInMinutes

        public final Integer timeoutInMinutes()

        The amount of time within which stack creation should complete.

        Returns:
        The amount of time within which stack creation should complete.

      • capabilities

        public final List<Capability> capabilities()

        The capabilities allowed in the stack.

        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 allowed in the stack.

      • 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 the isEmpty() 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 allowed in the stack.

        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 allowed in the stack.

      • hasOutputs

        public final boolean hasOutputs()
        For responses, this returns true if the service returned a value for the Outputs property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() 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.

      • outputs

        public final List<Output> outputs()

        A list of output structures.

        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 hasOutputs() method.

        Returns:
        A list of output structures.

      • roleARN

        public final String roleARN()

        The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role that's associated with the stack. During a stack operation, CloudFormation uses this role's credentials to make calls on your behalf.

        Returns:
        The Amazon Resource Name (ARN) of an Identity and Access Management (IAM) role that's associated with the stack. During a stack operation, CloudFormation uses this role's credentials to make calls on your behalf.

      • 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 the isEmpty() 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 stack.

        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 stack.

      • enableTerminationProtection

        public final Boolean enableTerminationProtection()

        Whether termination protection is enabled for the stack.

        For nested stacks, termination protection is set on the root stack and can't be changed directly on the nested stack. For more information, see Protecting a Stack From Being Deleted in the CloudFormation User Guide.

        Returns:
        Whether termination protection is enabled for the stack.

        For nested stacks, termination protection is set on the root stack and can't be changed directly on the nested stack. For more information, see Protecting a Stack From Being Deleted in the CloudFormation User Guide.

      • parentId

        public final String parentId()

        For nested stacks--stacks created as resources for another stack--the stack ID of the direct parent of this stack. For the first level of nested stacks, the root stack is also the parent stack.

        For more information, see Working with Nested Stacks in the CloudFormation User Guide.

        Returns:
        For nested stacks--stacks created as resources for another stack--the stack ID of the direct parent of this stack. For the first level of nested stacks, the root stack is also the parent stack.

        For more information, see Working with Nested Stacks in the CloudFormation User Guide.

      • rootId

        public final String rootId()

        For nested stacks--stacks created as resources for another stack--the stack ID of the top-level stack to which the nested stack ultimately belongs.

        For more information, see Working with Nested Stacks in the CloudFormation User Guide.

        Returns:
        For nested stacks--stacks created as resources for another stack--the stack ID of the top-level stack to which the nested stack ultimately belongs.

        For more information, see Working with Nested Stacks in the CloudFormation User Guide.

      • retainExceptOnCreate

        public final Boolean retainExceptOnCreate()

        When set to true, newly created resources are deleted when the operation rolls back. This includes newly created resources marked with a deletion policy of Retain.

        Default: false

        Returns:
        When set to true, newly created resources are deleted when the operation rolls back. This includes newly created resources marked with a deletion policy of Retain.

        Default: false

      • serializableBuilderClass

        public static Class<? extends Stack.Builder> serializableBuilderClass()

      • hashCode

        public final int hashCode()
        Overrides:
        hashCode in class Object

      • equals

        public final boolean equals​(Object obj)
        Overrides:
        equals in class Object

      • 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.
        Overrides:
        toString in class Object

      • getValueForField

        public final <T> Optional<T> getValueForField​(String fieldName,
                                              Class<T> clazz)