Skip to content
AWS for Query.Farm

aws.synthetics.describe_canaries_last_run

Example SQL Queries

SELECT * FROM
aws.synthetics.describe_canaries_last_run;

Description

Use this operation to see information from the most recent run of each canary that you have created.

This operation supports resource-level authorization using an IAM policy and the Names parameter. If you specify the Names parameter, the operation is successful only if you have authorization to view all the canaries that you specify in your request. If you do not have permission to view any of the canaries, the request fails with a 403 response.

You are required to use the Names parameter if you are logged on to a user or role that has an IAM policy that restricts which canaries that you are allowed to view. For more information, see Limiting a user to viewing specific canaries.

Table Definition

Column NameColumn Data Type
max_results Input Column

Specify this parameter to limit how many runs are returned each time you use the DescribeLastRun operation. If you omit this parameter, the default of 100 is used.

BIGINT
names Input Column

Use this parameter to return only canaries that match the names that you specify here. You can specify as many as five canary names.

If you specify this parameter, the operation is successful only if you have authorization to view all the canaries that you specify in your request. If you do not have permission to view any of the canaries, the request fails with a 403 response.

You are required to use the Names parameter if you are logged on to a user or role that has an IAM policy that restricts which canaries that you are allowed to view. For more information, see Limiting a user to viewing specific canaries.

VARCHAR[]
Show child fields
names[]
next_token Input Column

A token that indicates that there is more data available. You can use this token in a subsequent DescribeCanariesLastRun operation to retrieve the next set of results.

VARCHAR
_aws_profile Input Column

The AWS profile defines the AWS identity used. It can be defined via credentials or by assuming a IAM role.

STRUCT(
    "type" VARCHAR,
    "name" VARCHAR,
    "account_id" VARCHAR,
    "via_profile_name" VARCHAR,
    "assumed_role_arn" VARCHAR,
    "organization" STRUCT(
        "account_name" VARCHAR,
        "id" VARCHAR,
        "tags" STRUCT(
            "key" VARCHAR,
            "value" VARCHAR
        )[],
        "master_account" STRUCT(
            "id" VARCHAR,
            "email" VARCHAR
        ),
        "parents" STRUCT(
            "type" VARCHAR,
            "id" VARCHAR,
            "name" VARCHAR,
            "tags" STRUCT(
                "key" VARCHAR,
                "value" VARCHAR
            )[]
        )[]
    )
)
Show child fields
_aws_profile.account_id

The AWS account id

_aws_profile.assumed_role_arn

The ARN of the assumed role

_aws_profile.name

The unique name of the profile.

_aws_profile.organization

Information about this profile's membership in the AWS organization.

Show child fields
_aws_profile.organization.account_name

The name of account speciifed by the organization

_aws_profile.organization.id

The organization id

_aws_profile.organization.master_account
Show child fields
_aws_profile.organization.master_account.email

The organization master account email address

_aws_profile.organization.master_account.id

The organization master account id

_aws_profile.organization.parents[]
Show child fields
_aws_profile.organization.parents[].id

The id of the parent

_aws_profile.organization.parents[].name

The name of the parent

_aws_profile.organization.parents[].tags[]
Show child fields
_aws_profile.organization.parents[].tags[].key
_aws_profile.organization.parents[].tags[].value
_aws_profile.organization.parents[].type

The type of parent can be an organization unit or a root

_aws_profile.organization.tags[]
Show child fields
_aws_profile.organization.tags[].key
_aws_profile.organization.tags[].value
_aws_profile.type

The type of profile, either 'credentials' or 'assumed_role'

_aws_profile.via_profile_name

This IAM role for this profile is assumed by first utilizing another profile with this name to obtain credentials.

_aws_region Input Column

The AWS region to use.

VARCHAR
canaries_last_run

An array that contains the information from the most recent run of each canary.

STRUCT(
    "canary_name" VARCHAR,
    "last_run" STRUCT(
        "id" VARCHAR,
        "name" VARCHAR,
        "status" STRUCT(
            "state" VARCHAR,
            "state_reason" VARCHAR,
            "state_reason_code" VARCHAR
        ),
        "timeline" STRUCT(
            "started" TIMESTAMP_S,
            "completed" TIMESTAMP_S
        ),
        "artifact_s3_location" VARCHAR
    )
)[]
Show child fields
canaries_last_run[]
Show child fields
canaries_last_run[].canary_name

The name of the canary.

canaries_last_run[].last_run

The results from this canary's most recent run.

Show child fields
canaries_last_run[].last_run.artifact_s3_location

The location where the canary stored artifacts from the run. Artifacts include the log file, screenshots, and HAR files.

canaries_last_run[].last_run.id

A unique ID that identifies this canary run.

canaries_last_run[].last_run.name

The name of the canary.

canaries_last_run[].last_run.status

The status of this run.

Show child fields
canaries_last_run[].last_run.status.state

The current state of the run.

canaries_last_run[].last_run.status.state_reason

If run of the canary failed, this field contains the reason for the error.

canaries_last_run[].last_run.status.state_reason_code

If this value is CANARY_FAILURE, an exception occurred in the canary code. If this value is EXECUTION_FAILURE, an exception occurred in CloudWatch Synthetics.

canaries_last_run[].last_run.timeline

A structure that contains the start and end times of this run.

Show child fields
canaries_last_run[].last_run.timeline.completed

The end time of the run.

canaries_last_run[].last_run.timeline.started

The start time of the run.