software.amazon.awscdk.customresources

Interface AwsCustomResourceProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

AwsCustomResourceProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.70.0 (build 03c2f6f)",
           date="2022-11-01T13:16:58.300Z")
 @Stability(value=Experimental)
public interface AwsCustomResourceProps
extends software.amazon.jsii.JsiiSerializable

(experimental) Properties for AwsCustomResource.

Note that at least onCreate, onUpdate or onDelete must be specified.

Example:

 AwsCustomResource awsCustom = AwsCustomResource.Builder.create(this, "aws-custom")
         .onCreate(AwsSdkCall.builder()
                 .service("...")
                 .action("...")
                 .parameters(Map.of(
                         "text", "..."))
                 .physicalResourceId(PhysicalResourceId.of("..."))
                 .build())
         .onUpdate(AwsSdkCall.builder()
                 .service("...")
                 .action("...")
                 .parameters(Map.of(
                         "text", "...",
                         "resourceId", new PhysicalResourceIdReference()))
                 .build())
         .policy(AwsCustomResourcePolicy.fromSdkCalls(SdkCallsPolicyOptions.builder()
                 .resources(AwsCustomResourcePolicy.ANY_RESOURCE)
                 .build()))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	AwsCustomResourceProps.Builder A builder for AwsCustomResourceProps
static class	AwsCustomResourceProps.Jsii$Proxy An implementation for AwsCustomResourceProps

Method Summary

Modifier and Type	Method and Description
static AwsCustomResourceProps.Builder	builder()
default String	getFunctionName() (experimental) A name for the singleton Lambda function implementing this custom resource.
default Boolean	getInstallLatestAwsSdk() (experimental) Whether to install the latest AWS SDK v2.
default RetentionDays	getLogRetention() (experimental) The number of days log events of the singleton Lambda function implementing this custom resource are kept in CloudWatch Logs.
default AwsSdkCall	getOnCreate() (experimental) The AWS SDK call to make when the resource is created.
default AwsSdkCall	getOnDelete() (experimental) The AWS SDK call to make when the resource is deleted.
default AwsSdkCall	getOnUpdate() (experimental) The AWS SDK call to make when the resource is updated.
AwsCustomResourcePolicy	getPolicy() (experimental) The policy that will be added to the execution role of the Lambda function implementing this custom resource provider.
default String	getResourceType() (experimental) Cloudformation Resource type.
default IRole	getRole() (experimental) The execution role for the singleton Lambda function implementing this custom resource provider.
default Duration	getTimeout() (experimental) The timeout for the singleton Lambda function implementing this custom resource.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getPolicy

@Stability(value=Experimental)
 @NotNull
AwsCustomResourcePolicy getPolicy()

(experimental) The policy that will be added to the execution role of the Lambda function implementing this custom resource provider.

The custom resource also implements iam.IGrantable, making it possible to use the grantXxx() methods.

As this custom resource uses a singleton Lambda function, it's important to note the that function's role will eventually accumulate the permissions/grants from all resources.

See Also:

Policy.fromSdkCalls

getFunctionName

@Stability(value=Experimental)
 @Nullable
default String getFunctionName()

(experimental) A name for the singleton Lambda function implementing this custom resource.

The function name will remain the same after the first AwsCustomResource is created in a stack.

Default: - AWS CloudFormation generates a unique physical ID and uses that ID for the function's name. For more information, see Name Type.

getInstallLatestAwsSdk

@Stability(value=Experimental)
 @Nullable
default Boolean getInstallLatestAwsSdk()

(experimental) Whether to install the latest AWS SDK v2. Allows to use the latest API calls documented at https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/index.html.

The installation takes around 60 seconds.

Default: true

getLogRetention

@Stability(value=Experimental)
 @Nullable
default RetentionDays getLogRetention()

(experimental) The number of days log events of the singleton Lambda function implementing this custom resource are kept in CloudWatch Logs.

Default: logs.RetentionDays.INFINITE

getOnCreate

@Stability(value=Experimental)
 @Nullable
default AwsSdkCall getOnCreate()

(experimental) The AWS SDK call to make when the resource is created.

Default: - the call when the resource is updated

getOnDelete

@Stability(value=Experimental)
 @Nullable
default AwsSdkCall getOnDelete()

(experimental) The AWS SDK call to make when the resource is deleted.

Default: - no call

getOnUpdate

@Stability(value=Experimental)
 @Nullable
default AwsSdkCall getOnUpdate()

(experimental) The AWS SDK call to make when the resource is updated.

Default: - no call

getResourceType

@Stability(value=Experimental)
 @Nullable
default String getResourceType()

(experimental) Cloudformation Resource type.

Default: - Custom::AWS

getRole

@Stability(value=Experimental)
 @Nullable
default IRole getRole()

(experimental) The execution role for the singleton Lambda function implementing this custom resource provider.

This role will apply to all AwsCustomResource instances in the stack. The role must be assumable by the lambda.amazonaws.com service principal.

Default: - a new role is created

getTimeout

@Stability(value=Experimental)
 @Nullable
default Duration getTimeout()

(experimental) The timeout for the singleton Lambda function implementing this custom resource.

Default: Duration.minutes(2)

builder

@Stability(value=Experimental)
static AwsCustomResourceProps.Builder builder()

Returns:

a AwsCustomResourceProps.Builder of AwsCustomResourceProps