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

Interface ResourceChangeDetail.Builder

All Superinterfaces:

Buildable, CopyableBuilder<ResourceChangeDetail.Builder,ResourceChangeDetail>, SdkBuilder<ResourceChangeDetail.Builder,ResourceChangeDetail>, SdkPojo

Enclosing class:

ResourceChangeDetail

public static interface ResourceChangeDetail.Builder
extends SdkPojo, CopyableBuilder<ResourceChangeDetail.Builder,ResourceChangeDetail>

Method Summary

Modifier and Type	Method	Description
ResourceChangeDetail.Builder	causingEntity(String causingEntity)	The identity of the entity that triggered this change.
ResourceChangeDetail.Builder	changeSource(String changeSource)	The group to which the CausingEntity value belongs.
ResourceChangeDetail.Builder	changeSource(ChangeSource changeSource)	The group to which the CausingEntity value belongs.
ResourceChangeDetail.Builder	evaluation(String evaluation)	Indicates whether CloudFormation can determine the target value, and whether the target value will change before you execute a change set.
ResourceChangeDetail.Builder	evaluation(EvaluationType evaluation)	Indicates whether CloudFormation can determine the target value, and whether the target value will change before you execute a change set.
default ResourceChangeDetail.Builder	target(Consumer<ResourceTargetDefinition.Builder> target)	A ResourceTargetDefinition structure that describes the field that CloudFormation will change and whether the resource will be recreated.
ResourceChangeDetail.Builder	target(ResourceTargetDefinition target)	A ResourceTargetDefinition structure that describes the field that CloudFormation will change and whether the resource will be recreated.

Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder

copy

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

applyMutation, build

Methods inherited from interface software.amazon.awssdk.core.SdkPojo

equalsBySdkFields, sdkFields

Method Detail

target

ResourceChangeDetail.Builder target(ResourceTargetDefinition target)

A ResourceTargetDefinition structure that describes the field that CloudFormation will change and whether the resource will be recreated.

Parameters:

target - A ResourceTargetDefinition structure that describes the field that CloudFormation will change and whether the resource will be recreated.

Returns:

Returns a reference to this object so that method calls can be chained together.

target

default ResourceChangeDetail.Builder target(Consumer<ResourceTargetDefinition.Builder> target)

A ResourceTargetDefinition structure that describes the field that CloudFormation will change and whether the resource will be recreated.

This is a convenience method that creates an instance of the ResourceTargetDefinition.Builder avoiding the need to create one manually via ResourceTargetDefinition.builder().

When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to target(ResourceTargetDefinition).

Parameters:

target - a consumer that will call methods on ResourceTargetDefinition.Builder

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

target(ResourceTargetDefinition)

evaluation

ResourceChangeDetail.Builder evaluation(String evaluation)

Indicates whether CloudFormation can determine the target value, and whether the target value will change before you execute a change set.

For Static evaluations, 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, CloudFormation knows that this property value will change, and its value, so this is a Static evaluation.

For Dynamic evaluations, can't 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's 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.

Parameters:

evaluation - Indicates whether CloudFormation can determine the target value, and whether the target value will change before you execute a change set.

For Static evaluations, 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, CloudFormation knows that this property value will change, and its value, so this is a Static evaluation.

For Dynamic evaluations, can't 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's 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.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

EvaluationType, EvaluationType

evaluation

ResourceChangeDetail.Builder evaluation(EvaluationType evaluation)

Indicates whether CloudFormation can determine the target value, and whether the target value will change before you execute a change set.

For Static evaluations, 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, CloudFormation knows that this property value will change, and its value, so this is a Static evaluation.

For Dynamic evaluations, can't 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's 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.

Parameters:

evaluation - Indicates whether CloudFormation can determine the target value, and whether the target value will change before you execute a change set.

For Static evaluations, 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, CloudFormation knows that this property value will change, and its value, so this is a Static evaluation.

For Dynamic evaluations, can't 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's 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.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

EvaluationType, EvaluationType

changeSource

ResourceChangeDetail.Builder changeSource(String 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, 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 CloudFormation until you run an update on the parent stack.

Parameters:

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, 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 CloudFormation until you run an update on the parent stack.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

ChangeSource, ChangeSource

changeSource

ResourceChangeDetail.Builder changeSource(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, 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 CloudFormation until you run an update on the parent stack.

Parameters:

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, 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 CloudFormation until you run an update on the parent stack.

Returns:

Returns a reference to this object so that method calls can be chained together.

See Also:

ChangeSource, ChangeSource

causingEntity

ResourceChangeDetail.Builder causingEntity(String causingEntity)

The identity of the entity that triggered this change. This entity is a member of the group that's 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.

Parameters:

causingEntity - The identity of the entity that triggered this change. This entity is a member of the group that's 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.

Returns:

Returns a reference to this object so that method calls can be chained together.