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"
}