software.amazon.awscdk.core

Class CustomResourceProps.Builder

java.lang.Object

software.amazon.awscdk.core.CustomResourceProps.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<CustomResourceProps>

Enclosing interface:

CustomResourceProps

@Stability(value=Stable)
public static final class CustomResourceProps.Builder
extends Object
implements software.amazon.jsii.Builder<CustomResourceProps>

A builder for CustomResourceProps

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
CustomResourceProps	build() Builds the configured instance.
CustomResourceProps.Builder	pascalCaseProperties(Boolean pascalCaseProperties) Sets the value of CustomResourceProps.getPascalCaseProperties()
CustomResourceProps.Builder	properties(Map<String,? extends Object> properties) Sets the value of CustomResourceProps.getProperties()
CustomResourceProps.Builder	removalPolicy(RemovalPolicy removalPolicy) Sets the value of CustomResourceProps.getRemovalPolicy()
CustomResourceProps.Builder	resourceType(String resourceType) Sets the value of CustomResourceProps.getResourceType()
CustomResourceProps.Builder	serviceToken(String serviceToken) Sets the value of CustomResourceProps.getServiceToken()

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Method Detail

serviceToken

@Stability(value=Stable)
public CustomResourceProps.Builder serviceToken(String serviceToken)

Sets the value of CustomResourceProps.getServiceToken()

Parameters:

serviceToken - The ARN of the provider which implements this custom resource type. This parameter is required. You can implement a provider by listening to raw AWS CloudFormation events and specify the ARN of an SNS topic (topic.topicArn) or the ARN of an AWS Lambda function (lambda.functionArn) or use the CDK's custom resource provider framework which makes it easier to implement robust providers.

Provider framework:

                     // 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();
                     

AWS Lambda function:

                     // invoke an AWS Lambda function when a lifecycle event occurs:
                     // invoke an AWS Lambda function when a lifecycle event occurs:
                     CustomResource.Builder.create(this, "MyResource")
                             .serviceToken(myFunction.getFunctionArn())
                             .build();
                     

SNS topic:

                     // publish lifecycle events to an SNS topic:
                     // publish lifecycle events to an SNS topic:
                     CustomResource.Builder.create(this, "MyResource")
                             .serviceToken(myTopic.getTopicArn())
                             .build();
                     

Returns:

this

pascalCaseProperties

@Stability(value=Stable)
public CustomResourceProps.Builder pascalCaseProperties(Boolean pascalCaseProperties)

Sets the value of CustomResourceProps.getPascalCaseProperties()

Parameters:

pascalCaseProperties - Convert all property keys to pascal case.

Returns:

this

properties

@Stability(value=Stable)
public CustomResourceProps.Builder properties(Map<String,? extends Object> properties)

Sets the value of CustomResourceProps.getProperties()

Parameters:

properties - Properties to pass to the Lambda.

Returns:

this

removalPolicy

@Stability(value=Stable)
public CustomResourceProps.Builder removalPolicy(RemovalPolicy removalPolicy)

Sets the value of CustomResourceProps.getRemovalPolicy()

Parameters:

removalPolicy - The policy to apply when this resource is removed from the application.

Returns:

this

resourceType

@Stability(value=Stable)
public CustomResourceProps.Builder resourceType(String resourceType)

Sets the value of CustomResourceProps.getResourceType()

Parameters:

resourceType - For custom resources, you can specify AWS::CloudFormation::CustomResource (the default) as the resource type, or you can specify your own resource type name. For example, you can use "Custom::MyCustomResourceTypeName".

Custom resource type names must begin with "Custom::" and can include alphanumeric characters and the following characters: _@-. You can specify a custom resource type name up to a maximum length of 60 characters. You cannot change the type during an update.

Using your own resource type names helps you quickly differentiate the types of custom resources in your stack. For example, if you had two custom resources that conduct two different ping tests, you could name their type as Custom::PingTester to make them easily identifiable as ping testers (instead of using AWS::CloudFormation::CustomResource).

Returns:

this

build

@Stability(value=Stable)
public CustomResourceProps build()

Builds the configured instance.

Specified by:

build in interface software.amazon.jsii.Builder<CustomResourceProps>

Returns:

a new instance of CustomResourceProps

Throws:

NullPointerException - if any required attribute was not provided