Zerto Virtual Replication APIs : VPGs API : https://zvm_ip:port/v1/vpgs – GET Methods
  
https://zvm_ip:port/v1/vpgs – GET Methods
Returns information about VPGs.
URI
All VPGs
https://zvm_ip:port/v1/vpgs
Filtered VPGs
https://zvm_ip:port/v1/vpgs?name={NAME}&status={STATUS}&substatus={SUBSTATUS}&protectedSiteType={PROTECTEDSITETYPE}&recoverySiteType={RECOVERYSITETYPE}&protectedSiteIdentifier={PROTECTEDSITEIDENTIFIER}&recoverySiteIdentifier={RECOVERYSITEIDENTIFIER}&sourceSite={SOURCESITE}&targetSite={TARGETSITE}&sourceType={SOURCETYPE}&targetType={TARGETTYPE}&organizationName={ORGNAME}&zorgIdentifier={ZORGIDENTIFIER}&priority={PRIORITY}&serviceProfileIdentifier={SERVICEPROFILEIDENTIFIER}&backupEnabled={BACKUPENABLED}
Single VPG
https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}
VPG Checkpoints
https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/checkpoints
Valid VPG entities
https://zvm_ip:port/v1/vpgs/entitytypes
Valid failover commit policies
https://zvm_ip:port/v1/vpgs/failovercommitpolicies
Valid failover shutdown policies
https://zvm_ip:port/v1/vpgs/failovershutdownpolicies
Valid VPG priorities
https://zvm_ip:port/v1/vpgs/priorities
Valid failover retention policies
https://zvm_ip:port/v1/vpgs/retentionpolicies
Valid VPG statuses
https://zvm_ip:port/v1/vpgs/statuses
Valid VPG substatuses
https://zvm_ip:port/v1/vpgs/substatuses
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.
protectionGroupIdentifier
The identifier of the VPG for which information is retrieved.
Filters
Filters are optional and any combination of filters is valid. When no filter is specified, all VPGs are returned. Filters are not case-sensitive.
 
Filter
Description
 
name
The name of the VPG.
 
status
The status of the VPG. Possible values are:
0 or Initializing– The VPG is being initialized. This includes when a VPG is created, and during the initial sync between sites.
1 or MeetingSLA – The VPG is meeting the SLA specification.
2 or NotMeetingSLA – The VPG is not meeting the SLA specification for both the journal history and RPO SLA settings.
3 or HistoryNotMeetingSLA – The VPG is not meeting the SLA specification for the journal history.
4 or RpoNotMeetingSLA – The VPG is not meeting the SLA specification for the RPO SLA setting.
5 or FailingOver – The VPG is in a Failover operation.
6 or Moving – The VPG is in a Move operation.
7 or Deleting – The VPG is being deleted.
8 or Recovered – The VPG has been recovered.
 
SubStatus
The substatus of the VPG, for example the VPG is in a bitmap sync. For the description of substatuses, refer to the Zerto Virtual Manager Administration Guide. Possible values are
0 or None
1 or InitialSync
2 or Creating
3 or VolumeInitialSync
4 or Sync
5 or RecoveryPossible
6 or DeltaSync
7 or NeedsConfiguration
8 or Error
9 or EmptyProtectionGroup
 
 
10 or DisconnectedFromPeerNoRecoveryPoints
11 or FullSync
12 or VolumeDeltaSync
13 or VolumeFullSync
14 or FailingOverCommitting
15 or FailingOverBeforeCommit
16 or FailingOverRollingBack
17 or Promoting
18 or MovingCommitting
19 or MovingBeforeCommit
 
 
20 or MovingRollingBack
21 or Deleting
22 or PendingRemove
23 or BitmapSync
24 or DisconnectedFromPeer
25 or ReplicationPausedUserInitiated
26 or ReplicationPausedSystemInitiated
27 or RecoveryStorageProfileError
28 or Backup
29 or RollingBack
 
30 or RecoveryStorageError
31 or JournalStorageError
32 or VmNotProtectedError
 
protectedSiteType
The protected site environment. This filter behaves in the same way as the sourceType filter. Possible values are:
0 or VCVpg – The VPG is protecting virtual machines in a VMware vCenter Server.
1 or VCvApp – The VPG is protecting a VMware vCenter Server vApp.
2 or VCDvApp – The VPG is protecting a VMware vCloud Director vApp.
3 or AWS – Not applicable.
4 or HyperV – The VPG is protecting virtual machines in Microsoft Hyper-V.
 
recoverySiteType
The recovery site environment. This filter behaves in the same way as the targetType filter. Possible values are:
0 or VCVpg – The VPG is recovering virtual machines to a VMware vCenter Server.
1 or VCvApp – The VPG is recovering virtual machines to a VMware vCenter Server vApp.
2 or VCDvApp – The VPG is recovering virtual machines to a VMware vCloud Director vApp.
3 or AWS – The VPG is recovering virtual machines virtual machines to Amazon Web Services (AWS).
4 or HyperV – The VPG is recovering virtual machines to Microsoft Hyper-V.
 
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.
 
sourceSite
The name of the source site where the VPG virtual machines are protected.
 
targetSite
The name of the target site where the VPG virtual machines are recovered.
 
sourceType
The protected site environment. This filter behaves in the same way as the protectedSiteType filter. Possible values are:
0 or VCVpg – The VPG is protecting virtual machines in a VMware vCenter Server.
1 or VCvApp – The VPG is protecting a VMware vCenter Server vApp.
2 or VCDvApp – The VPG is protecting a VMware vCloud Director vApp.
3 or AWS – Not applicable.
4 or HyperV – The VPG is protecting virtual machines in Microsoft Hyper-V.
 
targetType
The recovery site environment. This filter behaves in the same way as the recoverySiteType filter. Possible values are:
0 or VCVpg – The VPG is recovering virtual machines in a VMware vCenter Server.
1 or VCvApp – The VPG is recovering a VMware vCenter Server vApp.
2 or VCDvApp – The VPG is recovering a VMware vCloud Director vApp.
3 or AWS – The VPG is recovering virtual machines in Amazon Web Services (AWS).
4 or HyperV – The VPG is recovering virtual machines in Microsoft Hyper-V.
 
organizationName
The ZORG for this VPG.
 
zorgIdentifier
The internal identifier for the ZORG.
 
priority
The VPG priority. Possible values are:
0 or Low – The VPG has a low priority for transferring data.
1 or Medium – The VPG has a medium priority for transferring data.
2 or High – The VPG has a high priority for transferring data.
 
serviceProfileIdentifier
The identifier of the service profile to use for the VPG when a Zerto Cloud Manager is used.
 
backupEnabled
true – The VPG is defined for both disaster recovery and for long term recovery via offsite backup.
false – The VPG is defined for disaster recovery only.
Request Format
The request body is empty.
Json Response Format
The following is an example response Json body for https://zvm_ip:port/v1/vpgs and, without the array statement, for https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}.
[{
  "ActiveProcessesApi":{
    "RunningFailOverTestApi":{
      "Stage":"String content"
    }
  },
  "ActualRPO": 2147483647,
  "BackupEnabled":Boolean,
  "Entities": {
    "Protected":0,
    "Recovery":0,
    "Source": 0,
    "Target": 0
  },
  "IOPS": 2147483647,
  "LastTest": "/Date(928142400000+0300)/",
  "Link": {
    "href": "String content",
    "identifier":"String content",
    "rel": "String content",
    "type": "String content"
  },
  "Link__x007B_0_x007D_": {
    "href": "String content",
    "rel": "String content",
    "type": "String content"
  },
  "OrganizationName": "String content",
  "Priority": 0,
  "ProgressPercentage": 1.26743233E+15,
  "ProtectedSite":{
    "href":"String content",
    "identifier":"String content",
    "rel":"String content",
    "type":"String content"
  },
  "ProvisionedStorageInMB": 2147483647,
  "RecoverySite":{
    "href":"String content",
    "identifier":"String content",
    "rel":"String content",
    "type":"String content"
  },
  "ServiceProfile":{
    "href":"String content",
    "identifier":"String content",
    "rel":"String content",
    "type":"String content"
  },
  "ServiceProfileIdentifier":"String content",
  "ServiceProfileName":"String content",
  "SourceSite": "String content",
  "Status": 0,
  "SubStatus": 0,
  "TargetSite": "String content",
  "ThroughputInMB": 1.26743233E+15,
  "UsedStorageInMB": 2147483647,
  "VmsCount": 2147483647
  "VpgIdentifier": "String content"
  "VpgName": "String content",
  "Zorg":{
    "href":"String content",
    "identifier":"String content",
    "rel":"String content",
    "type":"String content"
  }
}]
The following is an example response Json body for https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/checkpoints.
[{
  "CheckpointIdentifier": "String content",
  "Tag": "String content",
  "TimeStamp": "/Date(1391506182943)/",
  "Vss": false
}
The following is an example response Json 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.
["String content"]
XML Response Format
For the XML response format, see VPGs API GET Method Response Formats.
Response Values
VPGs
Response values for https://zvm_ip:port/v1/vpgs and for https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}.
Parameter
Description
ActiveProcessApi
The current stage of an operation being performed on the VPG.
RunningFailoverTestApi
The operation being performed.
Stage
The stage of the running operation:
InTest – The VPG is in a failover test operation.
Starting – The VPG virtual machines in the recovery site are being initialized for a failover test.
Stopping – The recovery site is being cleaned up after a failover test of the VPG.
ActualRPO
The time since the last checkpoint was written to the journal in seconds. This should be less than the Target RPO Alert value specified for the VPG. A value of -1 means that the RPO has not been calculated.
BackupEnabled
true – The VPG is defined for both disaster recovery and for long term recovery via offsite backup.
false – The VPG is defined for disaster recovery only.
Entities
The source type and target types where the VPG is protected and recovered.
Protected
The protected site environment. This parameter behaves in the same way as the Source parameter. Possible values are (Json/XML):
0/VCVpg – The VPG is protecting virtual machines in a VMware vCenter Server.
1/VCvApp – The VPG is protecting a VMware vCenter Server vApp.
2/VCDvApp – The VPG is protecting a VMware vCloud Director vApp.
3/AWS – Not applicable.
4/HyperV – The VPG is protecting virtual machines in Microsoft Hyper-V.
Recovery
The recovery site environment. This parameter behaves in the same way as the Target parameter. Possible values are (Json/XML):
0/VCVpg – The VPG is recovering virtual machines in a VMware vCenter Server.
1/VCvApp – The VPG is recovering a VMware vCenter Server vApp.
2/VCDvApp – The VPG is recovering a VMware vCloud Director vApp.
3/AWS – The VPG is recovering virtual machines in Amazon Web Services (AWS).
4/HyperV – The VPG is recovering virtual machines in Microsoft Hyper-V.
Source
The protected site environment. This parameter behaves in the same way as the Protected parameter. Possible values are (Json/XML):
0/VCVpg – The VPG is protecting virtual machines in a VMware vCenter Server.
1/VCvApp – The VPG is protecting a VMware vCenter Server vApp.
2/VCDvApp – The VPG is protecting a VMware vCloud Director vApp.
3/AWS – Not applicable.
4/HyperV – The VPG is protecting virtual machines in Microsoft Hyper-V.
Target
The recovery site environment. This parameter behaves in the same way as the Recovery parameter. Possible values are (Json/XML):
0/VCVpg – The VPG is recovering virtual machines in a VMware vCenter Server.
1/VCvApp – The VPG is recovering a VMware vCenter Server vApp.
2/VCDvApp – The VPG is recovering a VMware vCloud Director vApp.
3/AWS – The VPG is recovering virtual machines in Amazon Web Services (AWS).
4/HyperV – The VPG is recovering virtual machines in Microsoft Hyper-V.
IOPS
The IO per second between all the applications running on the virtual machines in the VPG and the VRAs that sends a copy to the remote site for replication.
LastTest
The date the last failover test occurred. The value can be converted to an understandable date using code similar to the following:
var date = new Date(jsonDate);
or code similar to the Perl code example, jsonDateToString($), in Perl Code Example: Retrieving the First 100 Records
Link
The link details.
href
The URL used.
identifier
The VPG identifier.
rel
The next path level of the API relative to the current path.
type
The API interface service.
Link
The link details.
href
The URL used.
rel
The next path level of the API relative to the current path.
type
The API interface service.
OrganizationName
The name of the organization set up in the Zerto Cloud Manager that uses a cloud service provider for recovery.
Priority
The priority specified for the VPG. Possible values are (Json/XML):
0/Low – The VPG has a low priority for transferring data.
1/Medium – The VPG has a medium priority for transferring data.
2/High – The VPG has a high priority for transferring data.
ProgressPercentage
The percentage of an operation completed on the VPG, such as a bitmap sync or updating the VPG.
ProtectedSite
The protected site details.
href
The URL used.
identifier
The site identifier.
rel
The next path level of the API relative to the current path.
type
The API interface service.
ProvisionedStorageInMB
The storage provisioned for the virtual machine in the recovery site.
RecoverySite
The recovery site details.
href
The URL used.
identifier
The site identifier.
rel
The next path level of the API relative to the current path.
type
The API interface service.
ServiceProfile
The service profile details.
href
The URL used.
identifier
The service profile identifier.
rel
The next path level of the API relative to the current path.
type
The API interface service.
ServiceProfileIdentifier
The identifier of the service profile to use for the VPG when a Zerto Cloud Manager is used.
ServiceProfileName
The service profile name.
SourceSite
The name of the site where the VPG is protected.
Status
The status of the VPG that contains the virtual machine. Possible values are (Json/XML):
0/Initializing– The VPG is being initialized. This includes when a VPG is created, and during the initial sync between sites.
1/MeetingSLA – The VPG is meeting the SLA specification.
2/NotMeetingSLA – The VPG is not meeting the SLA specification for both the journal history and RPO SLA settings, for example during a delta sync or when there is an error.
3/RpoNotMeetingSLA – The VPG is not meeting the SLA specification for the RPO SLA setting.
4/HistoryNotMeetingSLA – The VPG is not meeting the SLA specification for the journal history.
5/FailingOver – The VPG is in a Failover operation.
6/Moving – The VPG is in a Move operation.
7/Deleting – The VPG is being deleted.
8/Recovered – The VPG is recovered.
SubStatus
The substatus of the VPG that contains the virtual machine, for example the VPG is in a bitmap sync. For the description of substatuses, refer to the Zerto Virtual Manager Administration Guide. Possible values are (Json/XML):
0/None
1/InitialSync
2/Creating
3/VolumeInitialSync
4/Sync
5/RecoveryPossible
6/DeltaSync
7/NeedsConfiguration
8/Error
9/EmptyProtectionGroup
 
10/DisconnectedFromPeerNoRecoveryPoints
11/FullSync
12/VolumeDeltaSync
13/VolumeFullSync
14/FailingOverCommitting
15/FailingOverBeforeCommit
16/FailingOverRollingBack
17/Promoting
18/MovingCommitting
19/MovingBeforeCommit
 
20/MovingRollingBack
21/Deleting
22/PendingRemove
23/BitmapSync
24/DisconnectedFromPeer
25/ReplicationPausedUserInitiated
26/ReplicationPausedSystemInitiated
27/RecoveryStorageProfileError
28/Backup
29/RollingBack
30/RecoveryStorageError
31/JournalStorageError
32/VmNotProtectedError
TargetSite
The name of the site where the VPG is recovered.
ThroughputInMb
The MBs for all the applications running on the virtual machines being protected in the VPG.
UsedStorageInMB
The storage used by the virtual machines in the VPG at the recovery site.
VmsCount
The number of virtual machines protected in the VPG.
VpgIdentifier
The internal VPG identifier.
VpgName
The VPG name.
Zorg
The ZORG details.
href
The URL used.
identifier
The ZORG identifier.
rel
The next path level of the API relative to the current path.
type
The API interface service.
Checkpoints
Response values for https://zvm_ip:port/v1/vpgs/{protectionGroupIdentifier}/checkpoints.
Parameter
Description
CheckpointIdentifier
The identifier of the checkpoint.
Tag
The tag when the checkpoint was added manually.
Timestamp
The date and time the checkpoint was written to the journal. The value can be converted to an understandable date using code similar to the following:
var date = new Date(jsonDate);
or code similar to the Perl code example, jsonDateToString($), in Perl Code Example: Retrieving the First 100 Records.
Vss
Whether the checkpoint was added via the ZertoVssAgent or not.
Entity types
Response values for https://zvm_ip:port/v1/vpgs/entitytypes.
Response – Description
Possible entity types – the type of site for the VPG:
VCVpg – The VPG is recovering virtual machines in a VMware vCenter Server.
VCvApp – The VPG is recovering a VMware vCenter Server vApp.
VCDvApp – The VPG is recovering a VMware vCloud Director vApp.
AWS – The VPG is recovering virtual machines in Amazon Web Services (AWS).
HyperV – The VPG is recovering virtual machines in Microsoft Hyper-V.
Failover commit policies
Response values for https://zvm_ip:port/v1/vpgs/failovercommitpolicies.
Response – Description
Possible policies used for a failover:
Rollback – After the seconds specified in the commitValue setting have elapsed, the failover is rolled back.
Commit – After the seconds specified in the commitValue setting have elapsed, the failover continues, committing the virtual machines in the recovery site.
None – The virtual machines in the VPG being failed over remain in the Before Commit state until either they are committed with Commit a failover or rolled back with Roll back a failover.
Failover shutdown policies
Response values for https://zvm_ip:port/v1/vpgs/failovershutdownpolicies.
Response – Description
Possible shutdown polices when failing over a VPG:
None – The protected virtual machines are not shut down before the failover begins.
Shutdown – If VMware Tools or Microsoft Integration Services are available, the virtual machines are shut down gracefully. Otherwise, the failover operation fails.
ForceShutdown – The virtual machines are forcibly shut down even if they cannot be gracefully shut down.
Priorities
Response values for https://zvm_ip:port/v1/vpgs/priorities.
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.
Retention policies
Response values for https://zvm_ip:port/v1/vpgs/retentionpolicies.
Response – Description
Possible VPG retention policies:
StandardDR – The VPG is defined for disaster recovery and not for additional long term recovery via offsite backup.
ExtendedDR – The VPG is defined for both disaster recovery and for additional long term recovery via offsite backup.
Statuses
Response values for https://zvm_ip:port/v1/vpgs/statuses.
Response – Description
Possible statuses of a VPG:
Initializing– The VPG is being initialized. This includes when a VPG is created, and during the initial sync between sites.
MeetingSLA – The VPG is meeting the SLA specification.
NotMeetingSLA – The VPG is not meeting the SLA specification for both the journal history and RPO SLA settings, for example during a delta sync or when there is an error.
RpoNotMeetingSLA – The VPG is not meeting the SLA specification for the RPO SLA setting.
HistoryNotMeetingSLA – The VPG is not meeting the SLA specification for the journal history.
FailingOver – The VPG is in a Failover operation.
Moving – The VPG is in a Move operation.
Deleting – The VPG is being deleted.
Recovered – The VPG is recovered.
Substatuses
Response values for https://zvm_ip:port/v1/vpgs/substatuses.
Response – Description
Possible substatus of a VPG:
None
InitialSync
Creating
VolumeInitialSync
Sync
RecoveryPossible
DeltaSync
NeedsConfiguration
Error
EmptyProtectionGroup
DisconnectedFromPeerNoRecoveryPoints
FullSync
VolumeDeltaSync
VolumeFullSync
FailingOverCommitting
FailingOverBeforeCommit
FailingOverRollingBack
Promoting
MovingCommitting
MovingBeforeCommit
MovingRollingBack
Deleting
PendingRemove
BitmapSync
DisconnectedFromPeer
ReplicationPausedUserInitiated
ReplicationPausedSystemInitiated
RecoveryStorageProfileError
Backup
RollingBack
RecoveryStorageError
JournalStorageError
VmNotProtectedError