Host Boot Device System Query Boot Devices

Retrieves a list of the available boot devices for the host system.

Required privileges: System.Read

Request

URI

POST

https://{vcenter-host}/sdk/vim25/{release}/HostBootDeviceSystem/{moId}/QueryBootDevices

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

string

release

Required

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

Authentication

This operation uses the following authentication methods.

Session

Responses

200

The boot device information for the host. The returned object has a list of HostBootDevice data objects; each boot device object defines a description and a key to identify the device. The order of devices in the list is unpredictable. The returned HostBootDeviceInfo data object also contains the key of the current boot device.

Returns HostBootDeviceInfo of type(s) application/json

This response body class contains all of the following: DataObject

{
    "_typeName": "string",
    "bootDevices": [
        {
            "_typeName": "string",
            "key": "string",
            "description": "string"
        }
    ],
    "currentBootDeviceKey": "string"
}

array of HostBootDevice

bootDevices

Optional

The list of boot devices present on the host

string

currentBootDeviceKey

Optional

The key of the current boot device that the host is configured to boot.

This property is unset if the current boot device is disabled.

On This Page

Description

Request