[{"label":"Latest (1.0.0)","version":"latest"}]
vsphere-replication-api

Get Seeds For Disks

Description

Retrieve information about possible seeds for a given set of disks

Request

Request

URL

URL


post
https://{api_host}//pairings/{pairing_id}/vcenters/{vcenter_id}/datastores/{datastore_id}/actions/find-seeds
Copy

Path Parameters

Path Parameters

string
pairing_id Required

The ID of the pairing between this vSphere Replication server and the remote one.


string
vcenter_id Required

The ID of the vCenter server


string
datastore_id Required

The ID of a datastore


Request Body

Request Body

array of VmDiskFindSeedSpec of mimetype application/json Required

List of specs to search for VM disks’ seeds.

{
	"vm_disk": {
		"vm_id": "VirtualMachine:vm-80:e594ad24-5f75-41e3-a276-88a2116dbed0"
	}
}
vm_disk Required

Uniquely identifies VM disk


string
destination_path Optional

Disk destination path.


boolean
use_wildcard Optional

Use wildcard.

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns VmDiskSeedInformationDrResponseList of type application/json

Information about the possible seeds

{
	"_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": [
		{
			"found_seeds": [
				"string"
			],
			"vm_disk": {
				"device_key": 0,
				"vm_id": "VirtualMachine:vm-80:e594ad24-5f75-41e3-a276-88a2116dbed0"
			}
		}
	]
}
_meta Optional

List metadata


list Optional

Information about seeds found for a disk

Errors

Errors

ResponseError
400

Bad request - the server could not understand the request due to invalid syntax or invalid request body content


401

Unauthorized - the client must authenticate itself to get the requested response


ResponseError
403

Forbidden - not sufficient access rights to fulfill the request


404

Not Found - server cannot find the requested in URL resource


ResponseError
500

Internal server error - unexpected condition prevents fulfilling the request

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '[{"destination_path":"string","use_wildcard":false,"vm_disk":{"device_key":0,"vm_id":"VirtualMachine:vm-80:e594ad24-5f75-41e3-a276-88a2116dbed0"}}]' https://{api_host}/pairings/{pairing_id}/vcenters/{vcenter_id}/datastores/{datastore_id}/actions/find-seeds
Vendor Extensions

Vendor Extensions

This operation contains the following vendor extensions defined in the spec:
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


Feedback

Was this page helpful?