Skip to content

/AWS1/CL_FSX=>COPYSNAPSHOTANDUPDATEVOLUME()

About CopySnapshotAndUpdateVolume

Updates an existing volume by using a snapshot from another Amazon FSx for OpenZFS file system. For more information, see on-demand data replication in the Amazon FSx for OpenZFS User Guide.

Method Signature

IMPORTING

Required arguments:

IV_VOLUMEID TYPE /AWS1/FSXVOLUMEID /AWS1/FSXVOLUMEID

Specifies the ID of the volume that you are copying the snapshot to.

IV_SOURCESNAPSHOTARN TYPE /AWS1/FSXRESOURCEARN /AWS1/FSXRESOURCEARN

SourceSnapshotARN

Optional arguments:

IV_CLIENTREQUESTTOKEN TYPE /AWS1/FSXCLIENTREQUESTTOKEN /AWS1/FSXCLIENTREQUESTTOKEN

ClientRequestToken

IV_COPYSTRATEGY TYPE /AWS1/FSXOPENZFSCOPYSTRATEGY /AWS1/FSXOPENZFSCOPYSTRATEGY

Specifies the strategy to use when copying data from a snapshot to the volume.

  • FULL_COPY - Copies all data from the snapshot to the volume.

  • INCREMENTAL_COPY - Copies only the snapshot data that's changed since the previous replication.

CLONE isn't a valid copy strategy option for the CopySnapshotAndUpdateVolume operation.

IT_OPTIONS TYPE /AWS1/CL_FSXUPOPENZFSVOLOPTS_W=>TT_UPDATEOPENZFSVOLUMEOPTIONS TT_UPDATEOPENZFSVOLUMEOPTIONS

Confirms that you want to delete data on the destination volume that wasn’t there during the previous snapshot replication.

Your replication will fail if you don’t include an option for a specific type of data and that data is on your destination. For example, if you don’t include DELETE_INTERMEDIATE_SNAPSHOTS and there are intermediate snapshots on the destination, you can’t copy the snapshot.

  • DELETE_INTERMEDIATE_SNAPSHOTS - Deletes snapshots on the destination volume that aren’t on the source volume.

  • DELETE_CLONED_VOLUMES - Deletes snapshot clones on the destination volume that aren't on the source volume.

  • DELETE_INTERMEDIATE_DATA - Overwrites snapshots on the destination volume that don’t match the source snapshot that you’re copying.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_FSXCPSNAPANDUPVOLRSP /AWS1/CL_FSXCPSNAPANDUPVOLRSP