Skip to content

CanaryCodeInput

Source code in docs_src/capo_synthetics/types/canary_code_input.py
class CanaryCodeInput(TypedDict, closed=True):
    s3_bucket: NotRequired["capo_synthetics.types.string.String"]
    """<p>If your canary script is located in Amazon S3, specify the bucket name here. Do not include <code>s3://</code> as the start of the bucket name.</p>"""
    s3_key: NotRequired["capo_synthetics.types.string.String"]
    """<p>The Amazon S3 key of your script. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingObjects.html">Working with Amazon S3 Objects</a>.</p>"""
    s3_version: NotRequired["capo_synthetics.types.string.String"]
    """<p>The Amazon S3 version ID of your script.</p>"""
    zip_file: NotRequired["capo_synthetics.types.blob.Blob"]
    """<p>If you input your canary script directly into the canary instead of referring to an Amazon 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.</p> <p>For large canary scripts, we recommend that you use an Amazon S3 location instead of inputting it directly with this parameter.</p>"""
    handler: "capo_synthetics.types.code_handler.CodeHandler"
    """<p>The entry point to use for the source code when running the canary. For canaries that use the <code>syn-python-selenium-1.0</code> runtime or a <code>syn-nodejs.puppeteer</code> runtime earlier than <code>syn-nodejs.puppeteer-3.4</code>, the handler must be specified as <code> <i>fileName</i>.handler</code>. For <code>syn-python-selenium-1.1</code>, <code>syn-nodejs.puppeteer-3.4</code>, and later runtimes, the handler can be specified as <code> <i>fileName</i>.<i>functionName</i> </code>, or you can specify a folder where canary scripts reside as <code> <i>folder</i>/<i>fileName</i>.<i>functionName</i> </code>.</p> <p>This field is required when you don't specify <code>BlueprintTypes</code> and is not allowed when you specify <code>BlueprintTypes</code>.</p>"""
    blueprint_types: NotRequired["capo_synthetics.types.blueprint_types.BlueprintTypes"]
    """<p> <code>BlueprintTypes</code> is a list of templates that enable simplified canary creation. You can create canaries for common monitoring scenarios by providing only a JSON configuration file instead of writing custom scripts. The only supported value is <code>multi-checks</code>.</p> <p>Multi-checks monitors HTTP/DNS/SSL/TCP endpoints with built-in authentication schemes (Basic, API Key, OAuth, SigV4) and assertion capabilities. When you specify <code>BlueprintTypes</code>, the <code>Handler</code> field cannot be specified since the blueprint provides a pre-defined entry point.</p> <p> <code>BlueprintTypes</code> is supported only on canaries for syn-nodejs-3.0 runtime or later.</p>"""
    dependencies: NotRequired["capo_synthetics.types.dependencies.Dependencies"]
    """<p>A list of dependencies that should be used for running this canary. Specify the dependencies as a key-value pair, where the key is the type of dependency and the value is the dependency reference.</p>"""

blueprint_types instance-attribute

blueprint_types: NotRequired[BlueprintTypes]

BlueprintTypes is a list of templates that enable simplified canary creation. You can create canaries for common monitoring scenarios by providing only a JSON configuration file instead of writing custom scripts. The only supported value is multi-checks.

Multi-checks monitors HTTP/DNS/SSL/TCP endpoints with built-in authentication schemes (Basic, API Key, OAuth, SigV4) and assertion capabilities. When you specify BlueprintTypes, the Handler field cannot be specified since the blueprint provides a pre-defined entry point.

BlueprintTypes is supported only on canaries for syn-nodejs-3.0 runtime or later.

dependencies instance-attribute

dependencies: NotRequired[Dependencies]

A list of dependencies that should be used for running this canary. Specify the dependencies as a key-value pair, where the key is the type of dependency and the value is the dependency reference.

handler instance-attribute

handler: CodeHandler

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 .

This field is required when you don't specify BlueprintTypes and is not allowed when you specify BlueprintTypes.

s3_bucket instance-attribute

s3_bucket: NotRequired[String]

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

s3_key instance-attribute

s3_key: NotRequired[String]

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

s3_version instance-attribute

s3_version: NotRequired[String]

The Amazon S3 version ID of your script.

zip_file instance-attribute

zip_file: NotRequired[Blob]

If you input your canary script directly into the canary instead of referring to an Amazon 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 Amazon S3 location instead of inputting it directly with this parameter.