Package com.pulumi.aws.synthetics

Class CanaryArgs

  • public final class CanaryArgs
extends com.pulumi.resources.ResourceArgs

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  CanaryArgs.Builder  

      • Nested classes/interfaces inherited from class com.pulumi.resources.InputArgs

        com.pulumi.resources.InputArgs.InputArgsInternal

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static CanaryArgs Empty  

    • Method Detail

      • artifactConfig

        public java.util.Optional<com.pulumi.core.Output<CanaryArtifactConfigArgs>> artifactConfig()
        Returns:
        configuration for canary artifacts, including the encryption-at-rest settings for artifacts that the canary uploads to Amazon S3. See Artifact Config.

      • artifactS3Location

        public com.pulumi.core.Output<java.lang.String> artifactS3Location()
        Returns:
        Location in Amazon S3 where Synthetics stores artifacts from the test runs of this canary.

      • deleteLambda

        public java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> deleteLambda()
        Returns:
        Specifies whether to also delete the Lambda functions and layers used by this canary. The default is `false`.

      • executionRoleArn

        public com.pulumi.core.Output<java.lang.String> executionRoleArn()
        Returns:
        ARN of the IAM role to be used to run the canary. see [AWS Docs](https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_CreateCanary.html#API_CreateCanary_RequestSyntax) for permissions needs for IAM Role.

      • failureRetentionPeriod

        public java.util.Optional<com.pulumi.core.Output<java.lang.Integer>> failureRetentionPeriod()
        Returns:
        Number of days to retain data about failed runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days.

      • handler

        public com.pulumi.core.Output<java.lang.String> handler()
        Returns:
        Entry point to use for the source code when running the canary. This value must end with the string `.handler` .

      • kmsKeyArn

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> kmsKeyArn()
        Returns:
        ARN of the customer-managed KMS key used to encrypt the environment variables of the canary's Lambda function at rest. If omitted, an AWS owned key is used. Note that this is distinct from `artifact_config.s3_encryption.kms_key_arn`, which encrypts the artifacts the canary uploads to Amazon S3.

      • name

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> name()
        Returns:
        Name for this canary. Has a maximum length of 255 characters. Valid characters are lowercase alphanumeric, hyphen, or underscore.

      • region

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> region()
        Returns:
        Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration.

      • runConfig

        public java.util.Optional<com.pulumi.core.Output<CanaryRunConfigArgs>> runConfig()
        Returns:
        Configuration block for individual canary runs. Detailed below.

      • runtimeVersion

        public com.pulumi.core.Output<java.lang.String> runtimeVersion()
        Returns:
        Runtime version to use for the canary. Versions change often so consult the [Amazon CloudWatch documentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Library.html) for the latest valid versions. Values include `syn-python-selenium-1.0`, `syn-nodejs-puppeteer-3.0`, `syn-nodejs-2.2`, `syn-nodejs-2.1`, `syn-nodejs-2.0`, and `syn-1.0`.

      • s3Bucket

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> s3Bucket()
        Returns:
        Full bucket name which is used if your canary script is located in S3. The bucket must already exist. **Conflicts with `zipFile`.**

      • s3Key

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> s3Key()
        Returns:
        S3 key of your script. **Conflicts with `zipFile`.**

      • s3Version

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> s3Version()
        Returns:
        S3 version ID of your script. **Conflicts with `zipFile`.**

      • schedule

        public com.pulumi.core.Output<CanaryScheduleArgs> schedule()
        Returns:
        Configuration block providing how often the canary is to run and when these test runs are to stop. Detailed below. The following arguments are optional:

      • startCanary

        public java.util.Optional<com.pulumi.core.Output<java.lang.Boolean>> startCanary()
        Returns:
        Whether to run or stop the canary.

      • successRetentionPeriod

        public java.util.Optional<com.pulumi.core.Output<java.lang.Integer>> successRetentionPeriod()
        Returns:
        Number of days to retain data about successful runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days.

      • tags

        public java.util.Optional<com.pulumi.core.Output<java.util.Map<java.lang.String,​java.lang.String>>> tags()
        Returns:
        Key-value map of resource tags. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.

      • vpcConfig

        public java.util.Optional<com.pulumi.core.Output<CanaryVpcConfigArgs>> vpcConfig()
        Returns:
        Configuration block. Detailed below.

      • zipFile

        public java.util.Optional<com.pulumi.core.Output<java.lang.String>> zipFile()
        Returns:
        ZIP file that contains the script, if you input your canary script directly into the canary instead of referring to an S3 location. It can be up to 225KB. **Conflicts with `s3Bucket`, `s3Key`, and `s3Version`.**