create hostalias
/hosts/{hostname}/hostaliases [POST]
API Support | Available since | Last updated | Output |
---|---|---|---|
5.8900 | 5.9500 | xml, json |
Description
Create an alias to an existing host.
The host must exist before an alias can be created.
To create a host use the /hosts [POST] service.
Parameters
Name | Description | Required | Type | Default value |
---|---|---|---|---|
name | The name of the host alias | yes | string |
Permission
This service requires administrator.
Response
If successful, the created alias is returned as an <alias>
element wrapped in an <alias-creation>
element as in the following example:
<alias-creation> <alias id="2" name="www.acme.com" /> </alias-creation>
Error Handling
No specific errors expected for this service.