Get Datastore Groups
DescriptionList of replicated datastore groups.
Each datastore group represents a minimal set of datastores that must be protected and recovered together.
The rules for combining datastores are:
- Datastores are backed by storage devices from the same consistency group.
- Virtual machine spans multiple datastores.
- Two virtual machines on two different datastores share an RDM device.
For non-Array-Based Replication protection group, this will return an empty response.
Request
URLURL
Path Parameters
Path Parameters
The ID of a pairing between this Site Recovery Manager server and remote one.
The ID of a protection group defined within current pairing.
Query Parameters
Query Parameters
The filter value by which to filter the result data. Must be used in combination with filter_prop parameter. Supports for nested fields. Example: https://dr-server/api/vms?filter_property=name&filter=vm-1&filter=vm-2
The name of the field by which to filter the result data. Must be used in combination with filter parameter. Supports for nested fields. Example: https://dr-server/api/vms?filter_property=name&filter=vm-1
If you want VMs info, this will lead to slower and bigger API response.
Specify the limit size of the result data. In combination with offset parameter provides paging functionality. If none - configuration property ‘defaultResponsePageSize’ in REST API configuration file is taken into account. If configuration property is not defined - default value of 100 is taken into account.
limit example
"10"
The amount of elements to skip in the response. In combination with limit parameter provides paging functionality. Must be used in combination with limit parameter. If none - default value of 0 is taken into account. Example: https://dr-server/api/vms?limit=10&offset=10
offset example
"10"
Define desired sort order by field of the result data. Must be used in combination with sort_by. Supported values: asc, ascending, desc, descending.
Define desired sort by field of the result data. If order_by is not specified, ascending is used as default.
sort_by example
"name"
Authentication
Response
Response BodyResponse Body
200 OK
A list of datastore groups related to an Array-Based Replication protection group.
{
"_meta": {
"errors": [
{
"code": "string",
"field": "string",
"message": "string"
}
],
"limit": 0,
"links": {
"next": {
"href": "string"
},
"previous": {
"href": "string"
},
"self": {
"href": "string"
}
},
"offset": 0,
"total": 0
},
"list": [
{
"array_pair": "string",
"datastores": [
{
"capacity_details": {
"total_capacity": 0,
"used_space": 0
},
"conflict_protection_group": "string",
"conflict_protection_group_name": "string",
"id": "string",
"issue_type": "NONE",
"name": "string"
}
],
"id": "string",
"potential_vm_to_add_infos": [
{
"datastores": [
"string"
],
"id": "string",
"inside_vapp": false,
"name": "string",
"protection_issues": [
{
"datastore": "string",
"datastore_name": "string",
"device_id": 0,
"disk_key": 0,
"type": "UNKNOWN"
}
],
"protection_status": "PROTECTED",
"template": false
}
],
"protection_groups": [
"string"
],
"rdm_keys": [
{
"id": "string",
"issue_type": "NONE",
"name": "string"
}
],
"status": "UNASSIGNED",
"vm_infos": [
{
"datastores": [
"string"
],
"id": "string",
"inside_vapp": false,
"name": "string",
"protection_issues": [
{
"datastore": "string",
"datastore_name": "string",
"device_id": 0,
"disk_key": 0,
"type": "UNKNOWN"
}
],
"protection_status": "PROTECTED",
"template": false
}
]
}
]
}
Information about a datastore group. Available for Array-Based Replication protection groups.
Errors
Bad request - the server could not understand the request due to invalid syntax or invalid request body content
Unauthorized - the client must authenticate itself to get the requested response
Forbidden - not sufficient access rights to fulfill the request
Not Found - server cannot find the requested in URL resource
Internal server error - unexpected condition prevents fulfilling the request
Code Samples
PowerCLI Client SDK Example
cURL Command
Vendor Extensions
x-dr-permissions:
permissions:
- System.View
- System.Read
x-dr-remote-site-connectivity-contract:
not-authenticated: DEPENDS_ON_PROVIDED_PARAMS
server-down: DEPENDS_ON_PROVIDED_PARAMS
