Host Nvdimm System Create Nvdimm Namespace Task

Host Nvdimm System Create Nvdimm Namespace Task

Deprecated as of vSphere 6.7u1, use createPMemNamespace Create nvd namespace from information passed in NamespaceCreationSpec.

A new block or persistent namespace can be created on the NVDIMM(s) when the system is in maintenance mode.

If all the parameters passed are valid and system is in maintenance mode, then a DSM (Device Specific Method) call is made to create the namespace. DSM calls are blockable and slow operations and hence the use of task.

If a new namespace is created, its UUID is returned.

Required privileges: Host.Config.Nvdimm

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

string
release
Required

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


Request Body
CreateNvdimmNamespaceRequestType of type(s) application/json
Required
{
    "createSpec": {
        "_typeName": "string",
        "friendlyName": "string",
        "blockSize": 0,
        "blockCount": 0,
        "type": "string",
        "locationID": 0
    }
}
createSpec
Required

Deprecated as of vSphere 6.7u1, use PMemNamespaceCreateReq.

Arguments for creating a namespace.

Authentication
This operation uses the following authentication methods.
Responses
200

This method returns a Task object which is used to monitor this operation. The task result (info.result) contains a NvdimmGuid object that has the UUID of the newly created namespace.

Returns MoRefTask of type(s) application/json
This response body class contains all of the following: MoRefExtensibleManagedObject
{
    "_typeName": "string",
    "type": "string",
    "value": "string"
}

500

InvalidArgument: if an argument to create namespace is invalid.

NotSupported: if no NVDIMMs are found, namespace type is not supported or if operation does not have DSM method.

InvalidHostState: if operation is not allowed as system is not in maintenance mode.

AlreadyExists: if the namespace of type already exists.

SystemError: for other system errors along with localized reason for failure.

HostConfigFault: for any other failure.

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