Product Documentation

Deleting a NetScaler Resource

Sep 01, 2016

The usage of the delete operation depends on the unique identifiers (UIDs) of the resource being deleted.

Deleting Resource with Single UID

To delete a NetScaler resource that can be identified by a single identifier, specify the resource name in the URL.

For example, to delete a load balancing virtual server named MyFirstLbVServer:

  • Request:

    HTTP Method
    DELETE
    URL
    http://<netscaler-ip-address>/nitro/v1/config/lbvserver/MyFirstLbVServer
    Request Header
    Cookie:NITRO_AUTH_TOKEN=<tokenvalue>
    
  • Response:

    HTTP Status Code on Success
    200 OK
    HTTP Status Code on Failure
    4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error.

Deleting Resource with Multiple UIDs

To delete a NetScaler resource that is identified using multiple identifiers, use the "args" query parameter to specify the unique attributes along with their values.

For example, consider a SNIP (10.102.29.71) that belongs to two traffic domains (TDs) 123 and 110. To delete the SNIP from one of the traffic domains, specify the IP address and the relevant TD in the URL as follows:

  • Request:

    HTTP Method
    DELETE
    URL
    http://<netscaler-ip-address>/nitro/v1/config/nsip?args=ipaddress:10.102.29.71,td:123
    Request Header
    Cookie:NITRO_AUTH_TOKEN=<tokenvalue>
    
  • Response:

    HTTP Status Code on Success
    200 OK
    HTTP Status Code on Failure
    4xx <string> (for general HTTP errors) or 5xx <string> (for NetScaler-specific errors). The response payload provides details of the error.