amazonka-synthetics-2.0: Amazon Synthetics SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.Synthetics.Types.CanaryCodeInput

Description

 
Synopsis

Documentation

data CanaryCodeInput Source #

Use this structure to input your script code for the canary. This structure contains the Lambda handler with the location where the canary should start running the script. If the script is stored in an S3 bucket, the bucket name, key, and version are also included. If the script was passed into the canary directly, the script code is contained in the value of Zipfile.

See: newCanaryCodeInput smart constructor.

Constructors

CanaryCodeInput' 

Fields

  • s3Bucket :: Maybe Text

    If your canary script is located in S3, specify the bucket name here. Do not include s3:// as the start of the bucket name.

  • s3Key :: Maybe Text

    The S3 key of your script. For more information, see Working with Amazon S3 Objects.

  • s3Version :: Maybe Text

    The S3 version ID of your script.

  • zipFile :: Maybe Base64

    If you input your canary script directly into the canary instead of referring to an S3 location, the value of this parameter is the base64-encoded contents of the .zip file that contains the script. It must be smaller than 225 Kb.

    For large canary scripts, we recommend that you use an S3 location instead of inputting it directly with this parameter.

  • handler :: Text

    The entry point to use for the source code when running the canary. For canaries that use the syn-python-selenium-1.0 runtime or a syn-nodejs.puppeteer runtime earlier than syn-nodejs.puppeteer-3.4, the handler must be specified as fileName.handler. For syn-python-selenium-1.1, syn-nodejs.puppeteer-3.4, and later runtimes, the handler can be specified as fileName.functionName , or you can specify a folder where canary scripts reside as folder/fileName.functionName .

Instances

Instances details
ToJSON CanaryCodeInput Source # 
Instance details

Defined in Amazonka.Synthetics.Types.CanaryCodeInput

Generic CanaryCodeInput Source # 
Instance details

Defined in Amazonka.Synthetics.Types.CanaryCodeInput

Associated Types

type Rep CanaryCodeInput :: Type -> Type #

Read CanaryCodeInput Source # 
Instance details

Defined in Amazonka.Synthetics.Types.CanaryCodeInput

Show CanaryCodeInput Source # 
Instance details

Defined in Amazonka.Synthetics.Types.CanaryCodeInput

NFData CanaryCodeInput Source # 
Instance details

Defined in Amazonka.Synthetics.Types.CanaryCodeInput

Methods

rnf :: CanaryCodeInput -> () #

Eq CanaryCodeInput Source # 
Instance details

Defined in Amazonka.Synthetics.Types.CanaryCodeInput

Hashable CanaryCodeInput Source # 
Instance details

Defined in Amazonka.Synthetics.Types.CanaryCodeInput

type Rep CanaryCodeInput Source # 
Instance details

Defined in Amazonka.Synthetics.Types.CanaryCodeInput

type Rep CanaryCodeInput = D1 ('MetaData "CanaryCodeInput" "Amazonka.Synthetics.Types.CanaryCodeInput" "amazonka-synthetics-2.0-3I8gICXDswl2F1HDbijRHZ" 'False) (C1 ('MetaCons "CanaryCodeInput'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "s3Bucket") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "s3Key") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "s3Version") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "zipFile") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Base64)) :*: S1 ('MetaSel ('Just "handler") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))

newCanaryCodeInput Source #

Create a value of CanaryCodeInput with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:s3Bucket:CanaryCodeInput', canaryCodeInput_s3Bucket - If your canary script is located in S3, specify the bucket name here. Do not include s3:// as the start of the bucket name.

$sel:s3Key:CanaryCodeInput', canaryCodeInput_s3Key - The S3 key of your script. For more information, see Working with Amazon S3 Objects.

$sel:s3Version:CanaryCodeInput', canaryCodeInput_s3Version - The S3 version ID of your script.

$sel:zipFile:CanaryCodeInput', canaryCodeInput_zipFile - If you input your canary script directly into the canary instead of referring to an S3 location, the value of this parameter is the base64-encoded contents of the .zip file that contains the script. It must be smaller than 225 Kb.

For large canary scripts, we recommend that you use an S3 location instead of inputting it directly with this parameter.-- -- Note: This Lens automatically encodes and decodes Base64 data. -- The underlying isomorphism will encode to Base64 representation during -- serialisation, and decode from Base64 representation during deserialisation. -- This Lens accepts and returns only raw unencoded data.

$sel:handler:CanaryCodeInput', canaryCodeInput_handler - The entry point to use for the source code when running the canary. For canaries that use the syn-python-selenium-1.0 runtime or a syn-nodejs.puppeteer runtime earlier than syn-nodejs.puppeteer-3.4, the handler must be specified as fileName.handler. For syn-python-selenium-1.1, syn-nodejs.puppeteer-3.4, and later runtimes, the handler can be specified as fileName.functionName , or you can specify a folder where canary scripts reside as folder/fileName.functionName .

canaryCodeInput_s3Bucket :: Lens' CanaryCodeInput (Maybe Text) Source #

If your canary script is located in S3, specify the bucket name here. Do not include s3:// as the start of the bucket name.

canaryCodeInput_s3Key :: Lens' CanaryCodeInput (Maybe Text) Source #

The S3 key of your script. For more information, see Working with Amazon S3 Objects.

canaryCodeInput_s3Version :: Lens' CanaryCodeInput (Maybe Text) Source #

The S3 version ID of your script.

canaryCodeInput_zipFile :: Lens' CanaryCodeInput (Maybe ByteString) Source #

If you input your canary script directly into the canary instead of referring to an S3 location, the value of this parameter is the base64-encoded contents of the .zip file that contains the script. It must be smaller than 225 Kb.

For large canary scripts, we recommend that you use an S3 location instead of inputting it directly with this parameter.-- -- Note: This Lens automatically encodes and decodes Base64 data. -- The underlying isomorphism will encode to Base64 representation during -- serialisation, and decode from Base64 representation during deserialisation. -- This Lens accepts and returns only raw unencoded data.

canaryCodeInput_handler :: Lens' CanaryCodeInput Text Source #

The entry point to use for the source code when running the canary. For canaries that use the syn-python-selenium-1.0 runtime or a syn-nodejs.puppeteer runtime earlier than syn-nodejs.puppeteer-3.4, the handler must be specified as fileName.handler. For syn-python-selenium-1.1, syn-nodejs.puppeteer-3.4, and later runtimes, the handler can be specified as fileName.functionName , or you can specify a folder where canary scripts reside as folder/fileName.functionName .