software.amazon.awscdk.services.synthetics.alpha

Class Canary.Builder

java.lang.Object

software.amazon.awscdk.services.synthetics.alpha.Canary.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<Canary>

Enclosing class:

Canary

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

(experimental) A fluent builder for Canary.

Method Summary

Modifier and Type	Method and Description
Canary.Builder	artifactsBucketLocation(ArtifactsBucketLocation artifactsBucketLocation) (experimental) The s3 location that stores the data of the canary runs.
Canary	build()
Canary.Builder	canaryName(String canaryName) (experimental) The name of the canary.
static Canary.Builder	create(software.constructs.Construct scope, String id)
Canary.Builder	enableAutoDeleteLambdas(Boolean enableAutoDeleteLambdas) (experimental) Whether or not to delete the lambda resources when the canary is deleted.
Canary.Builder	environmentVariables(Map<String,String> environmentVariables) (experimental) Key-value pairs that the Synthetics caches and makes available for your canary scripts.
Canary.Builder	failureRetentionPeriod(Duration failureRetentionPeriod) (experimental) How many days should failed runs be retained.
Canary.Builder	role(IRole role) (experimental) Canary execution role.
Canary.Builder	runtime(Runtime runtime) (experimental) Specify the runtime version to use for the canary.
Canary.Builder	schedule(Schedule schedule) (experimental) Specify the schedule for how often the canary runs.
Canary.Builder	securityGroups(List<? extends ISecurityGroup> securityGroups) (experimental) The list of security groups to associate with the canary's network interfaces.
Canary.Builder	startAfterCreation(Boolean startAfterCreation) (experimental) Whether or not the canary should start after creation.
Canary.Builder	successRetentionPeriod(Duration successRetentionPeriod) (experimental) How many days should successful runs be retained.
Canary.Builder	test(Test test) (experimental) The type of test that you want your canary to run.
Canary.Builder	timeToLive(Duration timeToLive) (experimental) How long the canary will be in a 'RUNNING' state.
Canary.Builder	vpc(IVpc vpc) (experimental) The VPC where this canary is run.
Canary.Builder	vpcSubnets(SubnetSelection vpcSubnets) (experimental) Where to place the network interfaces within the VPC.

Methods inherited from class java.lang.Object

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

Method Detail

create

@Stability(value=Experimental)
public static Canary.Builder create(software.constructs.Construct scope,
                                                                   String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Returns:

a new instance of Canary.Builder.

runtime

@Stability(value=Experimental)
public Canary.Builder runtime(Runtime runtime)

(experimental) Specify the runtime version to use for the canary.

Parameters:

runtime - Specify the runtime version to use for the canary. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Library.html

test

@Stability(value=Experimental)
public Canary.Builder test(Test test)

(experimental) The type of test that you want your canary to run.

Use Test.custom() to specify the test to run.

Parameters:

test - The type of test that you want your canary to run. This parameter is required.

Returns:

this

artifactsBucketLocation

@Stability(value=Experimental)
public Canary.Builder artifactsBucketLocation(ArtifactsBucketLocation artifactsBucketLocation)

(experimental) The s3 location that stores the data of the canary runs.

Default: - A new s3 bucket will be created without a prefix.

Parameters:

artifactsBucketLocation - The s3 location that stores the data of the canary runs. This parameter is required.

Returns:

this

canaryName

@Stability(value=Experimental)
public Canary.Builder canaryName(String canaryName)

(experimental) The name of the canary.

Be sure to give it a descriptive name that distinguishes it from other canaries in your account.

Do not include secrets or proprietary information in your canary name. The canary name makes up part of the canary ARN, which is included in outbound calls over the internet.

Default: - A unique name will be generated from the construct ID

Parameters:

canaryName - The name of the canary. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/servicelens_canaries_security.html

enableAutoDeleteLambdas

@Stability(value=Experimental)
public Canary.Builder enableAutoDeleteLambdas(Boolean enableAutoDeleteLambdas)

(experimental) Whether or not to delete the lambda resources when the canary is deleted.

Default: false

Parameters:

enableAutoDeleteLambdas - Whether or not to delete the lambda resources when the canary is deleted. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-synthetics-canary.html#cfn-synthetics-canary-deletelambdaresourcesoncanarydeletion

environmentVariables

@Stability(value=Experimental)
public Canary.Builder environmentVariables(Map<String,String> environmentVariables)

(experimental) Key-value pairs that the Synthetics caches and makes available for your canary scripts.

Use environment variables to apply configuration changes, such as test and production environment configurations, without changing your Canary script source code.

Default: - No environment variables.

Parameters:

environmentVariables - Key-value pairs that the Synthetics caches and makes available for your canary scripts. This parameter is required.

Returns:

this

failureRetentionPeriod

@Stability(value=Experimental)
public Canary.Builder failureRetentionPeriod(Duration failureRetentionPeriod)

(experimental) How many days should failed runs be retained.

Default: Duration.days(31)

Parameters:

failureRetentionPeriod - How many days should failed runs be retained. This parameter is required.

Returns:

this

role

@Stability(value=Experimental)
public Canary.Builder role(IRole role)

(experimental) Canary execution role.

This is the role that will be assumed by the canary upon execution. It controls the permissions that the canary will have. The role must be assumable by the AWS Lambda service principal.

If not supplied, a role will be created with all the required permissions. If you provide a Role, you must add the required permissions.

Default: - A unique role will be generated for this canary. You can add permissions to roles by calling 'addToRolePolicy'.

Parameters:

role - Canary execution role. This parameter is required.

Returns:

this

See Also:

required permissions: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-synthetics-canary.html#cfn-synthetics-canary-executionrolearn

schedule

@Stability(value=Experimental)
public Canary.Builder schedule(Schedule schedule)

(experimental) Specify the schedule for how often the canary runs.

For example, if you set schedule to rate(10 minutes), then the canary will run every 10 minutes. You can set the schedule with Schedule.rate(Duration) (recommended) or you can specify an expression using Schedule.expression().

Default: 'rate(5 minutes)'

Parameters:

schedule - Specify the schedule for how often the canary runs. This parameter is required.

Returns:

this

securityGroups

@Stability(value=Experimental)
public Canary.Builder securityGroups(List<? extends ISecurityGroup> securityGroups)

(experimental) The list of security groups to associate with the canary's network interfaces.

You must provide vpc when using this prop.

Default: - If the canary is placed within a VPC and a security group is not specified a dedicated security group will be created for this canary.

Parameters:

securityGroups - The list of security groups to associate with the canary's network interfaces. This parameter is required.

Returns:

this

startAfterCreation

@Stability(value=Experimental)
public Canary.Builder startAfterCreation(Boolean startAfterCreation)

(experimental) Whether or not the canary should start after creation.

Default: true

Parameters:

startAfterCreation - Whether or not the canary should start after creation. This parameter is required.

Returns:

this

successRetentionPeriod

@Stability(value=Experimental)
public Canary.Builder successRetentionPeriod(Duration successRetentionPeriod)

(experimental) How many days should successful runs be retained.

Default: Duration.days(31)

Parameters:

successRetentionPeriod - How many days should successful runs be retained. This parameter is required.

Returns:

this

timeToLive

@Stability(value=Experimental)
public Canary.Builder timeToLive(Duration timeToLive)

(experimental) How long the canary will be in a 'RUNNING' state.

For example, if you set timeToLive to be 1 hour and schedule to be rate(10 minutes), your canary will run at 10 minute intervals for an hour, for a total of 6 times.

Default: - no limit

Parameters:

timeToLive - How long the canary will be in a 'RUNNING' state. This parameter is required.

Returns:

this

vpc

@Stability(value=Experimental)
public Canary.Builder vpc(IVpc vpc)

(experimental) The VPC where this canary is run.

Specify this if the canary needs to access resources in a VPC.

Default: - Not in VPC

Parameters:

vpc - The VPC where this canary is run. This parameter is required.

Returns:

this

vpcSubnets

@Stability(value=Experimental)
public Canary.Builder vpcSubnets(SubnetSelection vpcSubnets)

(experimental) Where to place the network interfaces within the VPC.

You must provide vpc when using this prop.

Default: - the Vpc default strategy if not specified

Parameters:

vpcSubnets - Where to place the network interfaces within the VPC. This parameter is required.

Returns:

this

build

@Stability(value=Experimental)
public Canary build()

Specified by:

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