This API has a deprecated equivalent from v7.0U1.
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
https://{api_host}/api/vcenter/host
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, obtained by first calling Create Session API
Request Body
Request Body
HostCreateSpec of mimetype application/json
Required
Specification for the new host to be created. The Host.CreateSpec structure defines the information used to create a host.
(The request body parameter is missing description)
{
"folder": "string",
"hostname": "string",
"password": "string",
"thumbprint_verification": "enum",
"user_name": "string"
}
string
folder
Required
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.
string
user_name
Required
The administrator account on the host.
string
hostname
Required
The IP address or DNS resolvable name of the host.
string
password
Required
The password for the administrator account on the host.
thumbprint_verification
Required
Type of host’s SSL certificate verification to be done.
Possible values are: NONE , THUMBPRINT
integer
port
Optional
The port of the host. If unset, port 443 will be used.
string
thumbprint
Optional
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.
boolean
force_add
Optional
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
Response BodyResponse Body
201 Created returns
string of type application/json
The newly created identifier of the host in vCenter. The result will be an identifier for the resource type: HostSystem.
cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" -d '{"folder":"string","force_add":false,"hostname":"string","password":"string","port":0,"thumbprint":"string","thumbprint_verification":"enum","user_name":"string"}' https://{api_host}/api/vcenter/host
Errors
400
com.vmware.vapi.std.errors.already_exists : if the host with the same name is already present. | com.vmware.vapi.std.errors.invalid_argument : if the host name is invalid.
if the host folder is invalid.
if the SSL thumbprint specified is invalid. | com.vmware.vapi.std.errors.invalid_element_type : if the host folder id does not support vSphere compute resource as its children type. | com.vmware.vapi.std.errors.resource_in_use : if the host is already being managed by another vCenter Server | com.vmware.vapi.std.errors.unsupported : if the software version on the host is not supported.
401
com.vmware.vapi.std.errors.unauthenticated : if the user name or password for the administration account on the host are invalid.
if the user can not be authenticated.
403
com.vmware.vapi.std.errors.unauthorized : if the user doesn't have the required privileges.
404
com.vmware.vapi.std.errors.not_found : if there is no folder associated with the Host.CreateSpec.folder field in the system.
500
com.vmware.vapi.std.errors.error : if installation of VirtualCenter agent on a host fails.
if the system reports an error while responding to the request. | com.vmware.vapi.std.errors.unable_to_allocate_resource : if there are not enough licenses to add the host.
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
