Create Host
Add a new standalone host in the vCenter inventory. The newly connected host will be in connected state. The vCenter Server will verify the SSL certificate before adding the host to its inventory. In the case where the SSL certificate cannot be verified because the Certificate Authority is not recognized or the certificate is self signed, the vCenter Server will fall back to thumbprint verification mode as defined by Host.CreateSpec.ThumbprintVerification.
Request
URLURL
Header Parameters
Header Parameters
Request Body
Specification for the new host to be created. The Host.CreateSpec structure defines the information used to create a host.
{
"folder": "string",
"hostname": "string",
"password": "string",
"thumbprint_verification": "enum",
"user_name": "string"
}
Host and cluster folder in which the new standalone host should be created. This field is currently required. In the future, if this field is unset, the system will attempt to choose a suitable folder for the host; if a folder cannot be chosen, the host creation operation will fail. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: Folder. When operations return a value of this structure as a result, the field will be an identifier for the resource type: Folder.
The administrator account on the host.
The IP address or DNS resolvable name of the host.
The password for the administrator account on the host.
Type of host’s SSL certificate verification to be done.
Possible values are: NONE , THUMBPRINT
The port of the host. If unset, port 443 will be used.
The thumbprint of the SSL certificate, which the host is expected to have. The thumbprint is always computed using the SHA1 hash and is the string representation of that hash in the format: xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx where, ‘x’ represents a hexadecimal digit. This field is optional and it is only relevant when the value of Host.CreateSpec.thumbprint-verification is THUMBPRINT.
Whether host should be added to the vCenter Server even if it is being managed by another vCenter Server. The original vCenterServer loses connection to the host. If unset, forceAdd is default to false.
Response
Response BodyResponse Body
The newly created identifier of the host in vCenter. The result will be an identifier for the resource type: HostSystem.