#[non_exhaustive]pub struct Builder { /* private fields */ }
Expand description
A builder for ResourceChangeDetail
Implementations
sourceimpl Builder
impl Builder
sourcepub fn target(self, input: ResourceTargetDefinition) -> Self
pub fn target(self, input: ResourceTargetDefinition) -> Self
A ResourceTargetDefinition
structure that describes the field that CloudFormation will change and whether the resource will be recreated.
sourcepub fn set_target(self, input: Option<ResourceTargetDefinition>) -> Self
pub fn set_target(self, input: Option<ResourceTargetDefinition>) -> Self
A ResourceTargetDefinition
structure that describes the field that CloudFormation will change and whether the resource will be recreated.
sourcepub fn evaluation(self, input: EvaluationType) -> Self
pub fn evaluation(self, input: EvaluationType) -> Self
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.
sourcepub fn set_evaluation(self, input: Option<EvaluationType>) -> Self
pub fn set_evaluation(self, input: Option<EvaluationType>) -> Self
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.
sourcepub fn change_source(self, input: ChangeSource) -> Self
pub fn change_source(self, input: ChangeSource) -> Self
The group to which the CausingEntity
value belongs. There are five entity groups:
-
ResourceReference
entities areRef
intrinsic functions that refer to resources in the template, such as{ "Ref" : "MyEC2InstanceResource" }
. -
ParameterReference
entities areRef
intrinsic functions that get template parameter values, such as{ "Ref" : "MyPasswordParameter" }
. -
ResourceAttribute
entities areFn::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 areAWS::CloudFormation::Stack
resource types, which are also known as nested stacks. If you made no changes to theAWS::CloudFormation::Stack
resource, CloudFormation sets theChangeSource
toAutomatic
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.
sourcepub fn set_change_source(self, input: Option<ChangeSource>) -> Self
pub fn set_change_source(self, input: Option<ChangeSource>) -> Self
The group to which the CausingEntity
value belongs. There are five entity groups:
-
ResourceReference
entities areRef
intrinsic functions that refer to resources in the template, such as{ "Ref" : "MyEC2InstanceResource" }
. -
ParameterReference
entities areRef
intrinsic functions that get template parameter values, such as{ "Ref" : "MyPasswordParameter" }
. -
ResourceAttribute
entities areFn::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 areAWS::CloudFormation::Stack
resource types, which are also known as nested stacks. If you made no changes to theAWS::CloudFormation::Stack
resource, CloudFormation sets theChangeSource
toAutomatic
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.
sourcepub fn causing_entity(self, input: impl Into<String>) -> Self
pub fn causing_entity(self, input: impl Into<String>) -> Self
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
.
sourcepub fn set_causing_entity(self, input: Option<String>) -> Self
pub fn set_causing_entity(self, input: Option<String>) -> Self
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
.
sourcepub fn build(self) -> ResourceChangeDetail
pub fn build(self) -> ResourceChangeDetail
Consumes the builder and constructs a ResourceChangeDetail
Trait Implementations
impl StructuralPartialEq for Builder
Auto Trait Implementations
impl RefUnwindSafe for Builder
impl Send for Builder
impl Sync for Builder
impl Unpin for Builder
impl UnwindSafe for Builder
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> Instrument for T
impl<T> Instrument for T
sourcefn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
sourcefn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
sourceimpl<T> WithSubscriber for T
impl<T> WithSubscriber for T
sourcefn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
sourcefn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more