Zerto Virtual Replication APIs : VPG Management API (vSphere and Hyper-V only) : https://zvm_ip:port/v1/vpgSettings – GET Methods
  
https://zvm_ip:port/v1/vpgSettings – GET Methods
The GET methods are used retrieve values in a VPG settings object.
URI
Get settings for VPGs
https://zvm_ip:port/v1/vpgSettings
Get settings for a VPG
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}
Get VPG backup settings
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/backup
Get the day a backup is scheduled
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/backup/dayofweek
Get a VPG backup retention period
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/backup/retentionperiod
Get a VPG backup schedule
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/backup/schedulerperiod
Get VPG basic settings
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/basic
Get VPG boot settings
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/bootgroup
Get VPG journal settings
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/journal
Get VPG network settings
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/networks
Get VPG network mapping settings – for future use
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/networksmapping
Get the VPG priority
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/priority
Get VPG recovery settings
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/recovery
Get VPG script settings
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/scripting
Get all VM settings for a VPG
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms
Get VM settings for a VM in a VPG
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}
Get all VM NIC settings
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/nics
Get settings for a VM NIC
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/nics/{nicIdentifier}
Get VM volume settings
https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}//vms/{vmIdentifier}/volumes
Get settings for a VM volume
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 for which information is retrieved.
vmIdentifier
The identifier of the virtual machine for which settings are retrieved. The identifier comprises the server identifier and the virtual machine moref, with the format, serverid.moref.
nicIdentifier
The identifier of the NIC for which settings are retrieved.
volumeId
The identifier of the volume for which settings are retrieved.
Request Format
The request body is empty.
Json Response Format
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings and, without the array statement, for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}.
[{
  "Backup":{
    "RepositoryIdentifier":"String content",
    "RetentionPeriod":"String content",
    "Retry":{
      "IntervalInMinutes":2147483647,
      "Number":2147483647,
      "Retry":true
    },
    "Scheduler":{
      "DayOfWeek":"String content",
      "SchedulerPeriod":"String content",
      "TimeOfDay":"String content"
    }
  },
  "Basic":{
    "JournalHistoryInHours":2147483647,
    "Name":"String content",
    "Priority":"String content",
    "ProtectedSiteIdentifier":"String content",
    "RecoverySiteIdentifier":"String content",
    "RpoInSeconds":4294967295,
    "ServiceProfileIdentifier":"String content",
    "TestIntervalInMinutes":2147483647,
    "UseWanCompression":true,
    "ZorgIdentifier":"String content"
  },
  "BootGroups":{
    "BootGroups":[{
      "BootDelayInSeconds":4294967295,
      "BootGroupIdentifier":"String content",
      "Name":"String content"
    }]
  },
  "Journal":{
    "DatastoreClusterIdentifier":"String content",
    "DatastoreIdentifier":"String content",
    "Limitation":{
      "HardLimitInMB":2147483647,
      "HardLimitInPercent":2147483647,
      "WarningThresholdInMB":2147483647,
      "WarningThresholdInPercent":2147483647
    }
  },
  "Networks":{
    "Failover":{
      "Hypervisor":{
        "DefaultNetworkIdentifier":"String content"
      }
    },
    "FailoverTest":{
      "Hypervisor":{
        "DefaultNetworkIdentifier":"String content"
      }
    }
  },
  "Recovery":{
    "DefaultDatastoreIdentifier":"String content",
    "DefaultFolderIdentifier":"String content",
    "DefaultHostClusterIdentifier":"String content",
    "DefaultHostIdentifier":"String content",
    "ResourcePoolIdentifier":"String content"
  },
  "Scripting":{
    "PostBackup":{
      "Command":"String content",
      "Parameters":"String content",
      "TimeoutInSeconds":2147483647
    },
    "PostRecovery":{
      "Command":"String content",
      "Parameters":"String content",
      "TimeoutInSeconds":2147483647
    },
    "PreRecovery":{
      "Command":"String content",
      "Parameters":"String content",
      "TimeoutInSeconds":2147483647
    }
  },
  "Vms":[{
    "BootGroupIdentifier":"String content",
    "Journal":{
      "DatastoreClusterIdentifier":"String content",
      "DatastoreIdentifier":"String content",
      "Limitation":{
        "HardLimitInMB":4294967295,
        "HardLimitInPercent":4294967295,
        "WarningThresholdInMB":4294967295,
        "WarningThresholdInPercent":4294967295
      }
    },
    "Nics":[{
      "Failover":{
        "Hypervisor":{
          "DnsSuffix":"String content",
          "IpConfig":{
            "Gateway":"String content",
            "IsDhcp":true,
            "PrimaryDns":"String content",
            "SecondaryDns":"String content",
            "StaticIp":"String content",
            "SubnetMask":"String content"
          },
          "NetworkIdentifier":"String content",
          "ShouldReplaceMacAddress":true
        }
      },
      "FailoverTest":{
        "Hypervisor":{
          "DnsSuffix":"String content",
          "IpConfig":{
            "Gateway":"String content",
            "IsDhcp":true,
            "PrimaryDns":"String content",
            "SecondaryDns":"String content",
            "StaticIp":"String content",
            "SubnetMask":"String content"
          },
          "NetworkIdentifier":"String content",
          "ShouldReplaceMacAddress":true
        }
      },
      "NicIdentifier":"String content"
    }],
    "Recovery":{
      "DatastoreClusterIdentifier":"String content",
      "DatastoreIdentifier":"String content",
      "FolderIdentifier":"String content",
      "HostClusterIdentifier":"String content",
      "HostIdentifier":"String content",
      "ResourcePoolIdentifier":"String content"
    },
    "VmIdentifier":"String content",
    "Volumes":[{
      "Datastore":{
        "DatastoreClusterIdentifier":"String content",
        "DatastoreIdentifier":"String content",
        "IsThin":true
      },
      "ExistingVolume":{
        "DatastoreIdentifier":"String content",
        "ExistedVmIdentifier":"String content",
        "Mode":"String content",
        "Path":"String content"
      },
      "IsSwap":true,
      "VolumeIdentifier":"String content"
    }]
  }],
  "VpgIdentifier":"String content",
  "VpgSettingsIdentifier":"String content"
}]
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/backup.
{
  "RepositoryIdentifier":"String content",
  "RetentionPeriod":"String content",
  "Retry":{
    "IntervalInMinutes":2147483647,
    "Number":2147483647,
    "Retry":true
  },
  "Scheduler":{
    "DayOfWeek":"String content",
    "SchedulerPeriod":"String content",
    "TimeOfDay":"String content"
  }
}
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/backup/dayofweek, https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/backup/retentionperiod, and for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/backup/schedulerperiod.
"String content"
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/basic.
{
  "JournalHistoryInHours":2147483647,
  "Name":"String content",
  "Priority":"String content",
  "ProtectedSiteIdentifier":"String content",
  "RecoverySiteIdentifier":"String content",
  "RpoInSeconds":4294967295,
  "ServiceProfileIdentifier":"String content",
  "TestIntervalInMinutes":2147483647,
  "UseWanCompression":true,
  "ZorgIdentifier":"String content"
}
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/bootgroup.
{
  "BootGroups":[{
    "BootDelayInSeconds":4294967295,
    "BootGroupIdentifier":"String content",
    "Name":"String content"
  }]
}
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/journal.
{
  "DatastoreClusterIdentifier":"String content",
  "DatastoreIdentifier":"String content",
  "Limitation":{
    "HardLimitInMB":2147483647,
    "HardLimitInPercent":2147483647,
    "WarningThresholdInMB":2147483647,
    "WarningThresholdInPercent":2147483647
  }
}
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/networks.
{
  "Failover":{
    "Hypervisor":{
      "DefaultNetworkIdentifier":"String content"
    }
  },
  "FailoverTest":{
    "Hypervisor":{
      "DefaultNetworkIdentifier":"String content"
    }
  }
}
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/priority.
"String content"
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/recovery.
{
  "DefaultDatastoreIdentifier":"String content",
  "DefaultFolderIdentifier":"String content",
  "DefaultHostClusterIdentifier":"String content",
  "DefaultHostIdentifier":"String content",
  "ResourcePoolIdentifier":"String content"
}
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/scripting.
{
  "PostBackup":{
    "Command":"String content",
    "Parameters":"String content",
    "TimeoutInSeconds":2147483647
  },
  "PostRecovery":{
    "Command":"String content",
    "Parameters":"String content",
    "TimeoutInSeconds":2147483647
  },
  "PreRecovery":{
    "Command":"String content",
    "Parameters":"String content",
    "TimeoutInSeconds":2147483647
  }
}
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms.
[{
  "BootGroupIdentifier":"String content",
  "Journal":{
    "DatastoreClusterIdentifier":"String content",
    "DatastoreIdentifier":"String content",
    "Limitation":{
      "HardLimitInMB":4294967295,
      "HardLimitInPercent":4294967295,
      "WarningThresholdInMB":4294967295,
      "WarningThresholdInPercent":4294967295
    }
  },
  "Nics":[{
    "Failover":{
      "Hypervisor":{
        "DnsSuffix":"String content",
        "IpConfig":{
          "Gateway":"String content",
          "IsDhcp":true,
          "PrimaryDns":"String content",
          "SecondaryDns":"String content",
          "StaticIp":"String content",
          "SubnetMask":"String content"
        },
        "NetworkIdentifier":"String content",
        "ShouldReplaceMacAddress":true
      }
    },
    "FailoverTest":{
      "Hypervisor":{
        "DnsSuffix":"String content",
        "IpConfig":{
          "Gateway":"String content",
          "IsDhcp":true,
          "PrimaryDns":"String content",
          "SecondaryDns":"String content",
          "StaticIp":"String content",
          "SubnetMask":"String content"
        },
        "NetworkIdentifier":"String content",
        "ShouldReplaceMacAddress":true
      }
    },
    "NicIdentifier":"String content"
  }],
  "Recovery":{
    "DatastoreClusterIdentifier":"String content",
    "DatastoreIdentifier":"String content",
    "FolderIdentifier":"String content",
    "HostClusterIdentifier":"String content",
    "HostIdentifier":"String content",
    "ResourcePoolIdentifier":"String content"
  },
  "VmIdentifier":"String content",
  "Volumes":[{
    "Datastore":{
      "DatastoreClusterIdentifier":"String content",
      "DatastoreIdentifier":"String content",
      "IsThin":true
    },
    "ExistingVolume":{
      "DatastoreIdentifier":"String content",
      "ExistedVmIdentifier":"String content",
      "Mode":"String content",
      "Path":"String content"
    },
    "IsSwap":true,
    "VolumeIdentifier":"String content"
  }]
}]
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}.
{
  "BootGroupIdentifier":"String content",
  "Journal":{
    "DatastoreClusterIdentifier":"String content",
    "DatastoreIdentifier":"String content",
    "Limitation":{
      "HardLimitInMB":4294967295,
      "HardLimitInPercent":4294967295,
      "WarningThresholdInMB":4294967295,
      "WarningThresholdInPercent":4294967295
    }
  },
  "Nics":[{
    "Failover":{
      "Hypervisor":{
        "DnsSuffix":"String content",
        "IpConfig":{
          "Gateway":"String content",
          "IsDhcp":true,
          "PrimaryDns":"String content",
          "SecondaryDns":"String content",
          "StaticIp":"String content",
          "SubnetMask":"String content"
        },
        "NetworkIdentifier":"String content",
        "ShouldReplaceMacAddress":true
      }
    },
    "FailoverTest":{
      "Hypervisor":{
        "DnsSuffix":"String content",
        "IpConfig":{
          "Gateway":"String content",
          "IsDhcp":true,
          "PrimaryDns":"String content",
          "SecondaryDns":"String content",
          "StaticIp":"String content",
          "SubnetMask":"String content"
        },
        "NetworkIdentifier":"String content",
        "ShouldReplaceMacAddress":true
      }
    },
    "NicIdentifier":"String content"
  }],
  "Recovery":{
    "DatastoreClusterIdentifier":"String content",
    "DatastoreIdentifier":"String content",
    "FolderIdentifier":"String content",
    "HostClusterIdentifier":"String content",
    "HostIdentifier":"String content",
    "ResourcePoolIdentifier":"String content"
  },
  "VmIdentifier":"String content",
  "Volumes":[{
    "Datastore":{
      "DatastoreClusterIdentifier":"String content",
      "DatastoreIdentifier":"String content",
      "IsThin":true
    },
    "ExistingVolume":{
      "DatastoreIdentifier":"String content",
      "ExistedVmIdentifier":"String content",
      "Mode":"String content",
      "Path":"String content"
    },
    "IsSwap":true,
    "VolumeIdentifier":"String content"
  }]
}
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/nics.
[{
  "Failover":{
    "Hypervisor":{
      "DnsSuffix":"String content",
      "IpConfig":{
        "Gateway":"String content",
        "IsDhcp":true,
        "PrimaryDns":"String content",
        "SecondaryDns":"String content",
        "StaticIp":"String content",
        "SubnetMask":"String content"
      },
      "NetworkIdentifier":"String content",
      "ShouldReplaceMacAddress":true
    }
  },
  "FailoverTest":{
    "Hypervisor":{
      "DnsSuffix":"String content",
      "IpConfig":{
        "Gateway":"String content",
        "IsDhcp":true,
        "PrimaryDns":"String content",
        "SecondaryDns":"String content",
        "StaticIp":"String content",
        "SubnetMask":"String content"
      },
      "NetworkIdentifier":"String content",
      "ShouldReplaceMacAddress":true
    }
  },
  "NicIdentifier":"String content"
}]
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/nics/{nicIdentifier}.
{
  "Failover":{
    "Hypervisor":{
      "DnsSuffix":"String content",
      "IpConfig":{
        "Gateway":"String content",
        "IsDhcp":true,
        "PrimaryDns":"String content",
        "SecondaryDns":"String content",
        "StaticIp":"String content",
        "SubnetMask":"String content"
      },
      "NetworkIdentifier":"String content",
      "ShouldReplaceMacAddress":true
    }
  },
  "FailoverTest":{
    "Hypervisor":{
      "DnsSuffix":"String content",
      "IpConfig":{
        "Gateway":"String content",
        "IsDhcp":true,
        "PrimaryDns":"String content",
        "SecondaryDns":"String content",
        "StaticIp":"String content",
        "SubnetMask":"String content"
      },
      "NetworkIdentifier":"String content",
      "ShouldReplaceMacAddress":true
    }
  },
  "NicIdentifier":"String content"
}
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/volumes.
[{
  "Datastore":{
    "DatastoreClusterIdentifier":"String content",
    "DatastoreIdentifier":"String content",
    "IsThin":true
  },
  "ExistingVolume":{
    "DatastoreIdentifier":"String content",
    "ExistedVmIdentifier":"String content",
    "Mode":"String content",
    "Path":"String content"
  },
  "IsSwap":true,
  "VolumeIdentifier":"String content"
}]
The following is an example response Json body for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/volumes/{volumeId}.
{
  "Datastore":{
    "DatastoreClusterIdentifier":"String content",
    "DatastoreIdentifier":"String content",
    "IsThin":true
  },
  "ExistingVolume":{
    "DatastoreIdentifier":"String content",
    "ExistedVmIdentifier":"String content",
    "Mode":"String content",
    "Path":"String content"
  },
  "IsSwap":true,
  "VolumeIdentifier":"String content"
}
Response Values
VPG settings
Response values for https://zvm_ip:port/v1/vpgSettings and for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}.
Parameter
Description
Backup
Information related to offsite backup.
RepositoryIdentifier
The identifier of the repository where offsite backups are written.
RetentionPeriod
The length of time to keep offsite backups, up to a maximum of 12 months. Over time, Zerto reduces the number of stored offsite backups to save space.
The SchedulerPeriod parameter defines whether backups are created daily or weekly.
For an explanation of how Zerto reduces the number of offsite backups, see the Zerto Virtual Replication Administration Guide.
Retry
Information about backup retries.
IntervalInMinutes
How much time to wait, in minutes, after a backup job fails before running the backup job again.
Number
The number of retries that will be attempted.
Retry
true – The offsite backup job is rerun automatically if it fails.
false – The offsite backup job is not rerun automatically if it fails.
Scheduler
Offsite backup schedule settings.
DayOfWeek
The day of the week that the offsite backups are run. If the value of SchedulerPeriod is daily, the value in this parameter can be ignored.
SchedulerPeriod
Daily – The offsite backups are run every day.
Weekly – The offsite backups are run once a week.
TimeOfDay
The time of day when offsite backup jobs are run. The time is based on a 24-hour clock.
Basic
Basic VPG settings.
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 source site where the VPG virtual machines are protected.
RecoverySiteIdentifier
The identifier of the target site where the VPG virtual machines are 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 is compressed before sending it to the recovery site.
false – Data is not compressed before sending it to the recovery site.
ZorgIdentifier
The identifier of the ZORG, Zerto organization, defined in the Zerto Cloud Manager.
BootGroups
Information about boot groups.
BootGroups
Information about boot groups.
BootDelayInSeconds
Specifies the delay, in seconds, between starting up the virtual machines in this group and starting up the virtual machines in the next group.
BootGroupIdentifier
The identifier of a boot group.
Name
The name of a boot group.
Journal
Information about the journal.
DatastoreIdentifier
The identifier of the storage used by the journal. The identifier comprises the server identifier and the storage moref, with the format, serverid.moref.
Limitation
Information about the journal limitations.
HardLimitInMB
The maximum journal size in MBs. 0 means unlimited.
HardLimitInPercent
The percentage of the virtual machine volume size the journal can grow to. 0 means unlimited.
WarningThresholdInMB
The journal size, in MBs, that generates a warning that the journal is nearing its hard limit. 0 means unlimited.
WarningThresholdInPercent
The percentage of the virtual machine volume size that generates a warning. 0 means unlimited.
Networks
Information about the networks that connect the protected and recovery sites.
Failover
Information about the networks used for failover.
Hypervisor
 
DefaultNetworkIdentifier
The network identifier of the network to use during a failover or move operation in which the recovered virtual machines will run.
FailoverTest
Information about the networks used for testing failover.
Hypervisor
 
DefaultNetworkIdentifier
The network identifier of the network to use when testing the failover of virtual machines in the recovery site.
Recovery
Information about the recovery site.
DefaultDatastoreIdentifier
The identifier of the default storage where the metadata files for the virtual machines are stored, such as the vmx or vhdx files. The identifier comprises the server identifier and the storage moref, with the format, serverid.moref.
DefaultFolderIdentifier
The identifier of the default folder used for recovery. The identifier comprises the server identifier and the folder moref, with the format, serverid.moref.
DefaultHostClusterIdentifier
The identifier of the default host cluster that handles the replicated data. The identifier comprises the server identifier and the host cluster moref, with the format, serverid.moref.
DefaultHostIdentifier
The identifier of the default host that handles the replicated data. The identifier comprises the server identifier and the host moref, with the format, serverid.moref.
ResourcePoolIdentifier
The identifier of the resource pool for the recovered virtual machines.
Scripting
Information about the scripts to run, either before or after recovery operation, or after an offsite backup is run.
PostBackup
Information about scripts that are run after an offsite backup is performed.
Command
The full path of the script. The script must be located on the same machine as the Zerto Virtual Manager for the recovery site.
Parameters
Parameters to pass to the script.
TimeoutInSeconds
The time-out, in seconds, for the script to run.
PostRecovery
Information about scripts that are run after a recovery operation is performed.
Command
The full path of the script. The script must be located on the same machine as the Zerto Virtual Manager for the recovery site.
Parameters
Parameters to pass to the script.
TimeoutInSeconds
The time-out, in seconds, for the script to run.
PreRecovery
Information about scripts that are run before a recovery operation is performed.
Command
The full path of the script. The script must be located on the same machine as the Zerto Virtual Manager for the recovery site.
Parameters
Parameters to pass to the script.
TimeoutInSeconds
The time-out, in seconds, for the script to run.
Vms
Information about the virtual machines in a VPG.
BootGroupIdentifier
The boot group identifier of a virtual machine.
Journal
Journal information of the virtual machine
DatastoreIdentifier
The identifier of the storage used by the journal for the virtual machine. The identifier comprises the server identifier and the storage moref, with the format, serverid.moref.
Limitation
Information about the journal limitations.
HardLimitInMB
The maximum journal size in MBs. 0 means unlimited.
HardLimitInPercent
The percentage of the virtual machine volume size the journal can grow to. 0 means unlimited.
WarningThresholdInMB
The journal size, in MBs, that generates a warning that the journal is nearing its hard limit. 0 means unlimited.
WarningThresholdInPercent
The percentage of the virtual machine volume size that generates a warning. 0 means unlimited.
Nics
Information about NICs used by the virtual machine in the VPG.
Failover
Information about the networks used for failover by this virtual machine.
Hypervisor
 
DnsSuffix
The DNS name excluding the host.
IpConfig
Information about the IP configuration of the recovery site used for failovers.
      Gateway
The mask for the network.
      IsDhcp
true – DHCP is used for the virtual machine on the recovery site.
false – A static IP address is used for the virtual machine on the recovery site.
      PrimaryDns
The IP address of the primary DNS server that handles Internet protocol mapping.
      SecondaryDns
The IP address of the alternate, secondary, DNS server that handles Internet protocol mapping.
      StaticIp
The IP of the restored virtual machine.
      SubnetMask
The subnet mask for the network.
NetworkIdentifier
The network identifier of the network used for failover or move by this virtual machine.
ShouldReplaceMacAddress
true – The Media Access Control (MAC) address used on the protected site is copied to the recovery site.
false – The Media Access Control (MAC) address used on the protected site is not copied to the recovery site.
FailoverTest
Information about the networks used for testing failover by this virtual machine.
Hypervisor
 
DnsSuffix
The DNS name excluding the host.
IpConfig
Information about the IP configuration of the recovery site used for testing failovers.
      Gateway
The mask for the network.
      IsDhcp
true – DHCP is used for the virtual machine on the recovery site.
false – A static IP address is used for the virtual machine on the recovery site.
      PrimaryDns
The IP address of the primary DNS server that handles Internet protocol mapping.
      SecondaryDns
The IP address of the alternate, secondary, DNS server that handles Internet protocol mapping.
      StaticIp
The IP of the restored virtual machine.
      SubnetMask
The subnet mask for the network.
NetworkIdentifier
The network identifier of the network used for testing failover by this virtual machine.
ShouldReplaceMacAddress
true – The Media Access Control (MAC) address used on the protected site is copied to the recovery site.
false – The Media Access Control (MAC) address used on the protected site is not copied to the recovery site.
NicIdentifier
The identifier of the NIC for which settings are returned.
Recovery
Information about the recovery site.
DatastoreIdentifier
The identifier of the storage. The identifier comprises the server identifier and the storage moref, with the format, serverid.moref.
FolderIdentifier
The identifier of the folder used for recovery by the virtual machine. The identifier comprises the server identifier and the folder moref, with the format, serverid.moref.
HostClusterIdentifier
The identifier of the host cluster that handles the replicated data. The identifier comprises the server identifier and the host cluster moref, with the format, serverid.moref.
HostIdentifier
The identifier of the host that handles the replicated data. The identifier comprises the server identifier and the host moref, with the format, serverid.moref.
ResourcePoolIdentifier
The identifier of the resource pool for the recovered virtual machines. The identifier comprises the server identifier and the resource pool moref, with the format, serverid.moref.
VmIdentifier
The identifier of the virtual machine. The identifier comprises the server identifier and the virtual machine moref, with the format, serverid.moref.
Volumes
Information about the volumes used by the virtual machine.
Datastore
Information about the datastore used by the virtual machine.
DatastoreIdentifier
The identifier of the storage. The identifier comprises the server identifier and the storage moref, with the format, serverid.moref.
IsThin
true – The recovery volumes are thin-provisioned.
false – The recovery volumes are not thin-provisioned.
ExistingVolume
For future use.
DatastoreIdentifier
For future use.
ExistedVmIdentifier
For future use.
Mode
For future use.
Path
For future use.
IsSwap
true – The recovery disk is marked as a swap disk.
false – The recovery disk is not marked as a swap disk.
VolumeIdentifier
The identifier of the volume.
VpgIdentifier
The identifier of the VPG.
VpgSettingsIdentifier
The identifier of the VPG settings object.
Backup
Response values for https://172.20.99.40:9669/v1/vpgSettings/{vpgSettingsIdentifier}/backup.
Parameter
Description
RepositoryIdentifier
The identifier of the repository where offsite backups are written.
RetentionPeriod
The length of time to keep offsite backups, up to a maximum of 12 months. Over time, Zerto reduces the number of stored offsite backups to save space.
The SchedulerPeriod parameter defines whether backups are created daily or weekly.
For an explanation of how Zerto reduces the number of offsite backups, see the Zerto Virtual Replication Administration Guide.
Retry
Information about backup retries.
IntervalInMinutes
How much time to wait, in minutes, after a backup job fails before running the backup job again.
Number
The number of retries that will be attempted.
Retry
true – The offsite backup job is rerun automatically if it fails.
false – The offsite backup job is not rerun automatically if it fails.
Scheduler
Offsite backup schedule settings.
DayOfWeek
The day of the week that the offsite backups are run. If the value of SchedulerPeriod is daily, the value in this parameter can be ignored.
SchedulerPeriod
Daily – The offsite backups are run every day.
Weekly – The offsite backups are run once a week.
TimeOfDay
The time of day when offsite backup jobs are run. The time is based on a 24-hour clock.
Backup day of week
Response values for https://172.20.99.40:9669/v1/vpgSettings/{vpgSettingsIdentifier}/backup/dayofweek.
Response – Description
The day of the week that the offsite backups are run.
Backup retention period
Response values for https://172.20.99.40:9669/v1/vpgSettings/{vpgSettingsIdentifier}/backup/retentionperiod.
Response – Description
The amount of time the offsite backups are kept.
Backup scheduler period
Response values for https://172.20.99.40:9669/v1/vpgSettings/{vpgSettingsIdentifier}/backup/schedulerperiod.
Response – Description
The schedule for running offsite backups:
Daily – The offsite backups are run every day.
Weekly – The offsite backups are run once a week.
Basic
Response values for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/basic.
Parameter
Description
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 source site where the VPG virtual machines are protected.
RecoverySiteIdentifier
The identifier of the target site where the VPG virtual machines are 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 is compressed before sending it to the recovery site.
false – Data is not compressed before sending it to the recovery site.
ZorgIdentifier
The identifier of the ZORG, Zerto organization, defined in the Zerto Cloud Manager.
Boot group
Response values for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/bootgroup.:
Parameter
Description
BootGroups
Information about boot groups.
BootDelayInSeconds
Specifies the delay, in seconds, between starting up the virtual machines in this group and starting up the virtual machines in the next group.
BootGroupIdentifier
The identifier of a boot group.
Name
The name of a boot group.
Journal
Response values for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/journal.
Parameter
Description
DatastoreIdentifier
The identifier of the storage used by the journal. The identifier comprises the server identifier and the storage moref, with the format, serverid.moref.
Limitation
Information about the journal limitations.
HardLimitInMB
The maximum journal size in MBs. 0 means unlimited.
HardLimitInPercent
The percentage of the virtual machine volume size the journal can grow to. 0 means unlimited.
WarningThresholdInMB
The journal size, in MBs, that generates a warning that the journal is nearing its hard limit. 0 means unlimited.
WarningThresholdInPercent
The percentage of the virtual machine volume size that generates a warning. 0 means unlimited.
Network
Response values for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/networks.
Parameter
Description
Failover
Information about the networks used for failover.
Hypervisor
 
DefaultNetworkIdentifier
The network identifier of the network to use during a failover or move operation in which the recovered virtual machines will run.
FailoverTest
Information about the networks used for testing failover.
Hypervisor
 
DefaultNetworkIdentifier
The network identifier of the network to use when testing the failover of virtual machines in the recovery site.
Network mapping
The networksmapping API is for future use.
Priority
Response values for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/priority.
Response – Description
Possible VPG priorities:
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.
Recovery
Response values for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/recovery.
Parameter
Description
DefaultDatastoreIdentifier
The identifier of the default storage where the metadata files for the virtual machines are stored, such as the vmx or vhdx files. The identifier comprises the server identifier and the storage moref, with the format, serverid.moref.
DefaultFolderIdentifier
The identifier of the default folder used for recovery. The identifier comprises the server identifier and the folder moref, with the format, serverid.moref.
DefaultHostClusterIdentifier
The identifier of the default host cluster that handles the replicated data. The identifier comprises the server identifier and the host cluster moref, with the format, serverid.moref.
DefaultHostIdentifier
The identifier of the default host that handles the replicated data. The identifier comprises the server identifier and the host moref, with the format, serverid.moref.
ResourcePoolIdentifier
The identifier of the resource pool for the recovered virtual machines. The identifier comprises the server identifier and the resource pool moref, with the format, serverid.moref.
Scripting
Response values for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/scripting.
Parameter
Information about the scripts to run, either before or after recovery operation, or after an offsite backup is run.
PostBackup
Information about scripts that are run after an offsite backup is performed.
Command
The full path of the script. The script must be located on the same machine as the Zerto Virtual Manager for the recovery site.
Parameters
Parameters to pass to the script.
TimeoutInSeconds
The time-out, in seconds, for the script to run.
PostRecovery
Information about scripts that are run after a recovery operation is performed.
Command
The full path of the script. The script must be located on the same machine as the Zerto Virtual Manager for the recovery site.
Parameters
Parameters to pass to the script.
TimeoutInSeconds
The time-out, in seconds, for the script to run.
PreRecovery
Information about scripts that are run before a recovery operation is performed.
Command
The full path of the script. The script must be located on the same machine as the Zerto Virtual Manager for the recovery site.
Parameters
Parameters to pass to the script.
TimeoutInSeconds
The time-out, in seconds, for the script to run.
Virtual machines
Response values for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms and https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}.
Parameter
Description
BootGroupIdentifier
The boot group identifier of a virtual machine.
Journal
Journal information of the virtual machine
DatastoreIdentifier
The identifier of the storage used by the journal for the virtual machine. The identifier comprises the server identifier and the storage moref, with the format, serverid.moref.
Limitation
Information about the journal limitations.
HardLimitInMB
The maximum journal size in MBs. 0 means unlimited.
HardLimitInPercent
The percentage of the virtual machine volume size the journal can grow to. 0 means unlimited.
WarningThresholdInMB
The journal size, in MBs, that generates a warning that the journal is nearing its hard limit. 0 means unlimited.
WarningThresholdInPercent
The percentage of the virtual machine volume size that generates a warning. 0 means unlimited.
Nics
Information about NICs used by the virtual machine in the VPG.
Failover
Information about the networks used for failover by this virtual machine.
Hypervisor
 
DnsSuffix
The DNS name excluding the host.
IpConfig
Information about the IP configuration of the recovery site used for failovers.
Gateway
The mask for the network.
IsDhcp
true – DHCP is used for the virtual machine on the recovery site.
false – A static IP address is used for the virtual machine on the recovery site.
PrimaryDns
The IP address of the primary DNS server that handles Internet protocol mapping.
SecondaryDns
The IP address of the alternate, secondary, DNS server that handles Internet protocol mapping.
StaticIp
The IP of the restored virtual machine.
SubnetMask
The subnet mask for the network.
NetworkIdentifier
The network identifier of the network used for failover or move by this virtual machine.
ShouldReplaceMacAddress
true – The Media Access Control (MAC) address used on the protected site is copied to the recovery site.
false – The Media Access Control (MAC) address used on the protected site is not copied to the recovery site.
FailoverTest
true – The Media Access Control (MAC) address used on the protected site is copied to the recovery site.
false – The Media Access Control (MAC) address used on the protected site is not copied to the recovery site.
Hypervisor
 
DnsSuffix
The DNS name excluding the host.
IpConfig
Information about the IP configuration of the recovery site used for testing failovers.
Gateway
The mask for the network.
IsDhcp
true – DHCP is used for the virtual machine on the recovery site.
false – A static IP address is used for the virtual machine on the recovery site.
PrimaryDns
The IP address of the primary DNS server that handles Internet protocol mapping.
SecondaryDns
The IP address of the alternate, secondary, DNS server that handles Internet protocol mapping.
StaticIp
The IP of the restored virtual machine.
SubnetMask
The subnet mask for the network.
NetworkIdentifier
The network identifier of the network used for testing failover by this virtual machine.
ShouldReplaceMacAddress
true – The Media Access Control (MAC) address used on the protected site is copied to the recovery site.
false – The Media Access Control (MAC) address used on the protected site is not copied to the recovery site.
NicIdentifier
The identifier of the NIC for which settings are returned.
Recovery
Information about the recovery site.
DatastoreIdentifier
The identifier of the storage. The identifier comprises the server identifier and the storage moref, with the format, serverid.moref.
FolderIdentifier
The identifier of the folder used for recovery by the virtual machine. The identifier comprises the server identifier and the folder moref, with the format, serverid.moref.
HostClusterIdentifier
The identifier of the host cluster that handles the replicated data. The identifier comprises the server identifier and the host cluster moref, with the format, serverid.moref.
HostIdentifier
The identifier of the host that handles the replicated data. The identifier comprises the server identifier and the host moref, with the format, serverid.moref.
ResourcePoolIdentifier
The identifier of the resource pool for the recovered virtual machines. The identifier comprises the server identifier and the resource pool moref, with the format, serverid.moref.
VmIdentifier
The identifier of the virtual machine. The identifier comprises the server identifier and the virtual machine moref, with the format, serverid.moref.
Volumes
Information about the volumes used by the virtual machine.
Datastore
Information about the datastore used by the virtual machine.
DatastoreIdentifier
The identifier of the storage. The identifier comprises the server identifier and the storage moref, with the format, serverid.moref.
IsThin
true – The recovery volumes are thin-provisioned.
false – The recovery volumes are not thin-provisioned.
ExistingVolume
For future use.
DatastoreIdentifier
For future use.
ExistedVmIdentifier
For future use.
Mode
For future use.
Path
For future use.
IsSwap
true – The recovery disk is marked as a swap disk.
false – The recovery disk is not marked as a swap disk.
VolumeIdentifier
The identifier of the volume.
Virtual machine NICs
Response values for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/nic and https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/nic/{nicIdentifier}.
Parameter
Description
Failover
Information about the networks used for failover by this virtual machine.
Hypervisor
 
DnsSuffix
The DNS name excluding the host.
IpConfig
Information about the IP configuration of the recovery site used for failovers.
Gateway
The mask for the network.
IsDhcp
true – DHCP is used for the virtual machine on the recovery site.
false – A static IP address is used for the virtual machine on the recovery site.
PrimaryDns
The IP address of the primary DNS server that handles Internet protocol mapping.
SecondaryDns
The IP address of the alternate, secondary, DNS server that handles Internet protocol mapping.
StaticIp
The IP of the restored virtual machine.
SubnetMask
The subnet mask for the network.
NetworkIdentifier
The network identifier of the network used for failover or move by this virtual machine.
ShouldReplaceMacAddress
true – The Media Access Control (MAC) address used on the protected site is copied to the recovery site.
false – The Media Access Control (MAC) address used on the protected site is not copied to the recovery site.
FailoverTest
Information about the networks used for testing failover by this virtual machine.
Hypervisor
 
DnsSuffix
The DNS name excluding the host.
IpConfig
Information about the IP configuration of the recovery site used for testing failovers.
Gateway
The mask for the network.
IsDhcp
true – DHCP is used for the virtual machine on the recovery site.
false – A static IP address is used for the virtual machine on the recovery site.
PrimaryDns
The IP address of the primary DNS server that handles Internet protocol mapping.
SecondaryDns
The IP address of the alternate, secondary, DNS server that handles Internet protocol mapping.
StaticIp
The IP of the restored virtual machine.
SubnetMask
The subnet mask for the network.
NetworkIdentifier
The network identifier of the network used for testing failover by this virtual machine.
ShouldReplaceMacAddress
true – Copy the Media Access Control (MAC) address used on the protected site to the recovery site.
false – Do not copy the MAC address from the protected site to the recovery site.
NicIdentifier
The identifier of the NIC for which settings are returned.
Virtual machine volumes
Response values for https://zvm_ip:port/v1/vpgSettings/{vpgSettingsIdentifier}/vms/{vmIdentifier}/volumes and.
Parameter
Description
Datastore
Information about the datastore used by the virtual machine.
DatastoreIdentifier
The identifier of the storage. The identifier comprises the server identifier and the storage moref, with the format, serverid.moref.
IsThin
true – The recovery volumes are thin-provisioned.
false – The recovery volumes are not thin-provisioned.
ExistingVolume
For future use.
DatastoreIdentifier
For future use.
ExistedVmIdentifier
For future use.
Mode
For future use.
Path
For future use.
IsSwap
true – The recovery disk is marked as a swap disk.
false – The recovery disk is not marked as a swap disk.
VolumeIdentifier
The identifier of the volume.