Class ResourceChange
- java.lang.Object
-
- software.amazon.awssdk.services.cloudformation.model.ResourceChange
-
- All Implemented Interfaces:
Serializable
,SdkPojo
,ToCopyableBuilder<ResourceChange.Builder,ResourceChange>
@Generated("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 CloudFormation will perform on it if you execute this change set.- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interface
ResourceChange.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description ChangeAction
action()
The action that CloudFormation takes on the resource, such asAdd
(adds a new resource),Modify
(changes a resource),Remove
(deletes a resource),Import
(imports a resource), orDynamic
(exact action for the resource can't be determined).String
actionAsString()
The action that CloudFormation takes on the resource, such asAdd
(adds a new resource),Modify
(changes a resource),Remove
(deletes a resource),Import
(imports a resource), orDynamic
(exact action for the resource can't be determined).String
afterContext()
An encoded JSON string containing the context of the resource after the change is executed.String
beforeContext()
An encoded JSON string containing the context of the resource before the change is executed.static ResourceChange.Builder
builder()
String
changeSetId()
The change set ID of the nested change set.List<ResourceChangeDetail>
details()
For theModify
action, a list ofResourceChangeDetail
structures that describes the changes that 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()
For responses, this returns true if the service returned a value for the Details property.int
hashCode()
boolean
hasScope()
For responses, this returns true if the service returned a value for the Scope property.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).PolicyAction
policyAction()
The action that will be taken on the physical resource when the change set is executed.String
policyActionAsString()
The action that will be taken on the physical resource when the change set is executed.Replacement
replacement()
For theModify
action, indicates whether CloudFormation will replace the resource by creating a new one and deleting the old one.String
replacementAsString()
For theModify
action, indicates whether CloudFormation will replace the resource by creating a new one and deleting the old one.String
resourceType()
The type of CloudFormation resource, such asAWS::S3::Bucket
.List<ResourceAttribute>
scope()
For theModify
action, indicates which resource attribute is triggering this update, such as a change in the resource attribute'sMetadata
,Properties
, orTags
.List<String>
scopeAsStrings()
For theModify
action, indicates which resource attribute is triggering this update, such as a change in the resource attribute'sMetadata
,Properties
, orTags
.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
-
policyAction
public final PolicyAction policyAction()
The action that will be taken on the physical resource when the change set is executed.
-
Delete
The resource will be deleted. -
Retain
The resource will be retained. -
Snapshot
The resource will have a snapshot taken. -
ReplaceAndDelete
The resource will be replaced and then deleted. -
ReplaceAndRetain
The resource will be replaced and then retained. -
ReplaceAndSnapshot
The resource will be replaced and then have a snapshot taken.
If the service returns an enum value that is not available in the current SDK version,
policyAction
will returnPolicyAction.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available frompolicyActionAsString()
.- Returns:
- The action that will be taken on the physical resource when the change set is executed.
-
Delete
The resource will be deleted. -
Retain
The resource will be retained. -
Snapshot
The resource will have a snapshot taken. -
ReplaceAndDelete
The resource will be replaced and then deleted. -
ReplaceAndRetain
The resource will be replaced and then retained. -
ReplaceAndSnapshot
The resource will be replaced and then have a snapshot taken.
-
- See Also:
PolicyAction
-
-
policyActionAsString
public final String policyActionAsString()
The action that will be taken on the physical resource when the change set is executed.
-
Delete
The resource will be deleted. -
Retain
The resource will be retained. -
Snapshot
The resource will have a snapshot taken. -
ReplaceAndDelete
The resource will be replaced and then deleted. -
ReplaceAndRetain
The resource will be replaced and then retained. -
ReplaceAndSnapshot
The resource will be replaced and then have a snapshot taken.
If the service returns an enum value that is not available in the current SDK version,
policyAction
will returnPolicyAction.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available frompolicyActionAsString()
.- Returns:
- The action that will be taken on the physical resource when the change set is executed.
-
Delete
The resource will be deleted. -
Retain
The resource will be retained. -
Snapshot
The resource will have a snapshot taken. -
ReplaceAndDelete
The resource will be replaced and then deleted. -
ReplaceAndRetain
The resource will be replaced and then retained. -
ReplaceAndSnapshot
The resource will be replaced and then have a snapshot taken.
-
- See Also:
PolicyAction
-
-
action
public final ChangeAction action()
The action that CloudFormation takes on the resource, such as
Add
(adds a new resource),Modify
(changes a resource),Remove
(deletes a resource),Import
(imports a resource), orDynamic
(exact action for the resource can't be determined).If the service returns an enum value that is not available in the current SDK version,
action
will returnChangeAction.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromactionAsString()
.- Returns:
- The action that CloudFormation takes on the resource, such as
Add
(adds a new resource),Modify
(changes a resource),Remove
(deletes a resource),Import
(imports a resource), orDynamic
(exact action for the resource can't be determined). - See Also:
ChangeAction
-
actionAsString
public final String actionAsString()
The action that CloudFormation takes on the resource, such as
Add
(adds a new resource),Modify
(changes a resource),Remove
(deletes a resource),Import
(imports a resource), orDynamic
(exact action for the resource can't be determined).If the service returns an enum value that is not available in the current SDK version,
action
will returnChangeAction.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromactionAsString()
.- Returns:
- The action that CloudFormation takes on the resource, such as
Add
(adds a new resource),Modify
(changes a resource),Remove
(deletes a resource),Import
(imports a resource), orDynamic
(exact action for the resource can't be determined). - See Also:
ChangeAction
-
logicalResourceId
public final 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 final 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 final String resourceType()
The type of CloudFormation resource, such as
AWS::S3::Bucket
.- Returns:
- The type of CloudFormation resource, such as
AWS::S3::Bucket
.
-
replacement
public final Replacement replacement()
For the
Modify
action, indicates whether CloudFormation will replace the resource by creating a new one and deleting the old one. This value depends on the value of theRequiresRecreation
property in theResourceTargetDefinition
structure. For example, if theRequiresRecreation
field isAlways
and theEvaluation
field isStatic
,Replacement
isTrue
. If theRequiresRecreation
field isAlways
and theEvaluation
field isDynamic
,Replacement
isConditional
.If you have multiple changes with different
RequiresRecreation
values, theReplacement
value depends on the change with the most impact. ARequiresRecreation
value ofAlways
has the most impact, followed byConditional
, and thenNever
.If the service returns an enum value that is not available in the current SDK version,
replacement
will returnReplacement.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromreplacementAsString()
.- Returns:
- For the
Modify
action, indicates whether CloudFormation will replace the resource by creating a new one and deleting the old one. This value depends on the value of theRequiresRecreation
property in theResourceTargetDefinition
structure. For example, if theRequiresRecreation
field isAlways
and theEvaluation
field isStatic
,Replacement
isTrue
. If theRequiresRecreation
field isAlways
and theEvaluation
field isDynamic
,Replacement
isConditional
.If you have multiple changes with different
RequiresRecreation
values, theReplacement
value depends on the change with the most impact. ARequiresRecreation
value ofAlways
has the most impact, followed byConditional
, and thenNever
. - See Also:
Replacement
-
replacementAsString
public final String replacementAsString()
For the
Modify
action, indicates whether CloudFormation will replace the resource by creating a new one and deleting the old one. This value depends on the value of theRequiresRecreation
property in theResourceTargetDefinition
structure. For example, if theRequiresRecreation
field isAlways
and theEvaluation
field isStatic
,Replacement
isTrue
. If theRequiresRecreation
field isAlways
and theEvaluation
field isDynamic
,Replacement
isConditional
.If you have multiple changes with different
RequiresRecreation
values, theReplacement
value depends on the change with the most impact. ARequiresRecreation
value ofAlways
has the most impact, followed byConditional
, and thenNever
.If the service returns an enum value that is not available in the current SDK version,
replacement
will returnReplacement.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromreplacementAsString()
.- Returns:
- For the
Modify
action, indicates whether CloudFormation will replace the resource by creating a new one and deleting the old one. This value depends on the value of theRequiresRecreation
property in theResourceTargetDefinition
structure. For example, if theRequiresRecreation
field isAlways
and theEvaluation
field isStatic
,Replacement
isTrue
. If theRequiresRecreation
field isAlways
and theEvaluation
field isDynamic
,Replacement
isConditional
.If you have multiple changes with different
RequiresRecreation
values, theReplacement
value depends on the change with the most impact. ARequiresRecreation
value ofAlways
has the most impact, followed byConditional
, and thenNever
. - See Also:
Replacement
-
scope
public final List<ResourceAttribute> scope()
For the
Modify
action, indicates which resource attribute is triggering this update, such as a change in the resource attribute'sMetadata
,Properties
, orTags
.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
hasScope()
method.- Returns:
- For the
Modify
action, indicates which resource attribute is triggering this update, such as a change in the resource attribute'sMetadata
,Properties
, orTags
.
-
hasScope
public final boolean hasScope()
For responses, this returns true if the service returned a value for the Scope 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.
-
scopeAsStrings
public final List<String> scopeAsStrings()
For the
Modify
action, indicates which resource attribute is triggering this update, such as a change in the resource attribute'sMetadata
,Properties
, orTags
.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
hasScope()
method.- Returns:
- For the
Modify
action, indicates which resource attribute is triggering this update, such as a change in the resource attribute'sMetadata
,Properties
, orTags
.
-
hasDetails
public final boolean hasDetails()
For responses, this returns true if the service returned a value for the Details 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.
-
details
public final List<ResourceChangeDetail> details()
For the
Modify
action, a list ofResourceChangeDetail
structures that describes the changes that CloudFormation will make to the resource.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
hasDetails()
method.- Returns:
- For the
Modify
action, a list ofResourceChangeDetail
structures that describes the changes that CloudFormation will make to the resource.
-
changeSetId
public final String changeSetId()
The change set ID of the nested change set.
- Returns:
- The change set ID of the nested change set.
-
moduleInfo
public final 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.
-
beforeContext
public final String beforeContext()
An encoded JSON string containing the context of the resource before the change is executed.
- Returns:
- An encoded JSON string containing the context of the resource before the change is executed.
-
afterContext
public final String afterContext()
An encoded JSON string containing the context of the resource after the change is executed.
- Returns:
- An encoded JSON string containing the context of the resource after the change is executed.
-
toBuilder
public ResourceChange.Builder toBuilder()
- Specified by:
toBuilder
in interfaceToCopyableBuilder<ResourceChange.Builder,ResourceChange>
-
builder
public static ResourceChange.Builder builder()
-
serializableBuilderClass
public static Class<? extends ResourceChange.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFields
in 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.
-
-