REST Resource: projects.locations.volumes.replications

Resource: Replication

Replication is a nested resource under Volume, that describes a cross-region replication relationship between 2 volumes in different regions.

JSON representation 
{
  "name": string,
  "state": enum (State),
  "stateDetails": string,
  "role": enum (ReplicationRole),
  "replicationSchedule": enum (ReplicationSchedule),
  "mirrorState": enum (MirrorState),
  "createTime": string,
  "destinationVolume": string,
  "transferStats": {
    object (TransferStats)
  },
  "labels": {
    string: string,
    ...
  },
  "destinationVolumeParameters": {
    object (DestinationVolumeParameters)
  },
  "sourceVolume": string,
  "hybridPeeringDetails": {
    object (HybridPeeringDetails)
  },
  "clusterLocation": string,
  "hybridReplicationType": enum (HybridReplicationType),
  "hybridReplicationUserCommands": {
    object (UserCommands)
  },
  "healthy": boolean,
  "description": string
}
Fields
name

string

Identifier. The resource name of the Replication. Format: projects/{projectId}/locations/{location}/volumes/{volumeId}/replications/{replicationId}.
state

enum (State)

Output only. State of the replication.
stateDetails

string

Output only. State details of the replication.
role

enum (ReplicationRole)

Output only. Indicates whether this points to source or destination.
replicationSchedule

enum (ReplicationSchedule)

Required. Indicates the schedule for replication.
mirrorState

enum (MirrorState)

Output only. Indicates the state of mirroring.
createTime

string (Timestamp format)

Output only. Replication create time.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
destinationVolume

string

Output only. Full name of destination volume resource. Example : "projects/{project}/locations/{location}/volumes/{volumeId}"
transferStats

object (TransferStats)

Output only. Replication transfer statistics.
labels

map (key: string, value: string)

Resource labels to represent user provided metadata.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
destinationVolumeParameters

object (DestinationVolumeParameters)

Required. Input only. Destination volume parameters
sourceVolume

string

Output only. Full name of source volume resource. Example : "projects/{project}/locations/{location}/volumes/{volumeId}"
hybridPeeringDetails

object (HybridPeeringDetails)

Output only. Hybrid peering details.
clusterLocation

string

Optional. Location of the user cluster.
hybridReplicationType

enum (HybridReplicationType)

Output only. Type of the hybrid replication.
hybridReplicationUserCommands

object (UserCommands)

Output only. Copy pastable snapmirror commands to be executed on onprem cluster by the customer.
healthy

boolean

Output only. Condition of the relationship. Can be one of the following: - true: The replication relationship is healthy. It has not missed the most recent scheduled transfer. - false: The replication relationship is not healthy. It has missed the most recent scheduled transfer.
description

string

A description about this replication relationship.

State

The replication states New enum values may be added in future to indicate possible new states.

Enums
STATE_UNSPECIFIED Unspecified replication State
CREATING Replication is creating.
READY Replication is ready.
UPDATING Replication is updating.
DELETING Replication is deleting.
ERROR Replication is in error state.
PENDING_CLUSTER_PEERING Replication is waiting for cluster peering to be established.
PENDING_SVM_PEERING Replication is waiting for SVM peering to be established.
PENDING_REMOTE_RESYNC Replication is waiting for Commands to be executed on Onprem ONTAP.
EXTERNALLY_MANAGED_REPLICATION Onprem ONTAP is destination and Replication can only be managed from Onprem.

ReplicationRole

New enum values may be added in future to support different replication topology.

Enums
REPLICATION_ROLE_UNSPECIFIED Unspecified replication role
SOURCE Indicates Source volume.
DESTINATION Indicates Destination volume.

ReplicationSchedule

Schedule for Replication. New enum values may be added in future to support different frequency of replication.

Enums
REPLICATION_SCHEDULE_UNSPECIFIED Unspecified ReplicationSchedule
EVERY_10_MINUTES Replication happens once every 10 minutes.
HOURLY Replication happens once every hour.
DAILY Replication happens once every day.

MirrorState

Mirroring states. No new value is expected to be added in future.

Enums
MIRROR_STATE_UNSPECIFIED Unspecified MirrorState
PREPARING Destination volume is being prepared.
MIRRORED Destination volume has been initialized and is ready to receive replication transfers.
STOPPED Destination volume is not receiving replication transfers.
TRANSFERRING Incremental replication is in progress.
BASELINE_TRANSFERRING Baseline replication is in progress.
ABORTED Replication is aborted.
EXTERNALLY_MANAGED Replication is being managed from Onprem ONTAP.
PENDING_PEERING Peering is yet to be established.

TransferStats

TransferStats reports all statistics related to replication transfer.

JSON representation 
{
  "transferBytes": string,
  "totalTransferDuration": string,
  "lastTransferBytes": string,
  "lastTransferDuration": string,
  "lagDuration": string,
  "updateTime": string,
  "lastTransferEndTime": string,
  "lastTransferError": string
}
Fields
transferBytes

string (int64 format)

Cumulative bytes transferred so far for the replication relationship.
totalTransferDuration

string (Duration format)

Cumulative time taken across all transfers for the replication relationship.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".
lastTransferBytes

string (int64 format)

Last transfer size in bytes.
lastTransferDuration

string (Duration format)

Time taken during last transfer.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".
lagDuration

string (Duration format)

Lag duration indicates the duration by which Destination region volume content lags behind the primary region volume content.

A duration in seconds with up to nine fractional digits, ending with 's'. Example: "3.5s".
updateTime

string (Timestamp format)

Time when progress was updated last.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
lastTransferEndTime

string (Timestamp format)

Time when last transfer completed.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
lastTransferError

string

A message describing the cause of the last transfer failure.

DestinationVolumeParameters

DestinationVolumeParameters specify input parameters used for creating destination volume.

JSON representation 
{
  "storagePool": string,
  "volumeId": string,
  "shareName": string,
  "description": string,
  "tieringPolicy": {
    object (TieringPolicy)
  }
}
Fields
storagePool

string

Required. Existing destination StoragePool name.
volumeId

string

Desired destination volume resource id. If not specified, source volume's resource id will be used. This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
shareName

string

Destination volume's share name. If not specified, source volume's share name will be used.
description

string

Description for the destination volume.
tieringPolicy

object (TieringPolicy)

Optional. Tiering policy for the volume.

HybridPeeringDetails

HybridPeeringDetails contains details about the hybrid peering.

JSON representation 
{
  "subnetIp": string,
  "command": string,
  "commandExpiryTime": string,
  "passphrase": string,
  "peerVolumeName": string,
  "peerClusterName": string,
  "peerSvmName": string
}
Fields
subnetIp

string

Output only. IP address of the subnet.
command

string

Output only. Copy-paste-able commands to be used on user's ONTAP to accept peering requests.
commandExpiryTime

string (Timestamp format)

Output only. Expiration time for the peering command to be executed on user's ONTAP.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
passphrase

string

Output only. Temporary passphrase generated to accept cluster peering command.
peerVolumeName

string

Output only. Name of the user's local source volume to be peered with the destination volume.
peerClusterName

string

Output only. Name of the user's local source cluster to be peered with the destination cluster.
peerSvmName

string

Output only. Name of the user's local source vserver svm to be peered with the destination vserver svm.

HybridReplicationType

Hybrid replication type.

Enums
HYBRID_REPLICATION_TYPE_UNSPECIFIED Unspecified hybrid replication type.
MIGRATION Hybrid replication type for migration.
CONTINUOUS_REPLICATION Hybrid replication type for continuous replication.
ONPREM_REPLICATION New field for reversible OnPrem replication, to be used for data protection.
REVERSE_ONPREM_REPLICATION Hybrid replication type for incremental Transfer in the reverse direction (GCNV is source and Onprem is destination)

UserCommands

UserCommands contains the commands to be executed by the customer.

JSON representation 
{
  "commands": [
    string
  ]
}
Fields
commands[]

string

Output only. List of commands to be executed by the customer.

Methods

create

 Create a new replication for a volume.

delete

 Deletes a replication.

establishPeering

 Establish replication peering.

get

 Describe a replication for a volume.

list

 Returns descriptions of all replications for a volume.

patch

 Updates the settings of a specific replication.

resume

 Resume Cross Region Replication.

reverseDirection

 Reverses direction of replication.

stop

 Stop Cross Region Replication.

sync

 Syncs the replication.