Zerto APIs : vSphere to vCD VPG Management APIs : vSphere to vCD - Edit Existing VPG Settings
  
vSphere to vCD - Edit Existing VPG Settings
The PUT method is used to update a existing VPG settings object.
 
Edit VPG settings object
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}
Edit basic settings object
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/basic
Edit journal settings object
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/journal
Edit network settings object
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/networks
Edit VM settings object
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}
Edit NIC settings object
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/nics/{nicIdentifier}
Edit volume settings object
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/volumes/{volumeId}
 
Where:
 
zvm_ip
The IP address of the Zerto Virtual Manager where the API is run.
port
The port to access the Zerto Virtual Manager. The default port is 9669.
vpgSettingsIdentifier
The identifier of the VPG settings object.
vmIdentifier
The identifier of the virtual machine. The identifier comprises the server identifier and the virtual machine moref, with the format, serverid.moref.
nicIdentifier
The identifier of a NIC that is to be updated.
volumeId
The identifier of the volume that is to be updated.
 
Request Body Using Json Format
The following is an example of a request body in Json format for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}.
 
[{
  "Basic": {
    "JournalHistoryInHours": 24,
    "Name": "String Content",
    "Priority": "String Content",
    "ProtectedSiteIdentifier": "String Content",
    "RecoverySiteIdentifier": "String Content",
    "RpoInSeconds": 300,
    "ServiceProfileIdentifier": "string content"
    "TestIntervalInMinutes": 262080,
    "UseWanCompression": Boolean,  },
  "Journal": {
    "Limitation": {
      "HardLimitInMB": 153600,
      "HardLimitInPercent": 0,
      "WarningThresholdInMB": 115200,
      "WarningThresholdInPercent": 0
    }
  },
  "Networks": {
    "Failover": {
      "VCD": {
       "IsEnableGuestCustomization": Boolean
       "DefaultRecoveryOrgVdcNetworkIdentifier": "string content"
      }
    }
    "FailoverTest": {
      "VCD": {
       "IsEnableGuestCustomization": Boolean
       "DefaultRecoveryOrgVdcNetworkIdentifier": "string content"
      }
    }
  },
  "Recovery": {
    "VCD": {
      "OrgVdcIdentifier": "String Content"
    }
  },
  "Vms":[
    {
    "Journal":{
      "Limitation":{
        "HardLimitInMB":153600,
        "HardLimitInPercent":0,
        "WarningThresholdInMB":115200,
        "WarningThresholdInPercent":0
      }
    },
    "Nics": [
     {
      "Failover":{
        "VCD": {
         "IpAddress": null,
         "IpMode": "String Content",
         "IsConnected": Boolean,
         "IsPrimary": Boolean
         "IsResetMacAddress": Boolean
         "RecoveryOrgVdcNetworkIdentifier":"String content",
        }
      },
      "FailoverTest":{
        "VCD": {
         "IpAddress": null,
         "IpMode": "String Content",
         "IsConnected": Boolean,
         "IsPrimary": Boolean
         "IsResetMacAddress": Boolean
         "RecoveryOrgVdcNetworkIdentifier":"String content",
        }
     },
      "NicIdentifier":"String content"
    }
 ],
    "Recovery":{
      "VCD": {
       "StoragePolicyIdentifier": "string content",
       }
    },
    "VmIdentifier": "string content",
    "Volumes":[{
      "IsSwap": Boolean,
      "VCD": {
         "IsThin": Boolean
       },
      "VolumeIdentifier":"String content"
    }]
  },
 ]
  "VpgIdentifier": "String Content",
  "VpgSettingsIdentifier": "String Content"
}
 
The following is an example of a request body in Json format for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/basic.
 
  "Basic": {
    "JournalHistoryInHours": 24,
    "Name": "String Content",
    "Priority": "String Content",
    "ProtectedSiteIdentifier": "String Content",
    "RecoverySiteIdentifier": "String Content",
    "RpoInSeconds": 300,
    "ServiceProfileIdentifier": "string content"
    "TestIntervalInMinutes": 262080,
    "UseWanCompression": Boolean,  },
  }
 
 
The following is an example of a request body in Json format for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/journal.
 
  "Journal": {
    "Limitation": {
      "HardLimitInMB": 153600,
      "HardLimitInPercent": 0,
      "WarningThresholdInMB": 115200,
      "WarningThresholdInPercent": 0
    }
  },
 
The following is an example of a request body in Json format for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/networks.
 
  "Networks": {
    "Failover": {
      "VCD": {
       "IsEnableGuestCustomization": Boolean
       "DefaultRecoveryOrgVdcNetworkIdentifier": "string content"
      }
    }
    "FailoverTest": {
      "VCD": {
       "IsEnableGuestCustomization": Boolean
       "DefaultRecoveryOrgVdcNetworkIdentifier": "string content"
      }
    }
  },
 
The following is an example of a request body in Json format for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms.
 
 "Vms": [
  "Journal":{
    "Limitation":{
      "HardLimitInMB":4294967295,
      "HardLimitInPercent":4294967295,
      "WarningThresholdInMB":4294967295,
      "WarningThresholdInPercent":4294967295
    }
  },
    "Nics": [
     {
      "Failover":{
        "VCD": {
         "IpAddress": null
         "IpMode": "String Content",
         "IsConnected": Boolean,
         "IsPrimary": Boolean
         "IsResetMacAddress": Boolean
         "RecoveryOrgVdcNetworkIdentifier":"String content",
        }
      },
      "FailoverTest":{
        "VCD": {
         "IpAddress": null,
         "IpMode": "String Content",
         "IsConnected": Boolean,
         "IsPrimary": Boolean
         "IsResetMacAddress": Boolean
         "RecoveryOrgVdcNetworkIdentifier":"String content",
        }
     },
      "NicIdentifier":"String content"
    }
 ],
    "Recovery":{
      "VCD": {
       "StoragePolicyIdentifier": "string content",
       }
    },
    "VmIdentifier": "string content",
    "Volumes":[{
      "IsSwap": Boolean,
      "VCD": {
         "IsThin": Boolean
       },
      "VolumeIdentifier":"String content"
    }]
  },
 ]
 
The following is an example of a request body in Json format for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/nics/{nicIdentifier}.
 
{
    "Nics": [
     {
      "Failover":{
        "VCD": {
         "IpAddress": null,
         "IpMode": "String Content",
         "IsConnected": Boolean,
         "IsPrimary": Boolean
         "IsResetMacAddress": Boolean
         "RecoveryOrgVdcNetworkIdentifier":"String content",
        }
      },
      "FailoverTest":{
        "VCD": {
         "IpAddress": null,
         "IpMode": "String Content",
         "IsConnected": Boolean,
         "IsPrimary": Boolean
         "IsResetMacAddress": Boolean
         "RecoveryOrgVdcNetworkIdentifier":"String content",
        }
     },
      "NicIdentifier":"String content"
    }
 ],
 
 
The following is an example of a request body in Json format for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/volumes/{volumeId}.
 
    "Volumes":[{
      "IsSwap": Boolean,
      "VCD": {
         "IsThin": Boolean
       },
      "VolumeIdentifier":"String content"
    }]
  },
 ]
 
 
Request Values
Update a VPG settings object
Request values for https://zvm_ip:port/v1/vpgSettings.
 
Parameter
Description
Basic
JournalHistoryInHours
The time that all write commands are saved in the journal. The value is between 1 and 336 (14 days).
Name
The name of the VPG.
Priority
The priority specified for the VPG. Possible values are:
■ Low: The VPG has a low priority for transferring data.
■ Medium: The VPG has a medium priority for transferring data.
■ High: The VPG has a high priority for transferring data.
ProtectedSiteIdentifier
The identifier of the site where the VPG virtual machines will be protected. This is the site where the API runs.
RecoverySiteIdentifier
The identifier of the site where the VPG virtual machines will be recovered.
RpoInSeconds
The maximum desired time between each automatic checkpoint being written to the journal before an alert is issued.
ServiceProfileIdentifier
The identifier of the service profile to use for the VPG when a Zerto Cloud Manager is used.
TestIntervalInMinutes
The time, in minutes, recommended between testing the integrity of the VPG. A warning is issued if a test is not done within this time frame. Possible values are:
■ 0: No testing is expected.
■ 43200 or null: Testing is expected monthly.
■ 131040: Testing is expected every three months.
■ 262080: Testing is expected every six months.
■ 394560: Testing is expected every nine months.
■ 525600: Testing is expected every twelve months.
UseWanCompression
True: Data will be compressed before sending it to the recovery site.
False: Data will not be compressed before sending it to the recovery site.
Journal
Limitation
Information about the journal limitations.
HardLimitInMB
The maximum journal size in MBs. 0 means unlimited. Integer values.
HardLimitInPercent
The percentage of the virtual machine volume size the journal can grow to. 0 means unlimited. Integer values.
WarningThresholdInMB
The journal size, in MBs, that generates a warning that the journal is nearing its hard limit. 0 means unlimited. Integer values.
WarningThresholdInPercent
The percentage of the virtual machine volume size that generates a warning. 0 means unlimited. Integer values.
Networks
Failover
Information about the networks used for failover.
VCD
IsEnableGuestCustomization
■ True: The computer name and network settings configured for this virtual machine are applied to its Guest OS when the virtual machine is powered on. Use this option to enable re-IPing the recovered virtual machines.
■ False: The computer name and network settings configured for this virtual machine are not applied to its Guest OS when the virtual machine is powered on. Re-Iping is not available.
Note: The same value should be set for both failover and failover test.
DefaultRecoveryOrgVdcNetworkIdentifier
The identifier of the Org vDC network. This is the default recovery settings applied to every virtual machine in the VPG. When OrgVdcIdentifier is set, DefaultRecoveryOrgVdcNetworkIdentifier is set by default
FailoverTest
Information about the networks used for failover test.
VCD
IsEnableGuestCustomization
True: The computer name and network settings configured for this virtual
machine are applied to its Guest OS when the virtual machine is powered on. Use this option to enable re-IPing the recovered virtual machines.
False: The computer name and network settings configured for this virtual
machine are not applied to its Guest OS when the virtual machine is powered on. Re-Iping is not available.
Note: The same value should be set for both failover and failover test.
DefaultRecoveryOrgVdcNetworkIdentifier
The identifier of the Org vDC network. This is the default recovery settings applied to every virtual machine in the VPG. When OrgVdcIdentifier is set, DefaultRecoveryOrgVdcNetworkIdentifier is set by default.
Recovery
VCD
OrgVcdIdentifier
The identifier of an Org vDC.
Vms
Journal
Limitation
Information about the journal limitations.
HardLimitInMB
The maximum journal size in MBs. 0 means unlimited. Integer values.
HardLimitInPercent
The percentage of the virtual machine volume size the journal can grow to. 0 means unlimited. Integer values.
WarningThresholdInMB
The journal size, in MBs, that generates a warning that the journal is nearing its hard limit. 0 means unlimited. Integer values.
WarningThresholdInPercent
The percentage of the virtual machine volume size that generates a warning. 0 means unlimited. Integer values.
Nics
Failover
Information about the networks used for failover by this virtual machine.
VCD
IpMode
The IP mode. Possible values are:
■ Static IP Pool - pulls IP addresses from the network's IP pool.
■ Static Manual - allows you to specify an IP address.
■ DHCP - pulls IP addresses from a DHCP server.
IsConnected
True: Is NIC connected
False: Is NIC not connected.
IsPrimary
True: The DNS server that handles Internet protocol mapping is the primary.
False: The DNS server that handles Internet protocol mapping is not the primary.
IsResetMacAddress
True: The Media Access Control (MAC) address used on the protected site will be copied to the recovery site.
False: The Media Access Control (MAC) address used on the protected site will not be copied to the recovery site.
RecoveryOrgVdcNetworkIdentifier
The identifier of the Org vDC network. This is the recovery settings applied to the virtual machine When OrgVdcIdentifier is set, RecoveryOrgVdcNetworkIdentifier is set by default
FailoverTest
Information about the networks used for failover test by this virtual machine.
VCD
IpMode
The IP mode. Possible values are:
■ Static IP Pool - pulls IP addresses from the network's IP pool.
■ Static Manual - allows you to specify an IP address.
■ DHCP - pulls IP addresses from a DHCP server.
IsConnected
True: Is NIC connected
False: Is NIC not connected.
IsPrimary
True: The DNS server that handles Internet protocol mapping is the primary.
False: The DNS server that handles Internet protocol mapping is not the primary.
IsResetMacAddress
True: The Media Access Control (MAC) address used on the protected site will be copied to the recovery site.
False: The Media Access Control (MAC) address used on the protected site will not be copied to the recovery site.
RecoveryOrgVdcNetworkIdentifier
The identifier of the Org vDC network. This is the recovery settings applied to the virtual machine When OrgVdcIdentifier is set, RecoveryOrgVdcNetworkIdentifier is set by default
NicIdentifier
The identifier of the NIC for which settings are returned.
Recovery
VCD
StoragePolicyIdentifier
The identifier of the recovery storage policy. When the VmIdentifier is set, the StoragePolicyIdentifier is set by default.
VmIdentifier
The identifier of the virtual machine. The identifier comprises the server identifier and the virtual machine moref, with the format, serverid.more.
Volumes
Information about the volumes used by the virtual machine.
IsSwap
True: The recovery disk is marked as a temp data disk.
False: The recovery disk is not marked as a temp data disk.
VCD
IsThin
True: The recovery volumes are thin-provisioned.
False: The recovery volumes are not thin-provisioned.
VolumeIdentifier
The identifier of the volume.
VpgIdentifier
The VPG identifier will be specified if a VPG was already created in a previous session.
VpgSettingsIdentifier
The identifier received after running the following POST API: https://zvm_ip:port/v1/vpgSettings
 
Update the basic settings in a VPG settings object
Request values for https://zvm_ip:port/v1/vpgSettings/basic.
Parameter
Description
Basic
JournalHistoryInHours
The time that all write commands are saved in the journal. The value is between 1 and 336 (14 days).
Name
The name of the VPG.
Priority
The priority specified for the VPG. Possible values are:
■ Low: The VPG has a low priority for transferring data.
■ Medium: The VPG has a medium priority for transferring data.
■ High: The VPG has a high priority for transferring data.
ProtectedSiteIdentifier
The identifier of the site where the VPG virtual machines will be protected. This is the site where the API runs.
RecoverySiteIdentifier
The identifier of the site where the VPG virtual machines will be recovered.
RpoInSeconds
The maximum desired time between each automatic checkpoint being written to the journal before an alert is issued.
ServiceProfileIdentifier
The identifier of the service profile to use for the VPG when a Zerto Cloud Manager is used.
TestIntervalInMinutes
The time, in minutes, recommended between testing the integrity of the VPG. A warning is issued if a test is not done within this time frame. Possible values are:
■ 0: No testing is expected.
■ 43200 or null: Testing is expected monthly.
■ 131040: Testing is expected every three months.
■ 262080: Testing is expected every six months.
■ 394560: Testing is expected every nine months.
■ 525600: Testing is expected every twelve months.
UseWanCompression
True: Data will be compressed before sending it to the recovery site.
False: Data will not be compressed before sending it to the recovery site.
Update the journal settings in a VPG settings object
Request values for https://zvm_ip:port/v1/vpgSettings/journal.
Parameter
Description
Limitation
Information about the journal limitations.
HardLimitInMB
The maximum journal size in MBs. 0 means unlimited. Integer values.
HardLimitInPercent
The percentage of the virtual machine volume size the journal can grow to. 0 means unlimited. Integer values.
WarningThresholdInMB
The journal size, in MBs, that generates a warning that the journal is nearing its hard limit. 0 means unlimited. Integer values.
WarningThresholdInPercent
The percentage of the virtual machine volume size that generates a warning. 0 means unlimited. Integer values.
Update the network settings in a VPG settings object
Request values for https://zvm_ip:port/v1/vpgSettings/networks.
Parameter
Description
Networks
Failover
Information about the networks used for failover.
VCD
IsEnableGuestCustomization
True: The computer name and network settings configured for this virtual
machine are applied to its Guest OS when the virtual machine is powered on. Use this option to enable re-IPing the recovered virtual machines.
False: The computer name and network settings configured for this virtual
machine are not applied to its Guest OS when the virtual machine is powered on. Re-Iping is not available.
Note: The same value should be set for both failover and failover test.
DefaultRecoveryOrgVdcNetworkIdentifier
The identifier of the Org vDC network. This is the default recovery settings applied to every virtual machine in the VPG. When OrgVdcIdentifier is set, DefaultRecoveryOrgVdcNetworkIdentifier is set by default
FailoverTest
Information about the networks used for failover test.
VCD
IsEnableGuestCustomization
True: The computer name and network settings configured for this virtual
machine are applied to its Guest OS when the virtual machine is powered on. Use this option to enable re-IPing the recovered virtual machines.
False: The computer name and network settings configured for this virtual
machine are not applied to its Guest OS when the virtual machine is powered on. Re-Iping is not available.
Note: The same value should be set for both failover and failover test.
DefaultRecoveryOrgVdcNetworkIdentifier
The identifier of the Org vDC network. This is the default recovery settings applied to every virtual machine in the VPG. When OrgVdcIdentifier is set, DefaultRecoveryOrgVdcNetworkIdentifier is set by default.
Update the virtual machine settings in a VPG settings object
Request values for https://zvm_ip:port/v1/vpgSettings/vms/{vmIdentifier}/{vmIdentifier}.
Parameter
Description
Vms
Journal
Limitation
Information about the journal limitations.
HardLimitInMB
The maximum journal size in MBs. 0 means unlimited. Integer values.
HardLimitInPercent
The percentage of the virtual machine volume size the journal can grow to. 0 means unlimited. Integer values.
WarningThresholdInMB
The journal size, in MBs, that generates a warning that the journal is nearing its hard limit. 0 means unlimited. Integer values.
WarningThresholdInPercent
The percentage of the virtual machine volume size that generates a warning. 0 means unlimited. Integer values.
Nics
Failover
Information about the networks used for failover by this virtual machine.
VCD
IpMode
The IP mode. Possible values are:
■ Static IP Pool - pulls IP addresses from the network's IP pool.
■ Static Manual - allows you to specify an IP address.
■ DHCP - pulls IP addresses from a DHCP server.
IsConnected
True: Is NIC connected
False: Is NIC not connected.
IsPrimary
True: The DNS server that handles Internet protocol mapping is the primary.
False: The DNS server that handles Internet protocol mapping is not the primary.
IsResetMacAddress
True: The Media Access Control (MAC) address used on the protected site will be copied to the recovery site.
False: The Media Access Control (MAC) address used on the protected site will not be copied to the recovery site.
RecoveryOrgVdcNetworkIdentifier
The identifier of the Org vDC network. This is the recovery settings applied to the virtual machine When OrgVdcIdentifier is set, RecoveryOrgVdcNetworkIdentifier is set by default
FailoverTest
Information about the networks used for failover test by this virtual machine.
VCD
IpMode
The IP mode. Possible values are:
■ Static IP Pool - pulls IP addresses from the network's IP pool.
■ Static Manual - allows you to specify an IP address.
■ DHCP - pulls IP addresses from a DHCP server.
IsConnected
True: Is NIC connected
False: Is NIC not connected.
IsPrimary
True: The DNS server that handles Internet protocol mapping is the primary.
False: The DNS server that handles Internet protocol mapping is not the primary.
IsResetMacAddress
True: The Media Access Control (MAC) address used on the protected site will be copied to the recovery site.
False: The Media Access Control (MAC) address used on the protected site will not be copied to the recovery site.
RecoveryOrgVdcNetworkIdentifier
The identifier of the Org vDC network. This is the recovery settings applied to the virtual machine When OrgVdcIdentifier is set, RecoveryOrgVdcNetworkIdentifier is set by default
NicIdentifier
The identifier of the NIC for which settings are returned.
Recovery
VCD
StoragePolicyIdentifier
The identifier of the recovery storage policy. When the VmIdentifier is set, the StoragePolicyIdentifier is set by default.
VmIdentifier
The identifier of the virtual machine. The identifier comprises the server identifier and the virtual machine moref, with the format, serverid.more.
Volumes
Information about the volumes used by the virtual machine.
IsSwap
True: The recovery disk is marked as a temp data disk.
False: The recovery disk is not marked as a temp data disk.
VCD
IsThin
True: The recovery volumes are thin-provisioned.
False: The recovery volumes are not thin-provisioned.
VolumeIdentifier
The identifier of the volume.
Update the virtual machine settings in a VPG settings object
Request values for https://zvm_ip:port/v1/vpgSettings/vms/{vmIdentifier}/{vmIdentifier}/nics/{nicIdentifier}.
Parameter
Description
Nics
Failover
Information about the networks used for failover by this virtual machine.
VCD
IpMode
The IP mode. Possible values are:
■ Static IP Pool - pulls IP addresses from the network's IP pool.
■ Static Manual - allows you to specify an IP address.
■ DHCP - pulls IP addresses from a DHCP server.
IsConnected
True: Is NIC connected
False: Is NIC not connected.
IsPrimary
True: The DNS server that handles Internet protocol mapping is the primary.
False: The DNS server that handles Internet protocol mapping is not the primary.
IsResetMacAddress
True: The Media Access Control (MAC) address used on the protected site will be copied to the recovery site.
False: The Media Access Control (MAC) address used on the protected site will not be copied to the recovery site.
RecoveryOrgVdcNetworkIdentifier
The identifier of the Org vDC network. This is therecovery settings applied to the virtual machine When OrgVdcIdentifier is set, RecoveryOrgVdcNetworkIdentifier is set by default
FailoverTest
Information about the networks used for failover test by this virtual machine.
VCD
IpMode
The IP mode. Possible values are:
■ Static IP Pool - pulls IP addresses from the network's IP pool.
■ Static Manual - allows you to specify an IP address.
■ DHCP - pulls IP addresses from a DHCP server.
IsConnected
True: Is NIC connected
False: Is NIC not connected.
IsPrimary
True: The DNS server that handles Internet protocol mapping is the primary.
False: The DNS server that handles Internet protocol mapping is not the primary.
IsResetMacAddress
True: The Media Access Control (MAC) address used on the protected site will be copied to the recovery site.
False: The Media Access Control (MAC) address used on the protected site will not be copied to the recovery site.
RecoveryOrgVdcNetworkIdentifier
The identifier of the Org vDC network. This is the recovery settings applied to the virtual machine When OrgVdcIdentifier is set, RecoveryOrgVdcNetworkIdentifier is set by default
Update the virtual machine settings in a VPG settings object
Request values for https://zvm_ip:port/v1/vpgSettings/vms/{vmIdentifier}/{vmIdentifier}/volumes/{volumeId}.
Parameter
Description
VmIdentifier
The identifier of the virtual machine. The identifier comprises the server identifier and the virtual machine moref, with the format, serverid.more.
Volumes
Information about the volumes used by the virtual machine.
IsSwap
True: The recovery disk is marked as a temp data disk.
False: The recovery disk is not marked as a temp data disk.
VCD
IsThin
True: The recovery volumes are thin-provisioned.
False: The recovery volumes are not thin-provisioned.
VolumeIdentifier
The identifier of the volume.
 
Response Format
The response bodies are empty.