Class CfnResource
Represents a CloudFormation resource.
Inheritance
Inherited Members
Namespace: Amazon.CDK
Assembly: Amazon.CDK.dll
Syntax (csharp)
public class CfnResource : CfnRefElement, IConstruct, IDependableSyntax (vb)
Public Class CfnResource
Inherits CfnRefElement
Implements IConstruct, IDependableRemarks
stability: Stable
Synopsis
Constructors
| CfnResource(Construct, String, ICfnResourceProps) | Creates a resource construct. |
| CfnResource(ByRefValue) | |
| CfnResource(DeputyBase.DeputyProps) |
Properties
| CfnOptions | Options for this resource, such as condition, update policy etc. |
| CfnProperties | |
| CfnResourceType | AWS resource type. |
| UpdatedProperites | Return properties modified after initiation. |
Methods
| AddDeletionOverride(String) | Syntactic sugar for |
| AddDependsOn(CfnResource) | Indicates that this resource depends on another resource and cannot be provisioned unless the other resource has been successfully provisioned. |
| AddOverride(String, Object) | Adds an override to the synthesized CloudFormation resource. |
| AddPropertyDeletionOverride(String) | Adds an override that deletes the value of a property from the resource definition. |
| AddPropertyOverride(String, Object) | |
| ApplyRemovalPolicy(Nullable<RemovalPolicy>, IRemovalPolicyOptions) | Sets the deletion policy of the resource based on the removal policy specified. |
| GetAtt(String) | Returns a token for an runtime attribute of this resource. Ideally, use generated attribute accessors (e.g. |
| IsCfnResource(IConstruct) | Check whether the given construct is a CfnResource. |
| RenderProperties(IDictionary<String, Object>) | |
| ToString() | Returns a string representation of this construct. |
| ValidateProperties(Object) |
Constructors
CfnResource(Construct, String, ICfnResourceProps)
Creates a resource construct.
public CfnResource(Construct scope, string id, ICfnResourceProps props)Parameters
- scope Construct
- id System.String
- props ICfnResourceProps
Remarks
stability: Stable
CfnResource(ByRefValue)
protected CfnResource(ByRefValue reference)Parameters
- reference Amazon.JSII.Runtime.Deputy.ByRefValue
CfnResource(DeputyBase.DeputyProps)
protected CfnResource(DeputyBase.DeputyProps props)Parameters
- props Amazon.JSII.Runtime.Deputy.DeputyBase.DeputyProps
Properties
CfnOptions
Options for this resource, such as condition, update policy etc.
public virtual ICfnResourceOptions CfnOptions { get; }Property Value
Remarks
stability: Stable
CfnProperties
protected virtual IDictionary<string, object> CfnProperties { get; }Property Value
System.Collections.Generic.IDictionary<System.String, System.Object>
Remarks
stability: Stable
CfnResourceType
AWS resource type.
public virtual string CfnResourceType { get; }Property Value
System.String
Remarks
stability: Stable
UpdatedProperites
Return properties modified after initiation.
protected virtual IDictionary<string, object> UpdatedProperites { get; }Property Value
System.Collections.Generic.IDictionary<System.String, System.Object>
Remarks
Resources that expose mutable properties should override this function to collect and return the properties object for this resource. stability: Stable
Methods
AddDeletionOverride(String)
Syntactic sugar for addOverride(path, undefined).
public virtual void AddDeletionOverride(string path)Parameters
- path System.String
The path of the value to delete.
Remarks
stability: Stable
AddDependsOn(CfnResource)
Indicates that this resource depends on another resource and cannot be provisioned unless the other resource has been successfully provisioned.
public virtual void AddDependsOn(CfnResource resource)Parameters
- resource CfnResource
Remarks
stability: Stable
AddOverride(String, Object)
Adds an override to the synthesized CloudFormation resource.
public virtual void AddOverride(string path, object value)Parameters
- path System.String
- The path of the property, you can use dot notation to override values in complex types.
- value System.Object
- The path of the property, you can use dot notation to override values in complex types.
Remarks
To add a
property override, either use addPropertyOverride or prefix path with
"Properties." (i.e. Properties.TopicName).
If the override is nested, separate each nested level using a dot (.) in the path parameter. If there is an array as part of the nesting, specify the index in the path.
For example,
addOverride('Properties.GlobalSecondaryIndexes.0.Projection.NonKeyAttributes', ['myattribute'])
addOverride('Properties.GlobalSecondaryIndexes.1.ProjectionType', 'INCLUDE')
would add the overrides
"Properties": {
"GlobalSecondaryIndexes": [
{
"Projection": {
"NonKeyAttributes": [ "myattribute" ]
...
}
...
},
{
"ProjectionType": "INCLUDE"
...
},
]
...
}
stability: Stable
AddPropertyDeletionOverride(String)
Adds an override that deletes the value of a property from the resource definition.
public virtual void AddPropertyDeletionOverride(string propertyPath)Parameters
- propertyPath System.String
The path to the property.
Remarks
stability: Stable
AddPropertyOverride(String, Object)
public virtual void AddPropertyOverride(string propertyPath, object value)Parameters
- propertyPath System.String
- value System.Object
ApplyRemovalPolicy(Nullable<RemovalPolicy>, IRemovalPolicyOptions)
Sets the deletion policy of the resource based on the removal policy specified.
public virtual void ApplyRemovalPolicy(Nullable<RemovalPolicy> policy = null, IRemovalPolicyOptions options = null)Parameters
- policy System.Nullable<RemovalPolicy>
- options IRemovalPolicyOptions
Remarks
stability: Stable
GetAtt(String)
Returns a token for an runtime attribute of this resource. Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility in case there is no generated attribute.
public virtual Reference GetAtt(string attributeName)Parameters
- attributeName System.String
The name of the attribute.
Returns
Remarks
stability: Stable
IsCfnResource(IConstruct)
Check whether the given construct is a CfnResource.
public static bool IsCfnResource(IConstruct construct)Parameters
- construct IConstruct
Returns
System.Boolean
Remarks
stability: Stable
RenderProperties(IDictionary<String, Object>)
protected virtual IDictionary<string, object> RenderProperties(IDictionary<string, object> props)Parameters
- props System.Collections.Generic.IDictionary<System.String, System.Object>
Returns
System.Collections.Generic.IDictionary<System.String, System.Object>
Remarks
stability: Stable
ToString()
Returns a string representation of this construct.
public override string ToString()Returns
System.String
a string representation of this resource
Overrides
Remarks
stability: Stable
ValidateProperties(Object)
protected virtual void ValidateProperties(object properties)Parameters
- properties System.Object
Remarks
stability: Stable