ReplicationConfigSpec

ReplicationConfigSpec
ReplicationConfigSpec

The ReplicationConfigSpec object type encapsulates the replication configuration parameters for a virtual machine.

It consists of two parts: 1) a set of virtual machine-wide replication properties; 2) a set of properties per replicated virtual disk. ReplicationSetting is passed as an argument for initial replication configuration (@see vim.HbrManager#enableReplication) as well as for re-configuration of a replicated VM's properties (@see vim.HbrManager#reconfigureReplication).

AllOf
This class requires all of the following:
JSON Example
{
    "_typeName": "string",
    "generation": 0,
    "vmReplicationId": "string",
    "destination": "string",
    "port": 0,
    "rpo": 0,
    "quiesceGuestEnabled": false,
    "paused": false,
    "oppUpdatesEnabled": false,
    "netCompressionEnabled": false,
    "netEncryptionEnabled": false,
    "encryptionDestination": "string",
    "encryptionPort": 0,
    "remoteCertificateThumbprint": "string",
    "dataSetsReplicationEnabled": false,
    "disk": [
        {
            "_typeName": "string",
            "key": 0,
            "diskReplicationId": "string"
        }
    ]
}
integer As int64 As int64
generation
Required

A generation number (>=0) that reflects the "freshness" of the ReplicationConfigSpec on which a re-configuration is based.

The generation number is used to detect and disallow concurrent updates to a VM's replication settings. For initial replication enablement, generation = 0. The replication settings of every replication re-configuration operation must reflect the latest generation number known to the caller. It takes an explicit call to get the latest replication settings to find out what the latest generation number is. The update algorithm of the generation number is opaque to the caller; e.g., the caller cannot assume that the generation numbers are incremented by one every time replication is (re)configured, not even that they are changing monotonically.

string
vmReplicationId
Required

An opaque identifier that uniquely identifies a replicated VM between primary and secondary sites.

string
destination
Required

The IP address of the HBR Server in the secondary site where this VM is replicated to.

Note: If net encryption is enabled, this is the address of the encryption tunnelling agent.

integer As int32 As int32
port
Required

The port on the HBR Server in the secondary site where this VM is replicated to.

Note: If net encryption is enabled, this is the port of the encryption tunneling agent.

integer As int64 As int64
rpo
Required

The Recovery Point Objective specified for this VM, in minutes.

Currently, valid values are in the range of 1 minute to 1440 minutes (24 hours).

boolean
quiesceGuestEnabled
Required

Flag that indicates whether or not to quiesce the file system or applications in the guest OS before a consistent replica is created.

boolean
paused
Required

Flag that indicates whether or not the vm or group has been paused for replication.

boolean
oppUpdatesEnabled
Required

Flag that indicates whether or not to perform opportunistic updates in-between consistent replicas.

boolean
netCompressionEnabled
Optional

Flag that indicates whether or not compression should be used when sending traffic over the network.

The primary will negotiate the best compression with the server on the secondary if this is enabled.

boolean
netEncryptionEnabled
Optional

Flag that indicates whether or not encription should be used when sending traffic over the network.

The primary will use the remoteCertificateThumbprint to verify the identity of the remote server.

string
encryptionDestination
Optional

The IP address of the remote HBR server, target for encrypted LWD.

This field is required when net encryption is enabled, ignored otherwise.

integer As int32 As int32
encryptionPort
Optional

The port on the remote HBR server, target for encrypted LWD.

This field is only relevant when net encryption is enabled.

string
remoteCertificateThumbprint
Optional

The SHA256 thumbprint of the remote server certificate.

This field is only relevant when net encription is enabled.

boolean
dataSetsReplicationEnabled
Optional

Flag that indicates whether DataSets files are replicated or not.

Since: vSphere API Release 8.0.0.0

disk
Optional

The set of the disks of this VM that are configured for replication.