software.amazon.awssdk.services.cloudformation.model

Class ResourceChange

java.lang.Object

software.amazon.awssdk.services.cloudformation.model.ResourceChange

All Implemented Interfaces:

Serializable, SdkPojo, ToCopyableBuilder<ResourceChange.Builder,ResourceChange>

@Generated(value="software.amazon.awssdk:codegen")
public final class ResourceChange
extends Object
implements SdkPojo, Serializable, ToCopyableBuilder<ResourceChange.Builder,ResourceChange>

The ResourceChange structure describes the resource and the action that AWS CloudFormation will perform on it if you execute this change set.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ResourceChange.Builder

Method Summary

Modifier and Type	Method and Description
ChangeAction	action() The action that AWS CloudFormation takes on the resource, such as Add (adds a new resource), Modify (changes a resource), Remove (deletes a resource), Import (imports a resource), or Dynamic (exact action for the resource cannot be determined).
String	actionAsString() The action that AWS CloudFormation takes on the resource, such as Add (adds a new resource), Modify (changes a resource), Remove (deletes a resource), Import (imports a resource), or Dynamic (exact action for the resource cannot be determined).
static ResourceChange.Builder	builder()
String	changeSetId() The change set ID of the nested change set.
List<ResourceChangeDetail>	details() For the Modify action, a list of ResourceChangeDetail structures that describes the changes that AWS CloudFormation will make to the resource.
boolean	equals(Object obj)
boolean	equalsBySdkFields(Object obj)
<T> Optional<T>	getValueForField(String fieldName, Class<T> clazz)
boolean	hasDetails() Returns true if the Details property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
int	hashCode()
boolean	hasScope() Returns true if the Scope property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty).
String	logicalResourceId() The resource's logical ID, which is defined in the stack's template.
ModuleInfo	moduleInfo() Contains information about the module from which the resource was created, if the resource was created from a module included in the stack template.
String	physicalResourceId() The resource's physical ID (resource name).
Replacement	replacement() For the Modify action, indicates whether AWS CloudFormation will replace the resource by creating a new one and deleting the old one.
String	replacementAsString() For the Modify action, indicates whether AWS CloudFormation will replace the resource by creating a new one and deleting the old one.
String	resourceType() The type of AWS CloudFormation resource, such as AWS::S3::Bucket.
List<ResourceAttribute>	scope() For the Modify action, indicates which resource attribute is triggering this update, such as a change in the resource attribute's Metadata, Properties, or Tags.
List<String>	scopeAsStrings() For the Modify action, indicates which resource attribute is triggering this update, such as a change in the resource attribute's Metadata, Properties, or Tags.
List<SdkField<?>>	sdkFields()
static Class<? extends ResourceChange.Builder>	serializableBuilderClass()
ResourceChange.Builder	toBuilder()
String	toString() 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

action

public ChangeAction action()

The action that AWS CloudFormation takes on the resource, such as Add (adds a new resource), Modify (changes a resource), Remove (deletes a resource), Import (imports a resource), or Dynamic (exact action for the resource cannot be determined).

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

Returns:

The action that AWS CloudFormation takes on the resource, such as Add (adds a new resource), Modify (changes a resource), Remove (deletes a resource), Import (imports a resource), or Dynamic (exact action for the resource cannot be determined).

See Also:

ChangeAction

actionAsString

public String actionAsString()

The action that AWS CloudFormation takes on the resource, such as Add (adds a new resource), Modify (changes a resource), Remove (deletes a resource), Import (imports a resource), or Dynamic (exact action for the resource cannot be determined).

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

Returns:

The action that AWS CloudFormation takes on the resource, such as Add (adds a new resource), Modify (changes a resource), Remove (deletes a resource), Import (imports a resource), or Dynamic (exact action for the resource cannot be determined).

See Also:

ChangeAction

logicalResourceId

public String logicalResourceId()

The resource's logical ID, which is defined in the stack's template.

Returns:

The resource's logical ID, which is defined in the stack's template.

physicalResourceId

public String physicalResourceId()

The resource's physical ID (resource name). Resources that you are adding don't have physical IDs because they haven't been created.

Returns:

The resource's physical ID (resource name). Resources that you are adding don't have physical IDs because they haven't been created.

resourceType

public String resourceType()

The type of AWS CloudFormation resource, such as AWS::S3::Bucket.

Returns:

The type of AWS CloudFormation resource, such as AWS::S3::Bucket.

replacement

public Replacement replacement()

For the Modify action, indicates whether AWS CloudFormation will replace the resource by creating a new one and deleting the old one. This value depends on the value of the RequiresRecreation property in the ResourceTargetDefinition structure. For example, if the RequiresRecreation field is Always and the Evaluation field is Static, Replacement is True. If the RequiresRecreation field is Always and the Evaluation field is Dynamic, Replacement is Conditionally.

If you have multiple changes with different RequiresRecreation values, the Replacement value depends on the change with the most impact. A RequiresRecreation value of Always has the most impact, followed by Conditionally, and then Never.

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

Returns:

For the Modify action, indicates whether AWS CloudFormation will replace the resource by creating a new one and deleting the old one. This value depends on the value of the RequiresRecreation property in the ResourceTargetDefinition structure. For example, if the RequiresRecreation field is Always and the Evaluation field is Static, Replacement is True. If the RequiresRecreation field is Always and the Evaluation field is Dynamic, Replacement is Conditionally.

If you have multiple changes with different RequiresRecreation values, the Replacement value depends on the change with the most impact. A RequiresRecreation value of Always has the most impact, followed by Conditionally, and then Never.

See Also:

Replacement

replacementAsString

public String replacementAsString()

For the Modify action, indicates whether AWS CloudFormation will replace the resource by creating a new one and deleting the old one. This value depends on the value of the RequiresRecreation property in the ResourceTargetDefinition structure. For example, if the RequiresRecreation field is Always and the Evaluation field is Static, Replacement is True. If the RequiresRecreation field is Always and the Evaluation field is Dynamic, Replacement is Conditionally.

If you have multiple changes with different RequiresRecreation values, the Replacement value depends on the change with the most impact. A RequiresRecreation value of Always has the most impact, followed by Conditionally, and then Never.

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

Returns:

For the Modify action, indicates whether AWS CloudFormation will replace the resource by creating a new one and deleting the old one. This value depends on the value of the RequiresRecreation property in the ResourceTargetDefinition structure. For example, if the RequiresRecreation field is Always and the Evaluation field is Static, Replacement is True. If the RequiresRecreation field is Always and the Evaluation field is Dynamic, Replacement is Conditionally.

If you have multiple changes with different RequiresRecreation values, the Replacement value depends on the change with the most impact. A RequiresRecreation value of Always has the most impact, followed by Conditionally, and then Never.

See Also:

Replacement

scope

public List<ResourceAttribute> scope()

For the Modify action, indicates which resource attribute is triggering this update, such as a change in the resource attribute's Metadata, Properties, or Tags.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

You can use hasScope() to see if a value was sent in this field.

Returns:

For the Modify action, indicates which resource attribute is triggering this update, such as a change in the resource attribute's Metadata, Properties, or Tags .

hasScope

public boolean hasScope()

Returns true if the Scope property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.

scopeAsStrings

public List<String> scopeAsStrings()

For the Modify action, indicates which resource attribute is triggering this update, such as a change in the resource attribute's Metadata, Properties, or Tags.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

You can use hasScope() to see if a value was sent in this field.

Returns:

For the Modify action, indicates which resource attribute is triggering this update, such as a change in the resource attribute's Metadata, Properties, or Tags .

hasDetails

public boolean hasDetails()

Returns true if the Details property was specified by the sender (it may be empty), or false if the sender did not specify the value (it will be empty). For responses returned by the SDK, the sender is the AWS service.

details

public List<ResourceChangeDetail> details()

For the Modify action, a list of ResourceChangeDetail structures that describes the changes that AWS CloudFormation will make to the resource.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

You can use hasDetails() to see if a value was sent in this field.

Returns:

For the Modify action, a list of ResourceChangeDetail structures that describes the changes that AWS CloudFormation will make to the resource.

changeSetId

public String changeSetId()

The change set ID of the nested change set.

Returns:

The change set ID of the nested change set.

moduleInfo

public ModuleInfo moduleInfo()

Contains information about the module from which the resource was created, if the resource was created from a module included in the stack template.

Returns:

Contains information about the module from which the resource was created, if the resource was created from a module included in the stack template.

toBuilder

public ResourceChange.Builder toBuilder()

Specified by:

toBuilder in interface ToCopyableBuilder<ResourceChange.Builder,ResourceChange>

builder

public static ResourceChange.Builder builder()

serializableBuilderClass

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

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

equalsBySdkFields

public boolean equalsBySdkFields(Object obj)

Specified by:

equalsBySdkFields in interface SdkPojo

toString

public 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 <T> Optional<T> getValueForField(String fieldName,
                                        Class<T> clazz)

sdkFields

public List<SdkField<?>> sdkFields()

Specified by:

sdkFields in interface SdkPojo