Sign in
latestOpenAPI 3.0.1CISCO SAMPLE CODE LICENSEraw.githubusercontent.com2026-08-108613.3 KB

dd322ba65a09

jobs

Create a new ESXi Installation job.

Take installation details as json payload and create installation job per each host in 'hosts' list.<br> Mandatory (minimal) input data parameters:

  • iso_image
  • root_pwd
  • host_netmask
  • host_gateway
  • installmethod
  • hosts list
    • if installmethod is "pxeboot" at least one entry with {hostname, host_ip, macaddr}
    • if installmethod is "cimc" one entry with {hostname, host_ip, cimc_ip}

In addition, if installmethod is set to "cimc" then "cimc_pwd" is required. cimc_usr defaults to "admin" if not supplied.

Refer to schema definition for all parameters and default values.

post/jobs

Request body

iso_imagestring required
root_pwdstring password required
vlaninteger
vmnicinteger
firstdisk'firstdiskfound' | 'firstdisk' | 'diskpath'
firstdisktype'local' | 'remote' | 'usb'
diskpathstring
enablesshboolean
clearpartboolean
installmethod'pxeboot' | 'cimc' required
cimc_usrstring
cimc_pwdstring password
host_netmaskstring required
host_gatewaystring required
dns1string
dns2string

Example request

{
  "iso_image": "VMware-ESXi-7.0.0_U2-16324942-Custom",
  "diskpath": "naa.6d09466044143600247aee55ca2a6405",
  "host_netmask": "255.255.255.0",
  "host_gateway": "192.168.2.1",
  "dns1": "208.67.222.222",
  "dns2": "207.67.220.220",
  "static_routes": [
    {
      "subnet_ip": "172.16.10.0",
      "cidr": 24,
      "gateway": "192.168.0.251"
    }
  ],
  "hosts": [
    {
      "hostname": "esxi-01-hostname",
      "host_ip": "192.168.2.11",
      "macaddr": "aa:bb:cc:dd:ee:ff",
      "cimc_ip": "192.168.0.111"
    }
  ]
}

Response

Successful operation - return list of job IDs

string[] required

List of job IDs

Example response

[
  "192.168.0.1_1628871425.1136827",
  "192.168.0.2_1633093658.6881468"
]