delete_hosts

(DELETE)/hosts/{hostname}

Description

Deletes an entry from /etc/hosts by name.

Request

Syntax

DELETE /api/hosts/{hostName}/?sid={sid}
Host: <server host name>
Accept: application/json
AuthToken: <authentication token returned from authenticate>

Parameters

Name	Description	Required
name	name of the host to remove	Yes
sid	System ID	Optional

Response

Status code, Status string

Parameters

Examples

Sample Request

DELETE /api/hosts/my-win-server/?sid=2
Host: <server host name>
Accept: application/json
AuthToken: 8a00sjerhterqerjlqkjlk443l4j56869h4f_)(fjdkasHHHHHkdal324

Sample Response

200 Success

Failed host deletion from /etc/hosts will return HTTP Status 500 with a result object with an error message and KB link.