software.amazon.awscdk.customresources

Class AwsCustomResourceProps.Builder

java.lang.Object

software.amazon.awscdk.customresources.AwsCustomResourceProps.Builder

Enclosing interface:

AwsCustomResourceProps

public static final class AwsCustomResourceProps.Builder
extends java.lang.Object

A builder for AwsCustomResourceProps

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
AwsCustomResourceProps	build() Builds the configured instance.
AwsCustomResourceProps.Builder	functionName(java.lang.String functionName) Sets the value of AwsCustomResourceProps.getFunctionName()
AwsCustomResourceProps.Builder	installLatestAwsSdk(java.lang.Boolean installLatestAwsSdk) Sets the value of AwsCustomResourceProps.getInstallLatestAwsSdk()
AwsCustomResourceProps.Builder	logRetention(RetentionDays logRetention) Sets the value of AwsCustomResourceProps.getLogRetention()
AwsCustomResourceProps.Builder	onCreate(AwsSdkCall onCreate) Sets the value of AwsCustomResourceProps.getOnCreate()
AwsCustomResourceProps.Builder	onDelete(AwsSdkCall onDelete) Sets the value of AwsCustomResourceProps.getOnDelete()
AwsCustomResourceProps.Builder	onUpdate(AwsSdkCall onUpdate) Sets the value of AwsCustomResourceProps.getOnUpdate()
AwsCustomResourceProps.Builder	policy(AwsCustomResourcePolicy policy) Sets the value of AwsCustomResourceProps.getPolicy()
AwsCustomResourceProps.Builder	resourceType(java.lang.String resourceType) Sets the value of AwsCustomResourceProps.getResourceType()
AwsCustomResourceProps.Builder	role(IRole role) Sets the value of AwsCustomResourceProps.getRole()
AwsCustomResourceProps.Builder	timeout(Duration timeout) Sets the value of AwsCustomResourceProps.getTimeout()

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

policy

public AwsCustomResourceProps.Builder policy(AwsCustomResourcePolicy policy)

Sets the value of AwsCustomResourceProps.getPolicy()

Parameters:

policy - The policy that will be added to the execution role of the Lambda function implementing this custom resource provider. This parameter is required. 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.

Returns:

this

functionName

public AwsCustomResourceProps.Builder functionName(java.lang.String functionName)

Sets the value of AwsCustomResourceProps.getFunctionName()

Parameters:

functionName - 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.

Returns:

this

installLatestAwsSdk

public AwsCustomResourceProps.Builder installLatestAwsSdk(java.lang.Boolean installLatestAwsSdk)

Sets the value of AwsCustomResourceProps.getInstallLatestAwsSdk()

Parameters:

installLatestAwsSdk - 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.

Returns:

this

logRetention

public AwsCustomResourceProps.Builder logRetention(RetentionDays logRetention)

Sets the value of AwsCustomResourceProps.getLogRetention()

Parameters:

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

Returns:

this

onCreate

public AwsCustomResourceProps.Builder onCreate(AwsSdkCall onCreate)

Sets the value of AwsCustomResourceProps.getOnCreate()

Parameters:

onCreate - The AWS SDK call to make when the resource is created.

Returns:

this

onDelete

public AwsCustomResourceProps.Builder onDelete(AwsSdkCall onDelete)

Sets the value of AwsCustomResourceProps.getOnDelete()

Parameters:

onDelete - The AWS SDK call to make when the resource is deleted.

Returns:

this

onUpdate

public AwsCustomResourceProps.Builder onUpdate(AwsSdkCall onUpdate)

Sets the value of AwsCustomResourceProps.getOnUpdate()

Parameters:

onUpdate - The AWS SDK call to make when the resource is updated.

Returns:

this

resourceType

public AwsCustomResourceProps.Builder resourceType(java.lang.String resourceType)

Sets the value of AwsCustomResourceProps.getResourceType()

Parameters:

resourceType - Cloudformation Resource type.

Returns:

this

role

public AwsCustomResourceProps.Builder role(IRole role)

Sets the value of AwsCustomResourceProps.getRole()

Parameters:

role - 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.

Returns:

this

timeout

public AwsCustomResourceProps.Builder timeout(Duration timeout)

Sets the value of AwsCustomResourceProps.getTimeout()

Parameters:

timeout - The timeout for the singleton Lambda function implementing this custom resource.

Returns:

this

build

public AwsCustomResourceProps build()

Builds the configured instance.

Returns:

a new instance of AwsCustomResourceProps

Throws:

java.lang.NullPointerException - if any required attribute was not provided