Host Diagnostic System Create Diagnostic Partition

Creates a diagnostic partition according to the provided create specification.

On success, this method will create the partition and make the partition the active diagnostic partition if specified. On failure, the diagnostic partition may exist but may not be active if the partition was supposed to be made active.

Required privileges: Host.Config.Storage

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/HostDiagnosticSystem/{moId}/CreateDiagnosticPartition

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 HostDiagnosticSystem/{moId}.

string

release

Required

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

Request Body

CreateDiagnosticPartitionRequestType of type(s) application/json

Required

{
    "spec": {
        "_typeName": "string",
        "storageType": "string",
        "diagnosticType": "string",
        "id": {
            "_typeName": "string",
            "diskName": "string",
            "partition": 0
        },
        "partition": {
            "_typeName": "string",
            "partitionFormat": "string",
            "chs": {
                "_typeName": "string",
                "cylinder": 0,
                "head": 0,
                "sector": 0
            },
            "totalSectors": 0,
            "partition": [
                {
                    "_typeName": "string",
                    "partition": 0,
                    "startSector": 0,
                    "endSector": 0,
                    "type": "string",
                    "guid": "string",
                    "logical": false,
                    "attributes": 0,
                    "partitionAlignment": 0
                }
            ]
        },
        "active": false
    }
}

HostDiagnosticPartitionCreateSpec

spec

Required

The diagnostic create specification is used by the system to create a new diagnostic partition on a SCSI disk.

Authentication

This operation uses the following authentication methods.

Session

Responses

204

No Content

Operation doesn't return any data structure

500

NotSupported: if the host is not an ESX Server.

NotFound: if the specified disk cannot be found.

InvalidArgument: if an invalid storage type is specified or the specified disk is unable to accommodate a new diagnostic partition.

HostConfigFault: on some internal failure while trying to create the diagnostic partition or to activate the diagnostic partition.

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

On This Page

Description

Request

Path Parameters

Request Body

Authentication

Response

204 Response Body

Errors

Host Diagnostic System Operations

POST

Host Diagnostic System Create Diagnostic Partition