Aws/synthetics
@swamp/aws/syntheticsv2026.07.25.1
01README
AWS SYNTHETICS infrastructure models
02Models
@swamp/aws/synthetics/canaryv2026.06.15.1canary.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| accessKeyId? | string | AWS access key ID; overrides AWS_ACCESS_KEY_ID environment variable. Wire with a vault.get(...) expression to source it from a vault. |
| secretAccessKey? | string | AWS secret access key; overrides AWS_SECRET_ACCESS_KEY environment variable. Wire with a vault.get(...) expression to source it from a vault. |
| sessionToken? | string | AWS session token for temporary credentials; overrides AWS_SESSION_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault. |
| region? | string | AWS region; overrides AWS_REGION / AWS_DEFAULT_REGION environment variables and ~/.aws/config profile region. Defaults to us-east-1. |
| Name | string | Name of the canary. |
| Code | object | Provide the canary script source |
| ArtifactS3Location | string | Provide the s3 bucket output location for test results |
| ArtifactConfig? | object | Provide artifact configuration |
| Schedule | object | Frequency to run your canaries |
| ExecutionRoleArn | string | Lambda Execution role used to run your canaries |
| RuntimeVersion | string | Runtime version of Synthetics Library |
| SuccessRetentionPeriod? | number | Retention period of successful canary runs represented in number of days |
| FailureRetentionPeriod? | number | Retention period of failed canary runs represented in number of days |
| Tags? | array | |
| VPCConfig? | object | Provide VPC Configuration if enabled. |
| RunConfig? | object | Provide canary run configuration |
| StartCanaryAfterCreation? | boolean | Runs canary if set to True. Default is False |
| VisualReference? | object | Visual reference configuration for visual testing |
| DeleteLambdaResourcesOnCanaryDeletion? | boolean | Deletes associated lambda resources created by Synthetics if set to True. Default is False |
| ResourcesToReplicateTags? | array | List of resources which canary tags should be replicated to. |
| ProvisionedResourceCleanup? | enum | Setting to control if provisioned resources created by Synthetics are deleted alongside the canary. Default is AUTOMATIC. |
| DryRunAndUpdate? | boolean | Setting to control if UpdateCanary will perform a DryRun and validate it is PASSING before performing the Update. Default is FALSE. |
| BrowserConfigs? | array | List of browser configurations for the canary |
| VisualReferences? | array | List of visual references for the canary |
fn create()
Create a Synthetics Canary
fn get(identifier: string)
Get a Synthetics Canary
| Argument | Type | Description |
|---|---|---|
| identifier | string | The primary identifier of the Synthetics Canary |
fn update()
Update a Synthetics Canary
fn delete(identifier: string)
Delete a Synthetics Canary
| Argument | Type | Description |
|---|---|---|
| identifier | string | The primary identifier of the Synthetics Canary |
fn sync()
Sync Synthetics Canary state from AWS
Resources
state(infinite)— Synthetics Canary resource state
@swamp/aws/synthetics/groupv2026.06.15.1group.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| accessKeyId? | string | AWS access key ID; overrides AWS_ACCESS_KEY_ID environment variable. Wire with a vault.get(...) expression to source it from a vault. |
| secretAccessKey? | string | AWS secret access key; overrides AWS_SECRET_ACCESS_KEY environment variable. Wire with a vault.get(...) expression to source it from a vault. |
| sessionToken? | string | AWS session token for temporary credentials; overrides AWS_SESSION_TOKEN environment variable. Wire with a vault.get(...) expression to source it from a vault. |
| region? | string | AWS region; overrides AWS_REGION / AWS_DEFAULT_REGION environment variables and ~/.aws/config profile region. Defaults to us-east-1. |
| Name | string | Name of the group. |
| Tags? | array | |
| ResourceArns? | array |
fn create()
Create a Synthetics Group
fn get(identifier: string)
Get a Synthetics Group
| Argument | Type | Description |
|---|---|---|
| identifier | string | The primary identifier of the Synthetics Group |
fn update()
Update a Synthetics Group
fn delete(identifier: string)
Delete a Synthetics Group
| Argument | Type | Description |
|---|---|---|
| identifier | string | The primary identifier of the Synthetics Group |
fn sync()
Sync Synthetics Group state from AWS
Resources
state(infinite)— Synthetics Group resource state
03Previous Versions
2026.07.24.1
2026.07.20.1
2026.07.18.3
2026.07.18.2
2026.06.15.1
- Updated: canary, group
2026.06.08.2
- Updated: canary, group
2026.06.06.1
- Updated: canary, group
2026.04.23.3
2026.04.23.2
- Updated: canary, group
2026.04.03.2
- Updated: canary, group
2026.03.19.1
- Updated: canary, group
2026.03.16.1
- Updated: canary, group
2026.03.10.5
04Stats
A
100 / 100
Downloads
0
Archive size
462.4 KB
Verified by Swamp
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
05Platforms
06Labels