synthetics:GetCanaryRuns

Read

synthetics:GetCanaryRuns is a Read access-level action in the synthetics service. Grants permission to list information about all the test runs associated with a canary

Resource types

ARNs that synthetics:GetCanaryRuns can be scoped to in an IAM policy.

arn:${Partition}:synthetics:${Region}:${Account}:canary:${CanaryName}
canary

Condition keys

Keys you can use in the Condition block of a policy that grants synthetics:GetCanaryRuns.

aws:ResourceTag/${TagKey} String

Filters access based on the tags associated with the resource

Example IAM policy

A minimal policy that allows synthetics:GetCanaryRuns. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowSyntheticsGetCanaryRuns",
      "Effect": "Allow",
      "Action": "synthetics:GetCanaryRuns",
      "Resource": "*"
    }
  ]
}

Related actions in synthetics

View all synthetics actions →