Virtual Disk Manager Query Virtual Disk Geometry

Virtual Disk Manager Query Virtual Disk Geometry

Get the disk geometry information for the virtual disk.

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

Requires Datastore.FileManagement privilege on the datastore where the virtual disk resides.

Required privileges: System.View

Request
URI
POST
https://{vcenter-host}/sdk/vim25/{release}/VirtualDiskManager/{moId}/QueryVirtualDiskGeometry
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 VirtualDiskManager/{moId}.

string
release
Required

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


Request Body
QueryVirtualDiskGeometryRequestType of type(s) application/json
Required
{
    "name": "string",
    "datacenter": {
        "type": "string",
        "value": "string"
    }
}
string
name
Required

The name of the disk, either a datastore path or a URL referring to the virtual disk from which to get geometry information.

datacenter
Optional

Reference to an instance of the Datacenter managed object.

Authentication
This operation uses the following authentication methods.
Responses
200

The geometry information for this virtual disk.

Returns HostDiskDimensionsChs of type(s) application/json
This response body class contains all of the following: DataObject
{
    "_typeName": "string",
    "cylinder": 0,
    "head": 0,
    "sector": 0
}
integer As int64 As int64
cylinder
Required

The number of cylinders.

integer As int32 As int32
head
Required

The number of heads per cylinders.

integer As int32 As int32
sector
Required

The number of sectors per head.


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"
        }
    ]
}