Create new hosts under the tenant.
Requires "Create" permission.
If a Host already exists with the specified HostID, an HTTP 303 See Other
status will be returned with a Location
header pointing to the existing Host object's API path.
In future versions, the successful return status may be changed to 201
response with a Location:
header of the newly-created object's URL.
If the HTTP Body is invalid JSON, the Body is empty, or Content-Type
is not specified or specified as a different MIME type, then an HTTP 415 Unsupported Media Type
status response will be returned.
If the HTTP Body fails data validation (e.g. does not include a name
or target
), an HTTP 422 Unprocessable Content
status response will be returned. No explicit/static error is defined for this condition, as the output will vary depending on what actual validation failed. It will, however, always be in the form of {"error": "<error message>"}
.