Vcenter V Storage Object Manager Set Virtual Disk Uuid Ex Task

Set the virtual disk Uuid.

Requires Datastore.FileManagement privilege on the datastore where virtualDisk is present. 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}/SetVirtualDiskUuidEx_Task

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

Request Body

SetVirtualDiskUuidExRequestType of type(s) application/json

Required

Show optional properties

{
    "name": "string"
}

{
    "name": "string",
    "datacenter": {
        "_typeName": "string",
        "type": "string",
        "value": "string"
    },
    "uuid": "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 set. 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".

datacenter

Optional

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

string

uuid

Optional

The hex representation of the unique ID for this virtual disk. If uuid is not set or missing, a random UUID is generated and assigned.

Authentication

This operation uses the following authentication methods.

Session

Responses

200

Returns MoRefTask of type(s) application/json

This response body class contains all of the following: MoRefExtensibleManagedObject

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

500

FileFault: if an error occurs updating 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}/VcenterVStorageObjectManager/{moId}/SetVirtualDiskUuidEx_Task

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