@Generated(value="software.amazon.awssdk:codegen") public class ResourceChangeDetail extends Object implements ToCopyableBuilder<ResourceChangeDetail.Builder,ResourceChangeDetail>
For a resource with Modify
as the action, the ResourceChange
structure describes the
changes AWS CloudFormation will make to that resource.
Modifier and Type | Class and Description |
---|---|
static interface |
ResourceChangeDetail.Builder |
Modifier and Type | Method and Description |
---|---|
static ResourceChangeDetail.Builder |
builder() |
String |
causingEntity()
The identity of the entity that triggered this change.
|
ChangeSource |
changeSource()
The group to which the
CausingEntity value belongs. |
String |
changeSourceString()
The group to which the
CausingEntity value belongs. |
boolean |
equals(Object obj) |
EvaluationType |
evaluation()
Indicates whether AWS CloudFormation can determine the target value, and whether the target value will change
before you execute a change set.
|
String |
evaluationString()
Indicates whether AWS CloudFormation can determine the target value, and whether the target value will change
before you execute a change set.
|
<T> Optional<T> |
getValueForField(String fieldName,
Class<T> clazz) |
int |
hashCode() |
static Class<? extends ResourceChangeDetail.Builder> |
serializableBuilderClass() |
ResourceTargetDefinition |
target()
A
ResourceTargetDefinition structure that describes the field that AWS CloudFormation will change
and whether the resource will be recreated. |
ResourceChangeDetail.Builder |
toBuilder()
Take this object and create a builder that contains all of the current property values of this object.
|
String |
toString() |
copy
public ResourceTargetDefinition target()
A ResourceTargetDefinition
structure that describes the field that AWS CloudFormation will change
and whether the resource will be recreated.
ResourceTargetDefinition
structure that describes the field that AWS CloudFormation will
change and whether the resource will be recreated.public EvaluationType evaluation()
Indicates whether AWS CloudFormation can determine the target value, and whether the target value will change before you execute a change set.
For Static
evaluations, AWS CloudFormation can determine that the target value will change, and its
value. For example, if you directly modify the InstanceType
property of an EC2 instance, AWS
CloudFormation knows that this property value will change, and its value, so this is a Static
evaluation.
For Dynamic
evaluations, cannot determine the target value because it depends on the result of an
intrinsic function, such as a Ref
or Fn::GetAtt
intrinsic function, when the stack is
updated. For example, if your template includes a reference to a resource that is conditionally recreated, the
value of the reference (the physical ID of the resource) might change, depending on if the resource is recreated.
If the resource is recreated, it will have a new physical ID, so all references to that resource will also be
updated.
If the service returns an enum value that is not available in the current SDK version, evaluation
will
return EvaluationType.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
evaluationString()
.
For Static
evaluations, AWS CloudFormation can determine that the target value will change,
and its value. For example, if you directly modify the InstanceType
property of an EC2
instance, AWS CloudFormation knows that this property value will change, and its value, so this is a
Static
evaluation.
For Dynamic
evaluations, cannot determine the target value because it depends on the result
of an intrinsic function, such as a Ref
or Fn::GetAtt
intrinsic function, when
the stack is updated. For example, if your template includes a reference to a resource that is
conditionally recreated, the value of the reference (the physical ID of the resource) might change,
depending on if the resource is recreated. If the resource is recreated, it will have a new physical ID,
so all references to that resource will also be updated.
EvaluationType
public String evaluationString()
Indicates whether AWS CloudFormation can determine the target value, and whether the target value will change before you execute a change set.
For Static
evaluations, AWS CloudFormation can determine that the target value will change, and its
value. For example, if you directly modify the InstanceType
property of an EC2 instance, AWS
CloudFormation knows that this property value will change, and its value, so this is a Static
evaluation.
For Dynamic
evaluations, cannot determine the target value because it depends on the result of an
intrinsic function, such as a Ref
or Fn::GetAtt
intrinsic function, when the stack is
updated. For example, if your template includes a reference to a resource that is conditionally recreated, the
value of the reference (the physical ID of the resource) might change, depending on if the resource is recreated.
If the resource is recreated, it will have a new physical ID, so all references to that resource will also be
updated.
If the service returns an enum value that is not available in the current SDK version, evaluation
will
return EvaluationType.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
evaluationString()
.
For Static
evaluations, AWS CloudFormation can determine that the target value will change,
and its value. For example, if you directly modify the InstanceType
property of an EC2
instance, AWS CloudFormation knows that this property value will change, and its value, so this is a
Static
evaluation.
For Dynamic
evaluations, cannot determine the target value because it depends on the result
of an intrinsic function, such as a Ref
or Fn::GetAtt
intrinsic function, when
the stack is updated. For example, if your template includes a reference to a resource that is
conditionally recreated, the value of the reference (the physical ID of the resource) might change,
depending on if the resource is recreated. If the resource is recreated, it will have a new physical ID,
so all references to that resource will also be updated.
EvaluationType
public ChangeSource changeSource()
The group to which the CausingEntity
value belongs. There are five entity groups:
ResourceReference
entities are Ref
intrinsic functions that refer to resources in the
template, such as { "Ref" : "MyEC2InstanceResource" }
.
ParameterReference
entities are Ref
intrinsic functions that get template parameter
values, such as { "Ref" : "MyPasswordParameter" }
.
ResourceAttribute
entities are Fn::GetAtt
intrinsic functions that get resource
attribute values, such as { "Fn::GetAtt" : [ "MyEC2InstanceResource", "PublicDnsName" ] }
.
DirectModification
entities are changes that are made directly to the template.
Automatic
entities are AWS::CloudFormation::Stack
resource types, which are also known
as nested stacks. If you made no changes to the AWS::CloudFormation::Stack
resource, AWS
CloudFormation sets the ChangeSource
to Automatic
because the nested stack's template
might have changed. Changes to a nested stack's template aren't visible to AWS CloudFormation until you run an
update on the parent stack.
If the service returns an enum value that is not available in the current SDK version, changeSource
will
return ChangeSource.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
changeSourceString()
.
CausingEntity
value belongs. There are five entity groups:
ResourceReference
entities are Ref
intrinsic functions that refer to resources
in the template, such as { "Ref" : "MyEC2InstanceResource" }
.
ParameterReference
entities are Ref
intrinsic functions that get template
parameter values, such as { "Ref" : "MyPasswordParameter" }
.
ResourceAttribute
entities are Fn::GetAtt
intrinsic functions that get resource
attribute values, such as { "Fn::GetAtt" : [ "MyEC2InstanceResource", "PublicDnsName" ] }
.
DirectModification
entities are changes that are made directly to the template.
Automatic
entities are AWS::CloudFormation::Stack
resource types, which are
also known as nested stacks. If you made no changes to the AWS::CloudFormation::Stack
resource, AWS CloudFormation sets the ChangeSource
to Automatic
because the
nested stack's template might have changed. Changes to a nested stack's template aren't visible to AWS
CloudFormation until you run an update on the parent stack.
ChangeSource
public String changeSourceString()
The group to which the CausingEntity
value belongs. There are five entity groups:
ResourceReference
entities are Ref
intrinsic functions that refer to resources in the
template, such as { "Ref" : "MyEC2InstanceResource" }
.
ParameterReference
entities are Ref
intrinsic functions that get template parameter
values, such as { "Ref" : "MyPasswordParameter" }
.
ResourceAttribute
entities are Fn::GetAtt
intrinsic functions that get resource
attribute values, such as { "Fn::GetAtt" : [ "MyEC2InstanceResource", "PublicDnsName" ] }
.
DirectModification
entities are changes that are made directly to the template.
Automatic
entities are AWS::CloudFormation::Stack
resource types, which are also known
as nested stacks. If you made no changes to the AWS::CloudFormation::Stack
resource, AWS
CloudFormation sets the ChangeSource
to Automatic
because the nested stack's template
might have changed. Changes to a nested stack's template aren't visible to AWS CloudFormation until you run an
update on the parent stack.
If the service returns an enum value that is not available in the current SDK version, changeSource
will
return ChangeSource.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available from
changeSourceString()
.
CausingEntity
value belongs. There are five entity groups:
ResourceReference
entities are Ref
intrinsic functions that refer to resources
in the template, such as { "Ref" : "MyEC2InstanceResource" }
.
ParameterReference
entities are Ref
intrinsic functions that get template
parameter values, such as { "Ref" : "MyPasswordParameter" }
.
ResourceAttribute
entities are Fn::GetAtt
intrinsic functions that get resource
attribute values, such as { "Fn::GetAtt" : [ "MyEC2InstanceResource", "PublicDnsName" ] }
.
DirectModification
entities are changes that are made directly to the template.
Automatic
entities are AWS::CloudFormation::Stack
resource types, which are
also known as nested stacks. If you made no changes to the AWS::CloudFormation::Stack
resource, AWS CloudFormation sets the ChangeSource
to Automatic
because the
nested stack's template might have changed. Changes to a nested stack's template aren't visible to AWS
CloudFormation until you run an update on the parent stack.
ChangeSource
public String causingEntity()
The identity of the entity that triggered this change. This entity is a member of the group that is specified by
the ChangeSource
field. For example, if you modified the value of the KeyPairName
parameter, the CausingEntity
is the name of the parameter (KeyPairName
).
If the ChangeSource
value is DirectModification
, no value is given for
CausingEntity
.
ChangeSource
field. For example, if you modified the value of the
KeyPairName
parameter, the CausingEntity
is the name of the parameter (
KeyPairName
).
If the ChangeSource
value is DirectModification
, no value is given for
CausingEntity
.
public ResourceChangeDetail.Builder toBuilder()
ToCopyableBuilder
toBuilder
in interface ToCopyableBuilder<ResourceChangeDetail.Builder,ResourceChangeDetail>
public static ResourceChangeDetail.Builder builder()
public static Class<? extends ResourceChangeDetail.Builder> serializableBuilderClass()
Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.