Unregistering a vSnap server

Unregister a vSnap server from IBM Spectrum Protect Plus.

Warning

This operation permanently deletes all backup instances that are stored on the storage resources of the target vSnap server.

Method and URI

To unregister a vSnap server, use a DELETE method with a URI:

DELETE  https://{hostname|IPv4}/api/storage/{storageId}

Tip

To get a {storageId} value based on its name, follow the instructions in Getting a {storageId}.

Parameters

None.

Data

None.

Example: Unregister a specific vSnap server

Assume that you have a vSnap server, 10.0.1.1 ({storageId 2001}), and you want to delete the vSnap server. Run the following command:

storage_id = "2101"

requests.delete('https://' + spp_ipv4 + '/api/storage/' + storage_id,
    headers={...}, verify=...)
_images/reference_vsnap_delete01.png

Figure 35 The same action can be taken in the IBM Spectrum Protect Plus web user interface: In the navigation pane, click System Configuration > Backup Storage > Disk and click the Delete icon for the target vSnap server.

You will receive a response with the HTTP status of 204 (No Content).