This API has a deprecated equivalent from v7.0U1.
Get Hardware Boot
DescriptionReturns the boot-related settings of a virtual machine.
Request
URLURL
https://{api_host}/api/vcenter/vm/{vm}/hardware/boot
Path Parameters
Path Parameters
string
vm
Required
Virtual machine identifier.
The parameter must be an identifier for the resource type: VirtualMachine.
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, obtained by first calling Create Session API
vmware-api-session-id example
b00db39f948d13ea1e59b4d6fce56389
Response
Response
Response BodyResponse Body
200 OK returns
VmHardwareBootInfo of type application/json
Boot-related settings of the virtual machine.
{
"delay": 0,
"efi_legacy_boot": false,
"enter_setup_mode": false,
"network_protocol": "enum",
"retry": false,
"retry_delay": 0,
"type": "enum"
}
integer
delay
Required
Delay in milliseconds before beginning the firmware boot process when the virtual machine is powered on. This delay may be used to provide a time window for users to connect to the virtual machine console and enter BIOS setup mode.
boolean
enter_setup_mode
Required
Flag indicating whether the firmware boot process will automatically enter setup mode the next time the virtual machine boots. Note that this flag will automatically be reset to false once the virtual machine enters setup mode.
boolean
retry
Required
Flag indicating whether the virtual machine will automatically retry the boot process after a failure.
integer
retry_delay
Required
Delay in milliseconds before retrying the boot process after a failure; applicable only when Boot.Info.retry is true.
type
Required
Firmware type used by the virtual machine.
Possible values are: BIOS , EFI
boolean
efi_legacy_boot
Optional
Flag indicating whether to use EFI legacy boot mode. This field is optional and it is only relevant when the value of Boot.Info.type is EFI.
network_protocol
Optional
Protocol to use when attempting to boot the virtual machine over the network. This field is optional and it is only relevant when the value of Boot.Info.type is EFI.
Possible values are: IPV4 , IPV6
cURL Command
curl -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" https://{api_host}/api/vcenter/vm/{vm}/hardware/boot
Errors
403
com.vmware.vapi.std.errors.unauthorized : if the user doesn't have the required privileges.
500
com.vmware.vapi.std.errors.error : if the system reports an error while responding to the request. | com.vmware.vapi.std.errors.resource_inaccessible : if the virtual machine's configuration state cannot be accessed.
503
com.vmware.vapi.std.errors.service_unavailable : if the system is unable to communicate with a service to complete the request.
Availability
Added in 7.0U2
On This Page
Hardware Boot Operations
patch
