Skip to main content

canaries_list_only

Lists canaries in a region or regions, for all properties use canaries

Overview

Namecanaries_list_only
TypeResource
DescriptionResource Type definition for AWS::Synthetics::Canary
Idaws.synthetics.canaries_list_only

Fields

NameDatatypeDescription
namestringName of the canary.
idstringId of the canary
statestringState of the canary
codeobjectProvide the canary script source
artifact_s3_locationstringProvide the s3 bucket output location for test results
artifact_configobjectProvide artifact configuration
scheduleobjectFrequency to run your canaries
execution_role_arnstringLambda Execution role used to run your canaries
runtime_versionstringRuntime version of Synthetics Library
success_retention_periodintegerRetention period of successful canary runs represented in number of days
failure_retention_periodintegerRetention period of failed canary runs represented in number of days
tagsarray
vpc_configobjectProvide VPC Configuration if enabled.
run_configobjectProvide canary run configuration
start_canary_after_creationbooleanRuns canary if set to True. Default is False
visual_referenceobjectVisual reference configuration for visual testing
delete_lambda_resources_on_canary_deletionbooleanDeletes associated lambda resources created by Synthetics if set to True. Default is False
regionstringAWS region.

Methods

NameAccessible byRequired Params
list_resourcesSELECTregion

SELECT examples

Lists all canaries in a region.

SELECT
region,
name
FROM aws.synthetics.canaries_list_only
WHERE region = 'us-east-1';

Permissions

For permissions required to operate on the canaries_list_only resource, see canaries