software.amazon.awscdk.core

Class CustomResource

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.core.CustomResource

All Implemented Interfaces:

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

Direct Known Subclasses:

CustomResource

@Generated(value="jsii-pacmak/1.50.0 (build d1830a4)",
           date="2022-01-04T15:39:01.056Z")
 @Stability(value=Experimental)
public class CustomResource
extends Resource

(experimental) Instantiation of a custom resource, whose implementation is provided a Provider.

This class is intended to be used by construct library authors. Application builder should not be able to tell whether or not a construct is backed by a custom resource, and so the use of this class should be invisible.

Instead, construct library authors declare a custom construct that hides the choice of provider, and accepts a strongly-typed properties object with the properties your provider accepts.

Your custom resource provider (identified by the serviceToken property) can be one of 4 constructs:

• If you are authoring a construct library or application, we recommend you use the Provider class in the custom-resources module.
• If you are authoring a construct for the CDK's AWS Construct Library, you should use the CustomResourceProvider construct in this package.
• If you want full control over the provider, you can always directly use a Lambda Function or SNS Topic by passing the ARN into serviceToken.

Example:

 // use the provider framework from aws-cdk/custom-resources:
 Provider provider = Provider.Builder.create(this, "ResourceProvider")
         .onEventHandler(onEventHandler)
         .isCompleteHandler(isCompleteHandler)
         .build();
 CustomResource.Builder.create(this, "MyResource")
         .serviceToken(provider.getServiceToken())
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CustomResource.Builder (experimental) A fluent builder for CustomResource.

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

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.core.IResource

IResource.Jsii$Default

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
Reference	getAtt(String attributeName) (experimental) Returns the value of an attribute of the custom resource of an arbitrary type.
String	getAttString(String attributeName) (experimental) Returns the value of an attribute of the custom resource of type string.
String	getRef() (experimental) The physical name of this custom resource.

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

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isResource

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, 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

CustomResource

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

CustomResource

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

CustomResource

@Stability(value=Experimental)
public CustomResource(@NotNull
                                                     software.constructs.Construct scope,
                                                     @NotNull
                                                     String id,
                                                     @NotNull
                                                     CustomResourceProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

getAtt

@Stability(value=Experimental)
 @NotNull
public Reference getAtt(@NotNull
                                                                 String attributeName)

(experimental) Returns the value of an attribute of the custom resource of an arbitrary type.

Attributes are returned from the custom resource provider through the Data map where the key is the attribute name.

Parameters:

attributeName - the name of the attribute. This parameter is required.

Returns:

a token for `Fn::GetAtt`. Use `Token.asXxx` to encode the returned `Reference` as a specific type or use the convenience `getAttString` for string attributes.

getAttString

@Stability(value=Experimental)
 @NotNull
public String getAttString(@NotNull
                                                                    String attributeName)

(experimental) Returns the value of an attribute of the custom resource of type string.

Attributes are returned from the custom resource provider through the Data map where the key is the attribute name.

Parameters:

attributeName - the name of the attribute. This parameter is required.

Returns:

a token for `Fn::GetAtt` encoded as a string.

getRef

@Stability(value=Experimental)
 @NotNull
public String getRef()

(experimental) The physical name of this custom resource.