Open topic with navigation

# Deprovision cloud hosts

Available in versions: 12.56 and later

## Description

Terminates a host provisioned on the cloud.

## URL

    /Admin/rest/v1/cloud/hosts/{hostID}

## Remarks

Only Amazon EC2 is supported for provisioning cloud hosts using the REST API.

## HTTP Method

DELETE: Frees up the cloud host.

## Request

Headers:

Content-Type: application/xml

Accept: application/xml

Cookies:

Version 2020 (or later) | LWSSO_COOKIE_KEY={LwssoCookie};
Versions earlier than 2020 | LWSSO_COOKIE_KEY={LwssoCookie};QCSession={QCSessionCookie};

Request Body:

DELETE: No request body.

Request Example

    DELETE http://<LRE_Server>/Admin/rest/v1/cloud/hosts/1057 HTTP/1.1
    Host: PCServer
    Cookie: LWSSO_COOKIE_KEY={LwssoCookie};

## Response

Headers:

Content-Type: application/xml

Cookies:

None

HTML Return Code:

One of the HTTP Return Codes

Upon successful deletion, returns HTTP status 200 (OK).

The termination operation is performed asynchronously. You can monitor the termination status using the URL provided in the response Location header. For details, see Provision host response for the response example.

HTML Body:

DELETE: No body returned

## See Also

Provision cloud hosts
Get provision request
Get all provision requests
Get all cloud hosts
Audit cloud hosts