Vslm V Storage Object Manager Vslm Create Disk Task

Create a virtual disk, which is a storage object with disk as consumption type.

Requires Datastore.FileManagement privilege on the datastore where the virtual disk object is created.

VslmSyncFault will set in the task error if the createDisk completed successfully in the backed but the datastore synchronization or FCD retrieval failed. The sync fault can be ignored with the risk of Pandora not recognizing the FCD or Pandora DB missing the FCD, consequently, affecting the return of VslmListVStorageObjectForSpec and VslmRetrieveVStorageObjects APIs.

Required privileges: System.View

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/vslm/VslmVStorageObjectManager/{moId}/VslmCreateDisk_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 VslmVStorageObjectManager/{moId}.

string

release

Required

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

Request Body

VslmCreateDiskRequestType of type(s) application/json

Required

Show optional properties

{
    "spec": {
        "name": "string",
        "backingSpec": {
            "datastore": {}
        },
        "capacityInMB": 0
    }
}

{
    "spec": {
        "_typeName": "string",
        "name": "string",
        "keepAfterDeleteVm": false,
        "backingSpec": {
            "_typeName": "string",
            "datastore": {
                "_typeName": "string",
                "type": "string",
                "value": "string"
            },
            "path": "string"
        },
        "capacityInMB": 0,
        "profile": [
            {
                "_typeName": "string"
            }
        ],
        "crypto": {
            "_typeName": "string"
        },
        "metadata": [
            {
                "_typeName": "string",
                "key": "string",
                "value": "string"
            }
        ]
    }
}

VslmCreateSpec

spec

Required

Specification to create a virtual storage object.

Authentication

This operation uses the following authentication methods.

Session

Responses

200

This method returns a Task object with which to monitor monitor the operation. The info.result property in the Task contains the newly created VStorageObject upon success.

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 when creating the virtual disk.

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

VslmFault: If a VSLM internal server error occurred.

Returns MethodFault of type(s) application/json

This response body class contains all of the following: Any

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

MethodFault

faultCause

Optional

The base data object type for all the object model faults that an application might handle.

array of LocalizableMessage

faultMessage

Optional

Message which has details about the error Message can also contain a key to message catalog which can be used to generate better localized messages.

On This Page

Description

Request

Path Parameters