Vcenter V Storage Object Manager Query Virtual Disk Uuid Ex

Get the virtual disk UUID.

The datacenter parameter may be omitted if a URL is used to name the disk. A URL has the form

scheme://authority/folder/path?dcPath=dcPath&dsName=dsName

where

scheme is http or https.
authority specifies the hostname or IP address of the VirtualCenter or ESX server and optionally the port.
dcPath is the inventory path to the Datacenter containing the Datastore.
dsName is the name of the Datastore.
path is a slash-delimited path from the root of the datastore.

Since: vSphere API Release 8.0.3.0

Required privileges: System.View

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/VcenterVStorageObjectManager/{moId}/QueryVirtualDiskUuidEx

COPY

Path Parameters

string

moId

Required

The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId, in this case VcenterVStorageObjectManager/{moId}.

string

release

Required

The vSphere release schema. The current specification covers vSphere 8.0.3.0 APIs.

Request Body

QueryVirtualDiskUuidExRequestType of type(s) application/json

Required

Show optional properties

{
    "name": "string"
}

{
    "name": "string",
    "datacenter": {
        "_typeName": "string",
        "type": "string",
        "value": "string"
    }
}

string

name

Required

The name of the disk, either a datastore path or a URL referring to the virtual disk whose uuid for the DDB entry needs to be queried. A datastore path has the form

[datastore] path

where

datastore is the datastore name.
path is a slash-delimited path from the root of the datastore.

An example datastore path is "[storage] path/to/file.extension".

MoRefDatacenter

datacenter

Optional

Reference to an instance of the Datacenter managed object.

Authentication

This operation uses the following authentication methods.

Session

Responses

200

The hex representation of the unique ID for this virtual disk.

Returns string of type(s) application/json

Operation doesn't return any data structure

500

FileFault: if an error occurs reading the virtual disk.

InvalidDatastore: if the operation cannot be performed on the datastore.

Returns VimFault of type(s) application/json

This response body class contains all of the following: MethodFault

{
    "_typeName": "string",
    "faultCause": "MethodFault Object",
    "faultMessage": [
        {
            "_typeName": "string",
            "key": "string",
            "arg": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "value": {
                        "_typeName": "string"
                    }
                }
            ],
            "message": "string"
        }
    ]
}

Availability

Added in vSphere API Release 8.0.3.0

On This Page

Description

Request

Path Parameters

Request Body

Authentication

Response

200 Response Body

Errors

Virtual Infrastructure Operations