software.amazon.awscdk.customresources

Class AwsCustomResource

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.customresources.AwsCustomResource

All Implemented Interfaces:

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

@Generated(value="jsii-pacmak/1.30.0 (build adae23f)",
           date="2021-06-30T10:01:44.017Z")
 @Stability(value=Experimental)
public class AwsCustomResource
extends software.constructs.Construct
implements IGrantable

(experimental) Defines a custom resource that is materialized using specific AWS API calls.

Use this to bridge any gap that might exist in the CloudFormation Coverage. You can specify exactly which calls are invoked for the 'CREATE', 'UPDATE' and 'DELETE' life cycle events.

Nested Class Summary

Nested Classes

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

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

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.iam.IGrantable

IGrantable.Jsii$Default, IGrantable.Jsii$Proxy

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default, software.constructs.IConstruct.Jsii$Proxy

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
IPrincipal	getGrantPrincipal() (experimental) The principal to grant permissions to.
String	getResponseField(String dataPath) (experimental) Returns response data for the AWS SDK call as string.
Reference	getResponseFieldReference(String dataPath) (experimental) Returns response data for the AWS SDK call.

Methods inherited from class software.constructs.Construct

getNode, isConstruct, 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.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

AwsCustomResource

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

AwsCustomResource

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

AwsCustomResource

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

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

getResponseField

@Stability(value=Experimental)
 @NotNull
public String getResponseField(@NotNull
                                                                        String dataPath)

(experimental) Returns response data for the AWS SDK call as string.

Example for S3 / listBucket : 'Buckets.0.Name'

Note that you cannot use this method if ignoreErrorCodesMatching is configured for any of the SDK calls. This is because in such a case, the response data might not exist, and will cause a CloudFormation deploy time error.

Parameters:

dataPath - the path to the data. This parameter is required.

getResponseFieldReference

@Stability(value=Experimental)
 @NotNull
public Reference getResponseFieldReference(@NotNull
                                                                                    String dataPath)

(experimental) Returns response data for the AWS SDK call.

Example for S3 / listBucket : 'Buckets.0.Name'

Use Token.asXxx to encode the returned Reference as a specific type or use the convenience getDataString for string attributes.

Note that you cannot use this method if ignoreErrorCodesMatching is configured for any of the SDK calls. This is because in such a case, the response data might not exist, and will cause a CloudFormation deploy time error.

Parameters:

dataPath - the path to the data. This parameter is required.

getGrantPrincipal

@Stability(value=Experimental)
 @NotNull
public IPrincipal getGrantPrincipal()

(experimental) The principal to grant permissions to.

Specified by:

getGrantPrincipal in interface IGrantable