The following REST APIs are available with Site Recovery Manager 8.6.
Site Recovery Manager Authentication APIs
| Category | Operation Type | REST API Name | Description |
|---|---|---|---|
| Authentication | GET | Get Current Session | Returns information about the current session, if any. |
| Authentication | POST | Login | Logs in and returns the session ID. In the subsequent requests, include the ‘x-dr-session’ header with the returned session ID value. |
| Authentication | DELETE | Logout | Logs out if the session is authenticated. |
Site Recovery Manager Inventory Mappings REST APIs
| Category | Operation Type | REST API Name | Description |
|---|---|---|---|
| Inventory Mappings | POST | Create Folder Mapping | Add folder mappings for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | POST | Create Network Mapping | Add network mappings for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | POST | Create Placeholder Datastores | Add placeholder datastores for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | POST | Create Resource Mapping | Add resource mappings for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | POST | Create Storage Policy Mapping | Add storage policy mappings for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | POST | Create Test Network Mappings | Add test network mappings for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | DELETE | Delete Folder Mapping | Delete a configured folder mapping for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | DELETE | Delete Network Mapping | Delete a configured network mapping for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | DELETE | Delete Placeholder Datastores | Delete a configured placeholder datastore for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | DELETE | Delete Resource Mapping | Delete a configured resource mapping for a Site Recovery Manager in a given pairing |
| Inventory Mappings | DELETE | Delete Storage Policy Mapping | Delete a configured storage policy mapping for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | DELETE | Delete Test Network Mappings | Delete a configured test network mappings for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | GET | Get Folder Mapping | Get details about a configured folder mapping for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | GET | Get Folder Mappings | Get currently configured folder mappings for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | GET | Get Network IP Subnet Mapping | Get details about a configured IP subnet mapping for a network mapping. |
| Inventory Mappings | GET | Get Network Mapping | Get details about a configured network mapping for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | GET | Get Network Mappings | Get currently configured network mappings for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | GET | Get Placeholder Datastore | Get details about a configured placeholder datastore for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | GET | Get Placeholder Datastores | Get currently configured placeholder datastores for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | GET | Get Resource Mapping | Get details about a configured resource mapping for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | GET | Get Resource Mappings | Get currently configured resource mappings for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | GET | Get Storage Policy Mapping | Get details about a configured storage policy mapping for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | GET | Get Storage Policy Mappings | Get currently configured storage policy mappings for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | GET | Get Test Network Mapping | Get details about a configured test network mappings for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | GET | Get Test Network Mappings | Get currently configured test network mappings for a Site Recovery Manager in a given pairing. |
| Inventory Mappings | POST | Query Suitable Datastores | Query for suitable datastores to be used as placeholder datastores. |
| Inventory Mappings | DELETE | Remove Network IP Subnet Mapping | Delete configured IP subnet mapping for a network mapping. |
| Inventory Mappings | PUT | Update Network IP Subnet Mapping | Create or update IP subnet mapping for a network mapping. |
Site Recovery Manager Site Pairing REST APIs
| Category | Operation Type | REST API Name | Description |
|---|---|---|---|
| Pairing | POST | Create Remote Session | Creates session to remote Site Recovery Manager server. |
| Pairing | GET | Get Pairing | Get information about the pairing. |
| Pairing | GET | Get Pairing Issues | Get all issues for the pairing. |
| Pairing | GET | Get Pairings | Get a list of all existing pairings. |
| Pairing | GET | Get Remote Session | Returns information about the current session to the remote Site Recovery Manager server, if any. |
| Pairing | GET | Get SRM | Get information about a Site Recovery Manager server, which is part of a given pairing. |
| Pairing | GET | Get SRM Issues | Get a list of all Site Recovery Manager server issues for a given Site Recovery Manager server. |
| Pairing | GET | Get SRMs | Get a list of all Site Recovery Manager servers in the pairing. |
Site Recovery Manager Protection REST APIs
| Category | Operation Type | REST API Name | Description |
|---|---|---|---|
| Protection | POST | Add Datastore Group | Add a replicated datastore group to a protection group in a given pairing. |
| Protection | POST | Configure All | Configure protection for all virtual machines, which are part of the protection group in a given pairing. |
| Protection | POST | Create Group | Create a new protection group in a given pairing. |
| Protection | DELETE | Delete Group | Delete a protection group in a given pairing. |
| Protection | GET | Get All Groups | Get information about all protection groups in a given pairing. |
| Protection | GET | Get Datastore Group | Get details about a replicated datastore group for a protection group in a given pairing. |
| Protection | GET | Get Datastore Groups | Get a list of replicated datastore groups for a protection group in a given pairing. |
| Protection | GET | Get Group | Get information about a protection group in a given pairing. |
| Protection | GET | Get Group Issues | Get issues about a protection group in a given pairing. |
| Protection | GET | Get Group Related Recovery Plans | Get recovery plans of which the protection group is part of. |
| Protection | GET | Get Group VM | Get details about a protected virtual machine that is part of a protection group in a given pairing. |
| Protection | GET | Get Group VMS | Get a list of virtual machines that are part of a protection group in a given pairing. |
| Protection | GET | Get VM Protection Settings | Get details about the current protection settings of a virtual machine. |
| Protection | GET | Get vVol Replication Group | Get information about the source Virtual Volumes replication group for a protection group in a given pairing. |
| Protection | GET | Get vVol Replication Groups | Get the source Virtual Volumes replication groups for a protection group in a given pairing. |
| Protection | POST | Reconfigure Group | Reconfigure settings for a protection group in a given pairing. |
| Protection | DELETE | Remove Datastore Group | Remove a replicated datastore group from a protection group in a given pairing. |
| Protection | POST | Remove VM From Protection Group | Remove a virtual machine from a vSphere Replication protection group in a given pairing. |
| Protection | POST | Remove VM Protection | Remove the protection of a virtual machine within a protection group in a given pairing. |
| Protection | POST | Restore All Placeholders | Repair all placeholder virtual machines that are part of the protection group in a given pairing. |
| Protection | PUT | Update VM Protection Settings | Update the protection settings of a virtual machine. |
Site Recovery Manager Recovery REST APIs
| Category | Operation Type | REST API Name | Description |
|---|---|---|---|
| Recovery | POST | Cancel Recovery Plan | Cancels a running recovery task. |
| Recovery | POST | Create Plan | Create a new recovery plan in a given pairing. |
| Recovery | DELETE | Delete recovery Plan | Delete a recovery plan from a given pairing. |
| Recovery | GET | Get All Plan History Records | Get a list of all history reports for recovery runs in a given timeframe in a given pairing. |
| Recovery | GET | Get All Recovery Plans | Get a list of all recovery plans in a given pairing. |
| Recovery | GET | Get Plan History Record | Get information about the history report for a recovery run of a recovery plan in a given pairing. |
| Recovery | GET | Get Plan History Records | Get a list of all history reports for recovery runs in a given timeframe of a recovery plan in a given pairing. |
| Recovery | GET | Get Plan Related Protection Groups | Get protection groups that are part of a recovery plan in a given pairing. |
| Recovery | GET | Get Plan Related Test Networks | Get the test networks configured for a recovery plan in a given pairing. |
| Recovery | GET | Get Plan Virtual Machine | Get the protected virtual machine included in a recovery plan in a given pairing. |
| Recovery | GET | Get Plan Virtual Machine Dependent VMS | Get the dependent VMs for a protected virtual machine. |
| Recovery | GET | Get Plan Virtual Machine IP Customization | Get the IP customization for a protected virtual machine. |
| Recovery | GET | Get Plan Virtual Machine Recovery Priority | Get the protected virtual machine priority during a recovery. |
| Recovery | GET | Get Plan Virtual Machine Recovery Settings | Get recovery settings for a protected virtual machine. |
| Recovery | GET | Get Plan Virtual Machine Summarized Recovery Settings | Get a summary of the recovery settings for a protected virtual machine. |
| Recovery | GET | Get Plan Virtual Machines | Get virtual machines that are part of a recovery plan in a given pairing. |
| Recovery | GET | Get Recovery Plan | Get information about a recovery plan in a given pairing. |
| Recovery | GET | Get Recovery Plan Issues | Get issues about a recovery plan in a given pairing. |
| Recovery | POST | Plan Virtual Machine Check Dependent VMS | Checks if a given list of dependent VMs is valid against the current VM. |
| Recovery | POST | Reconfigure Recovery Plan | Reconfigure settings for a recovery in a given pairing. |
| Recovery | POST | Run Cleanup Test Recovery | Run a cleanup after a test recovery for a recovery plan in a given pairing. |
| Recovery | POST | Run Recovey | Run the recovery for a recovery plan in a given pairing. |
| Recovery | POST | Run Reprotect | Run the reprotect operation after a successful recovery for a recovery plan in a given pairing. |
| Recovery | POST | Run Test Recovery | Run a test recovery for a recovery plan in a given pairing. |
| Recovery | POST | Update Plan Virtual Machine Dependent VMS | Update the dependent VMs of a protected virtual machine. |
| Recovery | POST | Update Plan Virtual Machine IP Customization | Update the IP customization for a protected virtual machine. |
| Recovery | PUT | Update Plan Virtual Machine Recovery Priority | Update the recovery priority of a protected virtual machine. |
| Recovery | POST | Update Plan Virtual Machine Recovery Settings | Update recovery settings for a protected virtual machine. |
Site Recovery Manager Replication REST APIs
| Category | Operation Type | REST API Name | Description |
|---|---|---|---|
| Replication | GET | Get All vVol Fault Domain Replication Groups | Get information about all replication groups that are part of a VMware vSphere Virtual Volumes fault domain. |
| Replication | GET | Get All vVol Fault Domains | Get information about all VMware vSphere Virtual Volumes fault domains that are part of a given pairing. |
| Replication | GET | Get Replicated Array Pair | Get information about a replicated array pair that is part of a given pairing. |
| Replication | GET | Get Replicated Array Pairs | Get information about replicated array pairs that are part of a given pairing. |
| Replication | GET | Get vVol Fault Domain | Get details about a VMware vSphere Virtual Volumes fault domain that is part of a given pairing. |
| Replication | GET | Get vVol Fault Domain Replication Group | Get information about a replication group that is part of a VMware Virtual Volumes fault domain. |
| Replication | POST | Retrieve Unassigned Datastore Groups | Retrieve the unassigned datastore groups that are part of a replicated array pair. These datastore groups could be included in the Array-Based Replication protection groups. |
Site Recovery Manager Server REST APIs
| Category | Operation Type | REST API Name | Description |
|---|---|---|---|
| Server | GET | Get Info | Information about the current Site Recovery Manager server. |
Site Recovery Manager Tasks REST APIs
| Tasks | GET | Get Recent Tasks Info | Retrieve all the recent tasks. |
| Tasks | GET | Get Task Info | Retrieve the task information. |
Site Recovery Manager vCenter Related REST APIs
| Category | Operation Type | REST API Name | Description |
|---|---|---|---|
| vCenter | GET | Get Replicated VMS | Get a list of VMs replicated by vSphere Replication in a given vCenter Server. |
| vCenter | GET | Get VC Storage Policies | Retrieve the storage policies of the vCenter Server. |
| vCenter | GET | Get VC Storage Policy | Get information about the storage policy objects of the vCenter Server. |
| vCenter | GET | Get vCenter | Get information about a vCenter Server that is part of a given pairing. |
| vCenter | GET | Get vCenters | Get a list of all vCenter Server instances in the pairing. |
| vCenter | GET | Get vCenter Compute Inventory | Get information about the compute inventory of the vCenter Server. |
| vCenter | GET | Get vCenter Compute Item | Get information about the compute object of the vCenter Server. |
| vCenter | GET | Get vCenter Datastore Item | Get information about the datastore object of the vCenter Server. |
| vCenter | GET | Get vCenter Datastores | Get information about the datastores of the vCenter Server. |
| vCenter | GET | Get vCenter Network Inventory | Get information about the network inventory of the vCenter Server. |
| vCenter | GET | Get vCenter Network Item | Get information about the network object of the vCenter Server. |
| vCenter | GET | Get vCenter VM Folder | Get information about the VM folder object of the vCenter Server. |
| vCenter | GET | Get vCenter VM Folder Inventory | Get information about the VM folder inventory of the vCenter Server. |
