VPGs API XML Request and Response Formats

Important:  This document is being phased out and does not contain up-to-date information. For updated API documentation for Zerto versions 9.5 and later, see ZVM REST API - Swagger.

You can also access Swagger from the ZVM: click the menu button () on the top right and select APIs or navigate to https://<ZVM IP>:9669/swagger/index.html in a Windows ZVM or https://<ZVM IP>/management/api/swagger/index.html in ZVM Appliance.

The https://zvm_ip:port/v1/vpgs API has GET, POST and DELETE methods:

VPGs API GET Method Response Formats

VPGs API POST Method Request and Response Formats

VPGs API DELETE Method Request and Response Formats

VPGs API GET Method Response Formats

The https://zvm_ip:port/v1/vpgs GET APIs have response bodies.

Response Body Format

The following is an example response XML body for

https://zvm_ip:port/v1/vpgs and, without the array statement, for

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}.

<ArrayOfVpgApi xmlns="http://schemas.zerto.com/zvm/api">
  <VpgApi>
  <ActiveProcessesApi>
    <RunningFailOverTestApi>
      <Stage>String content</Stage>
    </RunningFailOverTestApi>
  </ActiveProcessesApi>
  <ActualRPO>2147483647</ActualRPO>
  <BackupEnabled>true</BackupEnabled>

  <Entities>
    <Protected>VCVpg</Protected>
    <Recovery>VCVpg</Recovery>
    <Source>VCVpg</Source>
    <Target>VCVpg</Target>
  </Entities>

  <IOPS>2147483647</IOPS>
  <LastTest>2021-06-15T04:31:21.651Z</LastTest>

  <Link>
    <href>String content</href>
    <identifier>String content</identifier>
    <rel>String content</rel>
    <type>String content</type>
  </Link>
  <Link__x007B_0_x007D_>
    <href>String content</href>
    <rel>String content</rel>
    <type>String content</type>
  </Link__x007B_0_x007D_>

  <OrganizationName>String content</OrganizationName>
  <Priority>Low</Priority>
  <ProgressPercentage>1.26743233E+15</ProgressPercentage>

  <ProtectedSite>
    <href>String content</href>
    <identifier>String content</identifier>
    <rel>String content</rel>
    <type>String content</type>
  </ProtectedSite>
  <ProvisionedStorageInMB>2147483647</ProvisionedStorageInMB>

  <RecoverySite>
    <href>String content</href>
    <identifier>String content</identifier>
    <rel>String content</rel>
    <type>String content</type>
  </RecoverySite>

  <ServiceProfile>
    <href>String content</href>
    <identifier>String content</identifier>
    <rel>String content</rel>
    <type>String content</type>
  </ServiceProfile>

  <ServiceProfileIdentifier>String content</ServiceProfileIdentifier>
  <ServiceProfileName>String content</ServiceProfileName>
  <SourceSite>String content</SourceSite>
  <Status>Initializing</Status>
  <SubStatus>None</SubStatus>

  <TargetSite>String content</TargetSite>
  <ThroughputInMB>1.26743233E+15</ThroughputInMB>
  <UsedStorageInMB>2147483647</UsedStorageInMB>
  <VmsCount>2147483647</VmsCount>
  <VpgIdentifier>String content</VpgIdentifier>
  <VpgName>String content</VpgName>

  <Zorg>
    <href>String content</href>
    <identifier>String content</identifier>
    <rel>String content</rel>
    <type>String content</type>
  </Zorg>

  </VpgApi>
...
</ArrayOfVpgApi>

The following is an example response XML body for

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/checkpoints/summary.

<VpgCheckpointsSummaryApi xmlns="http://schemas.zerto.com/zvm/api">
  <VpgDateCheckpointsInfo>
    <VpgDateCheckpointInfoApi>
      <Count>4294967295</Count>
      <Date>2021-06-15T04:31:21.651Z</Date>
    </VpgDateCheckpointInfoApi>
    <VpgDateCheckpointInfoApi>
      <Count>4294967295</Count>
      <Date>2021-06-15T04:31:21.651Z</Date>
    </VpgDateCheckpointInfoApi>
  </VpgDateCheckpointsInfo>
</VpgCheckpointsSummaryApi>

The following is an example response XML body for

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/checkpoints.

<ArrayOfCheckpointApi xmlns="http://schemas.zerto.com/zvm/api">
  <CheckpointApi>
    <CheckpointId>String content</CheckpointId>
    <Tag>String content</Tag>
    <TimeStamp>2021-06-15T04:31:21.651Z</TimeStamp>
  </CheckpointApi>
...
</ArrayOfCheckpointApi>

The following is an example response XML body for

https://zvm_ip:port/v1/vpgs/entitytypes,

https://zvm_ip:port/v1/vpgs/failovercommitpolicies,

https://zvm_ip:port/v1/vpgs/failovershutdownpolicies,

https://zvm_ip:port/v1/vpgs/priorities,

https://zvm_ip:port/v1/vpgs/retentionpolicies,

https://zvm_ip:port/v1/vpgs/statuses, and for

https://zvm_ip:port/v1/vpgs/substatuses.

<ArrayOfstring xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
  <string>String content</string>
  ...
</ArrayOfstring>

VPGs API POST Method Request and Response Formats

The https://zvm_ip:port/v1/vpgs POST APIs have both request and response bodies.

Request Body Format

The following is an example request XML body for https://zvm_ip:port/v1/vpgs.

<VpgCreateDataApi xmlns="http://schemas.zerto.com/zvm/api">
  <DatastoreIdentifier>String content</DatastoreIdentifier>
  <OrgVdcIdentifier>String content</OrgVdcIdentifier>
  <Priority>Low</Priority>
  <ResourcePoolIdentifier>String content</ResourcePoolIdentifier>
  <ServiceProfileIdentifier>String content</ServiceProfileIdentifier>
  <SourceSiteIdentifier>String content</SourceSiteIdentifier>
  <TargetSiteIdentifier>String content</TargetSiteIdentifier>
  <VcVappIdentifier>String content</VcVappIdentifier>
  <VcdVappIdentifier>String content</VcdVappIdentifier>
  <VmsIdentifiers>
    <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">String content</string>
    <string xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">String content</string>
  </VmsIdentifiers>~
  <VpgName>String content</VpgName>
  <ZorgIdentifier>String content</ZorgIdentifier>
</VpgCreateDataApi>

The following is an example request XML body for

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/Checkpoints.

<CheckpointsDataApi xmlns="http://schemas.zerto.com/zvm/api">
  <CheckpointName>String content</CheckpointName>
</CheckpointsDataApi>

The following is an example request XML body for

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/CloneStart.

<CloneStartDataApi xmlns="http://schemas.zerto.com/zvm/api">
  <CheckpointId>String content</CheckpointId>
  <DatastoreIdentifier>String content</DatastoreIdentifier>
</CloneStartDataApi>

The following is an example request XML body for

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/Failover.

<FailoverDataApi xmlns="http://schemas.zerto.com/zvm/api">
  <CheckpointId>String content</CheckpointId>
  <CommitPolicy>Commit</CommitPolicy>
  <ShutdownPolicy>None</ShutdownPolicy>
  <TimeToWaitBeforeShutdownInSec>2147483647</TimeToWaitBeforeShutdownInSec>
  <IsReverseProtection>true</IsReverseProtection>
</FailoverDataApi>

The following is an example request XML body for

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/FailoverTest.

<FailOverTestStartDataApi xmlns="http://schemas.zerto.com/zvm/api">
  <CheckpointId>String content</CheckpointId>
</FailOverTestStartDataApi>

The following is an example request XML body for

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/FailoverTestStop.

<StopFailoverTestDataApi xmlns="http://schemas.zerto.com/zvm/api">
  <FailoverTestSuccess>true</FailoverTestSuccess>
  <FailoverTestSummary>String content</FailoverTestSummary>
</StopFailoverTestDataApi>

The following is an example request XML body for

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/FailoverCommit.

<FailoverCommitDataApi xmlns="http://schemas.zerto.com/zvm/api">
  <IsReverseProtection>true</IsReverseProtection>
</FailoverCommitDataApi>

The request bodies for the other VPGs POST APIs, such as https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/FailoverRollback, is empty.

Response Body Format

The following is an example response XML body for https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/vpgs,

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/Checkpoints,

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/CloneStart,

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/Failover,

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/FailoverCommit,

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/FailoverRollback,

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/FailoverTest,

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/FailoverTestStop,

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/Forcesync,

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/Pause, and for

https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/Resume.

<string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">String content</string>

VPGs API DELETE Method Request and Response Formats

The https://zvm_ip:port/v1/vpgs DELETE APIs have both request and response bodies.

Request Body Format

The following is an example request XML body for https://zvm_ip:port/v1/vpgs/{VpgIdentifier}.

<VpgDeleteDataApi xmlns="http://schemas.zerto.com/zvm/api">
  <Force>true</Force>
  <KeepRecoveryVolumes>true</KeepRecoveryVolumes>
</VpgDeleteDataApi>

Response Body Format

The following is an example response XML body for https://zvm_ip:port/v1/vpgs/{VpgIdentifier}.

<string xmlns="http://schemas.microsoft.com/2003/10/Serialization/">String content</string>