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.

      • stackStatusAsString

        public final String stackStatusAsString()

        Current status of the stack.

        If the service returns an enum value that is not available in the current SDK version, stackStatus will return StackStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from stackStatusAsString().

        Returns:
        Current status of the stack.
        See Also:
        StackStatus

      • 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 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 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 Protect a CloudFormation 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 Protect a CloudFormation 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 Embed stacks within other stacks using 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 Embed stacks within other stacks using 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 Embed stacks within other stacks using 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 Embed stacks within other stacks using 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

      • deletionMode

        public final DeletionMode deletionMode()

        Specifies the deletion mode for the stack. Possible values are:

        • STANDARD - Use the standard behavior. Specifying this value is the same as not specifying this parameter.

        • FORCE_DELETE_STACK - Delete the stack if it's stuck in a DELETE_FAILED state due to resource deletion failure.

        If the service returns an enum value that is not available in the current SDK version, deletionMode will return DeletionMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from deletionModeAsString().

        Returns:
        Specifies the deletion mode for the stack. Possible values are:

        • STANDARD - Use the standard behavior. Specifying this value is the same as not specifying this parameter.

        • FORCE_DELETE_STACK - Delete the stack if it's stuck in a DELETE_FAILED state due to resource deletion failure.

        See Also:
        DeletionMode

      • deletionModeAsString

        public final String deletionModeAsString()

        Specifies the deletion mode for the stack. Possible values are:

        • STANDARD - Use the standard behavior. Specifying this value is the same as not specifying this parameter.

        • FORCE_DELETE_STACK - Delete the stack if it's stuck in a DELETE_FAILED state due to resource deletion failure.

        If the service returns an enum value that is not available in the current SDK version, deletionMode will return DeletionMode.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from deletionModeAsString().

        Returns:
        Specifies the deletion mode for the stack. Possible values are:

        • STANDARD - Use the standard behavior. Specifying this value is the same as not specifying this parameter.

        • FORCE_DELETE_STACK - Delete the stack if it's stuck in a DELETE_FAILED state due to resource deletion failure.

        See Also:
        DeletionMode

      • detailedStatus

        public final DetailedStatus detailedStatus()

        The detailed status of the resource or stack. If CONFIGURATION_COMPLETE is present, the resource or resource configuration phase has completed and the stabilization of the resources is in progress. The stack sets CONFIGURATION_COMPLETE when all of the resources in the stack have reached that event. For more information, see Understand CloudFormation stack creation events in the CloudFormation User Guide.

        If the service returns an enum value that is not available in the current SDK version, detailedStatus will return DetailedStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from detailedStatusAsString().

        Returns:
        The detailed status of the resource or stack. If CONFIGURATION_COMPLETE is present, the resource or resource configuration phase has completed and the stabilization of the resources is in progress. The stack sets CONFIGURATION_COMPLETE when all of the resources in the stack have reached that event. For more information, see Understand CloudFormation stack creation events in the CloudFormation User Guide.
        See Also:
        DetailedStatus

      • detailedStatusAsString

        public final String detailedStatusAsString()

        The detailed status of the resource or stack. If CONFIGURATION_COMPLETE is present, the resource or resource configuration phase has completed and the stabilization of the resources is in progress. The stack sets CONFIGURATION_COMPLETE when all of the resources in the stack have reached that event. For more information, see Understand CloudFormation stack creation events in the CloudFormation User Guide.

        If the service returns an enum value that is not available in the current SDK version, detailedStatus will return DetailedStatus.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from detailedStatusAsString().

        Returns:
        The detailed status of the resource or stack. If CONFIGURATION_COMPLETE is present, the resource or resource configuration phase has completed and the stabilization of the resources is in progress. The stack sets CONFIGURATION_COMPLETE when all of the resources in the stack have reached that event. For more information, see Understand CloudFormation stack creation events in the CloudFormation User Guide.
        See Also:
        DetailedStatus

      • 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)