---
title: "POST /v1/{+parent}/replications"
method: POST
path: "/v1/{+parent}/replications"
tags: ["projects"]
---

# POST /v1/{+parent}/replications

`POST /v1/{+parent}/replications`

Create a new replication for a volume.

## Path parameters

- `parent` string, required

## Query parameters

- `replicationId` string

## Request body

- Replication — Replication is a nested resource under Volume, that describes a cross-region replication relationship between 2 volumes in different regions.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'READY' | 'UPDATING' | 'DELETING' | 'ERROR' | 'PENDING_CLUSTER_PEERING' | 'PENDING_SVM_PEERING' | 'PENDING_REMOTE_RESYNC' | 'EXTERNALLY_MANAGED_REPLICATION' — Output only. State of the replication.
  - `destinationVolume` string — Output only. Full name of destination volume resource. Example : "projects/{project}/locations/{location}/volumes/{volume_id}"
  - `clusterLocation` string — Optional. Location of the user cluster.
  - `replicationSchedule` 'REPLICATION_SCHEDULE_UNSPECIFIED' | 'EVERY_10_MINUTES' | 'HOURLY' | 'DAILY' — Required. Indicates the schedule for replication.
  - `createTime` string, google-datetime — Output only. Replication create time.
  - `sourceVolume` string — Output only. Full name of source volume resource. Example : "projects/{project}/locations/{location}/volumes/{volume_id}"
  - `stateDetails` string — Output only. State details of the replication.
  - `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.
  - `hybridReplicationType` 'HYBRID_REPLICATION_TYPE_UNSPECIFIED' | 'MIGRATION' | 'CONTINUOUS_REPLICATION' | 'ONPREM_REPLICATION' | 'REVERSE_ONPREM_REPLICATION' — Output only. Type of the hybrid replication.
  - `transferStats` TransferStats — TransferStats reports all statistics related to replication transfer.
    - `transferBytes` string, int64 — Cumulative bytes transferred so far for the replication relationship.
    - `lastTransferError` string — A message describing the cause of the last transfer failure.
    - `lastTransferDuration` string, google-duration — Time taken during last transfer.
    - `totalTransferDuration` string, google-duration — Cumulative time taken across all transfers for the replication relationship.
    - `lastTransferBytes` string, int64 — Last transfer size in bytes.
    - `updateTime` string, google-datetime — Time when progress was updated last.
    - `lagDuration` string, google-duration — Lag duration indicates the duration by which Destination region volume content lags behind the primary region volume content.
    - `lastTransferEndTime` string, google-datetime — Time when last transfer completed.
  - `description` string — A description about this replication relationship.
  - `name` string — Identifier. The resource name of the Replication. Format: `projects/{project_id}/locations/{location}/volumes/{volume_id}/replications/{replication_id}`.
  - `role` 'REPLICATION_ROLE_UNSPECIFIED' | 'SOURCE' | 'DESTINATION' — Output only. Indicates whether this points to source or destination.
  - `hybridReplicationUserCommands` UserCommands — UserCommands contains the commands to be executed by the customer.
    - `commands` string[] — Output only. List of commands to be executed by the customer.
  - `mirrorState` 'MIRROR_STATE_UNSPECIFIED' | 'PREPARING' | 'MIRRORED' | 'STOPPED' | 'TRANSFERRING' | 'BASELINE_TRANSFERRING' | 'ABORTED' | 'EXTERNALLY_MANAGED' | 'PENDING_PEERING' — Output only. Indicates the state of mirroring.
  - `hybridPeeringDetails` HybridPeeringDetails — HybridPeeringDetails contains details about the hybrid peering.
    - `peerClusterName` string — Output only. Name of the user's local source cluster to be peered with the destination cluster.
    - `peerVolumeName` string — Output only. Name of the user's local source volume to be peered with the destination volume.
    - `passphrase` string — Output only. Temporary passphrase generated to accept cluster peering command.
    - `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, google-datetime — Output only. Expiration time for the peering command to be executed on user's ONTAP.
    - `peerSvmName` string — Output only. Name of the user's local source vserver svm to be peered with the destination vserver svm.
  - `destinationVolumeParameters` DestinationVolumeParameters — DestinationVolumeParameters specify input parameters used for creating destination volume.
    - `tieringPolicy` TieringPolicy — Defines tiering policy for the volume.
      - `tierAction` 'TIER_ACTION_UNSPECIFIED' | 'ENABLED' | 'PAUSED' — Optional. Flag indicating if the volume has tiering policy enable/pause. Default is PAUSED.
      - `hotTierBypassModeEnabled` boolean — Optional. Flag indicating that the hot tier bypass mode is enabled. Default is false. This is only applicable to Flex service level.
      - `coolingThresholdDays` integer — Optional. Time in days to mark the volume's data block as cold and make it eligible for tiering, can be range from 2-183. Default is 31.
    - `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.
    - `storagePool` string — Required. Existing destination StoragePool name.
    - `description` string — Description for the destination volume.
  - `labels` object — Resource labels to represent user provided metadata.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/netapp.md) · [All operations](https://skmtc.net/google/apis/netapp/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/netapp/versions/fa9ebea9e9dc/schema)