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 9.1.0.0 APIs.

Request Body

QueryVirtualDiskGeometryRequestType 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 from which to get geometry information.

datacenter

Optional

If name is a datastore path, the datacenter for that datastore path. Not needed when invoked directly on ESX. If not specified on a call to VirtualCenter, name must be a URL.

Authentication

This operation uses the following authentication methods.

Session

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": {
        "_typeName": "string",
        "faultCause": "MethodFault Object",
        "faultMessage": [
            {
                "_typeName": "string",
                "key": "string",
                "arg": [
                    {
                        "_typeName": "string",
                        "key": "string",
                        "value": {
                            "_typeName": "string"
                        }
                    }
                ],
                "message": "string"
            }
        ]
    },
    "faultMessage": [
        {
            "_typeName": "string",
            "key": "string",
            "arg": [
                {
                    "_typeName": "string",
                    "key": "string",
                    "value": {
                        "_typeName": "string"
                    }
                }
            ],
            "message": "string"
        }
    ]
}

Code Samples

COPY

                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{"name":"string"}' https://{api_host}/sdk/vim25/{release}/VirtualDiskManager/{moId}/QueryVirtualDiskGeometry

On This Page

Description

Request

Path Parameters

Request Body

Authentication

Response

200 Response Body

Errors

Virtual Infrastructure Operations

POST

Virtual Disk Manager Copy Virtual Disk Task