Interface ICfnResourceOptions

Namespace

Amazon.CDK

Assembly

Amazon.CDK.dll

public interface ICfnResourceOptions

Properties

Condition

A condition to associate with this resource.

CfnCondition? Condition { get; set; }

Property Value

CfnCondition

Remarks

This means that only if the condition evaluates to 'true' when the stack is deployed, the resource will be included. This is provided to allow CDK projects to produce legacy templates, but noramlly there is no need to use it in CDK projects.

CreationPolicy

Associate the CreationPolicy attribute with a resource to prevent its status from reaching create complete until AWS CloudFormation receives a specified number of success signals or the timeout period is exceeded.

ICfnCreationPolicy? CreationPolicy { get; set; }

Property Value

ICfnCreationPolicy

Remarks

To signal a resource, you can use the cfn-signal helper script or SignalResource API. AWS CloudFormation publishes valid signals to the stack events so that you track the number of signals sent.

DeletionPolicy

With the DeletionPolicy attribute you can preserve or (in some cases) backup a resource when its stack is deleted.

CfnDeletionPolicy? DeletionPolicy { get; set; }

Property Value

CfnDeletionPolicy?

Remarks

You specify a DeletionPolicy attribute for each resource that you want to control. If a resource has no DeletionPolicy attribute, AWS CloudFormation deletes the resource by default. Note that this capability also applies to update operations that lead to resources being removed.

Description

The description of this resource.

string? Description { get; set; }

Property Value

string

Remarks

Used for informational purposes only, is not processed in any way (and stays with the CloudFormation template, is not passed to the underlying resource, even if it does have a 'description' property).

Metadata

Metadata associated with the CloudFormation resource.

IDictionary<string, object>? Metadata { get; set; }

Property Value

IDictionary<string, object>

Remarks

This is not the same as the construct metadata which can be added using construct.addMetadata(), but would not appear in the CloudFormation template automatically.

UpdatePolicy

Use the UpdatePolicy attribute to specify how AWS CloudFormation handles updates to the AWS::AutoScaling::AutoScalingGroup resource.

ICfnUpdatePolicy? UpdatePolicy { get; set; }

Property Value

ICfnUpdatePolicy

Remarks

AWS CloudFormation invokes one of three update policies depending on the type of change you make or whether a scheduled action is associated with the Auto Scaling group.

UpdateReplacePolicy

Use the UpdateReplacePolicy attribute to retain or (in some cases) backup the existing physical instance of a resource when it is replaced during a stack update operation.

CfnDeletionPolicy? UpdateReplacePolicy { get; set; }

Property Value

CfnDeletionPolicy?

Version

The version of this resource.

string? Version { get; set; }

Property Value

string

Remarks

Used only for custom CloudFormation resources.

See: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cfn-customresource.html