Data Types

AmazonCopyRdsSnapshotsParameters Object

Description

Parameters for the Amazon Copy RDS Snapshots action.

Properties

accountNumber

Account number of the AWS account containing the RDS snapshots. Must be a string of 12 numeric digits.

Type: string

Required: No

conflictResolutionMethod

Method used when an RDS already exists with the desired snapshot ID in the target region.

Type: string

Valid Values:

  • skip

  • delete-and-recopy

  • fail-and-stop

  • fail-and-continue

Default: skip

Required: No

credentialIds

Registered credentials to use with the action. One and only one credential must be specified.

Type: Array of string

Required: Yes

instanceIdComparison

Comparison to use when matching snapshots by their source instance ID. Required when snapshotIdentificationMethod is by-instance-id.

Type: RdsInstanceIdComparison object

Required: Conditional

isCopyTags

Indicates whether the snapshot tags will be copied from the source to the target snapshot.

Type: boolean

Default: false

Required: No

isIncludeClusterSnapshots

Indicates whether RDS cluster snapshots (ie. Aurora) should be included as well as db snapshots.

Type: boolean

Default: true

Required: No

newerThanDays

Age, in days, used to filter snapshots that are copied. Only snapshots newer than the specified value will be copied. Specify null to indicate no age limit.

Type: integer

Default: null

Required: No

newSnapshotId

ID of the new snapshots.

Type: string

Default: $(SNAPSHOTID)

Required: No

regionNames

Regions to use with the action. Omit (or specify null) to include "all regions".

Type: Array of string

Required: No

resourceTagComparison

Comparison to use when identifying snapshots by resource tag. Required when snapshotIdentificationMethod is by-resource-tag.

Type: ResourceTagComparison object.

Required: Conditional

snapshotIdComparison

Comparison to use when matching snapshots by their ID. Required when snapshotIdentificationMethod is by-snapshot-id.

Type: RdsSnapshotIdComparison object

Required: Conditional

snapshotIdentificationMethod

Method to use to identify snapshots to be deleted.

Type: string

Valid Values:

  • all-snapshots

  • by-snapshot-id

  • by-instance-id

  • by-resource-tag

Required: Yes

snapshotType

Type of snapshot to be copied.

Type: string

Valid Values:

  • all

  • automated

  • manual

Default: all

Required: No

tags

Resource tags to add to the new RDS snapshots.

Type: Array of Tag object.

Required: No

targetCredentialId

Credential ID of the AWS credentials to copy the the RDS snapshot. Eg. cred-12345678.

Type: string

Required: No

targetKmsKeyOverride

ID or alias of the KMS key used to encrypt the RDS snapshots when copied.

Type: string

Required: No

targetOptionGroupName

Name of the RDS option group to assign to the new RDS snapshots

Type: string

Required: No

targetRegionName

System name of the target region into which the snapshots will be copied. Eg. us-east-1

Type: string

Required: Yes

Sample JSON

{
"credentialIds": [
"cred-00000001"
],
"regionNames": [
"us-east-1"
],
"snapshotIdentificationMethod": "by-resource-tag",
"resourceTagComparison": {
"tagName": "skeddly:retention",
"compareType": "equals",
"tagValue": "7"
},
"snapshotType": "all",
"newerThanDays": 2,
"newSnapshotId": "$(SNAPSHOTID)",
"isCopyTags": true,
"tags": [
{
"key": "skeddly:copied",
"value": "$(DATE)"
}
],
"conflictResolutionMethod": "skip",
"targetRegionName": "us-west-2"
}