software.amazon.awscdk.core

Class CfnElement

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.CfnElement

All Implemented Interfaces:

IConstruct, IDependable, software.amazon.jsii.JsiiSerializable

Direct Known Subclasses:

CfnCondition, CfnInclude, CfnOutput, CfnParameter, CfnRefElement

@Generated(value="jsii-pacmak/0.17.1 (build f4a0dbe)",
           date="2019-10-02T18:14:53.793Z")
 @Stability(value=Stable)
public abstract class CfnElement
extends Construct

An element of a CloudFormation stack.

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CfnElement(Construct scope, String id) Creates an entity and binds it to a tree.
protected	CfnElement(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CfnElement(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
List<String>	getCreationStack()
String	getLogicalId() The logical ID for this CloudFormation stack element.
Stack	getStack() The stack in which this element is defined.
static Boolean	isCfnElement(Object x) Returns `true` if a construct is a stack element (i.e.
void	overrideLogicalId(String newLogicalId) Overrides the auto-generated logical ID with a specific ID.
protected void	prepare() Automatically detect references in this CfnElement.

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, synthesize, toString, validate

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiCall, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticGet, jsiiStaticSet, setObjRef

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

CfnElement

protected CfnElement(software.amazon.jsii.JsiiObjectRef objRef)

CfnElement

protected CfnElement(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

CfnElement

@Stability(value=Stable)
protected CfnElement(Construct scope,
                                              String id)

Creates an entity and binds it to a tree. Note that the root of the tree must be a Stack object (not just any Root).

Parameters:

scope - The parent construct. This parameter is required.

id - This parameter is required.

Method Detail

isCfnElement

@Stability(value=Stable)
public static Boolean isCfnElement(Object x)

Returns `true` if a construct is a stack element (i.e. part of the synthesized cloudformation template). Uses duck-typing instead of `instanceof` to allow stack elements from different versions of this library to be included in the same stack.

Parameters:

x - This parameter is required.

Returns:

The construct as a stack element or undefined if it is not a stack element.

overrideLogicalId

@Stability(value=Stable)
public void overrideLogicalId(String newLogicalId)

Overrides the auto-generated logical ID with a specific ID.

Parameters:

newLogicalId - The new logical ID to use for this stack element. This parameter is required.

prepare

@Stability(value=Stable)
protected void prepare()

Automatically detect references in this CfnElement.

Overrides:

prepare in class Construct

getCreationStack

@Stability(value=Stable)
public List<String> getCreationStack()

Returns:

the stack trace of the point where this Resource was created from, sourced from the +metadata+ entry typed +aws:cdk:logicalId+, and with the bottom-most node +internal+ entries filtered.

getLogicalId

@Stability(value=Stable)
public String getLogicalId()

The logical ID for this CloudFormation stack element. The logical ID of the element is calculated from the path of the resource node in the construct tree. To override this value, use `overrideLogicalId(newLogicalId)`.

Returns:

the logical ID as a stringified token. This value will only get resolved during synthesis.

getStack

@Stability(value=Stable)
public Stack getStack()

The stack in which this element is defined. CfnElements must be defined within a stack scope (directly or indirectly).