software.amazon.awscdk.core

Class Resource

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

All Implemented Interfaces:

IDependable, IResource, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct

Direct Known Subclasses:

CustomResource

@Generated(value="jsii-pacmak/1.11.0 (build 1e9b8e1)",
           date="2020-09-13T06:02:42.282Z")
 @Stability(value=Stable)
public abstract class Resource
extends Construct
implements IResource

A construct which represents an AWS resource.

Nested Class Summary

Nested classes/interfaces inherited from class software.constructs.Construct

software.constructs.Construct.Builder

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

software.amazon.jsii.JsiiObject.InitializationMode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Resource(Construct scope, String id)
protected	Resource(Construct scope, String id, ResourceProps props)
protected	Resource(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Resource(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
protected String	generatePhysicalName()
ResourceEnvironment	getEnv() The environment this resource belongs to.
protected String	getPhysicalName() Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.
protected String	getResourceArnAttribute(String arnAttr, ArnComponents arnComponents) Returns an environment-sensitive token that should be used for the resource's "ARN" attribute (e.g.
protected String	getResourceNameAttribute(String nameAttr) Returns an environment-sensitive token that should be used for the resource's "name" attribute (e.g.
Stack	getStack() The stack in which this resource is defined.

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

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class software.constructs.Construct

toString

Methods inherited from class software.amazon.jsii.JsiiObject

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

Resource

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

Resource

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

Resource

@Stability(value=Stable)
protected Resource(@NotNull
                                            Construct scope,
                                            @NotNull
                                            String id,
                                            @Nullable
                                            ResourceProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props -

Resource

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

Parameters:

scope - This parameter is required.

id - This parameter is required.

Method Detail

generatePhysicalName

@Stability(value=Stable)
 @NotNull
protected String generatePhysicalName()

getResourceArnAttribute

@Stability(value=Experimental)
 @NotNull
protected String getResourceArnAttribute(@NotNull
                                                                                  String arnAttr,
                                                                                  @NotNull
                                                                                  ArnComponents arnComponents)

Returns an environment-sensitive token that should be used for the resource's "ARN" attribute (e.g. `bucket.bucketArn`).

Normally, this token will resolve to arnAttr, but if the resource is referenced across environments, arnComponents will be used to synthesize a concrete ARN with the resource's physical name. Make sure to reference this.physicalName in arnComponents.

EXPERIMENTAL

Parameters:

arnAttr - The CFN attribute which resolves to the ARN of the resource. This parameter is required.

arnComponents - The format of the ARN of this resource. This parameter is required.

getResourceNameAttribute

@Stability(value=Experimental)
 @NotNull
protected String getResourceNameAttribute(@NotNull
                                                                                   String nameAttr)

Returns an environment-sensitive token that should be used for the resource's "name" attribute (e.g. `bucket.bucketName`).

Normally, this token will resolve to nameAttr, but if the resource is referenced across environments, it will be resolved to this.physicalName, which will be a concrete name.

EXPERIMENTAL

Parameters:

nameAttr - The CFN attribute which resolves to the resource's name. This parameter is required.

getEnv

@Stability(value=Stable)
 @NotNull
public ResourceEnvironment getEnv()

The environment this resource belongs to.

For resources that are created and managed by the CDK (generally, those created by creating new class instances like Role, Bucket, etc.), this is always the same as the environment of the stack they belong to; however, for imported resources (those obtained from static methods like fromRoleArn, fromBucketName, etc.), that might be different than the stack they were imported into.

Specified by:

getEnv in interface IResource

getPhysicalName

@Stability(value=Experimental)
 @NotNull
protected String getPhysicalName()

Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

This value will resolve to one of the following:

• a concrete value (e.g. "my-awesome-bucket")
• undefined, when a name should be generated by CloudFormation
• a concrete name generated automatically during synthesis, in cross-environment scenarios.

EXPERIMENTAL

getStack

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

The stack in which this resource is defined.

Specified by:

getStack in interface IResource