Unregistering a virtualized system

Unregister a virtualized system from IBM Spectrum Protect Plus.

Method and URI

To delete a hypervisor server with {hypervisorHypervisorId}, use a DELETE method and a URI:

DELETE  https://{hostname|IP}/api/hypervisor/{hypervisorHypervisorId}

Tip

To get a {hypervisorHypervisorId} based on the hostname or the IPv4 address, follow the instructions in Getting a {hypervisorHypervisorId}.

Parameters

None.

Data

None.

Example: Unregister a vCenter Server

Assume that you have a virtualized system “10.0.0.10”, which is one of the vCenter Servers, and you want to delete it. You get the {hypervisorHypervisorId}: 1003. Run the following command:

hypervisor_hypervisor_id = "1003"

requests.delete('https://' + spp_ipv4 + '/api/hypervisor/'
    + hypervisor_hypervisor_id,
    headers={...}, verify=...)
_images/refmanageprotection_hypervisor_delete01.png

Figure 25 The same action can be taken in the IBM Spectrum Protect Plus web user interface: In the VMware pane, click the Manage vCenter, click the vCenter Server you want to delete and click the Delete icon. You can delete Hyper-V Server and Amazon EC2 account in a similar way.

After you run the Python snippet, ensure that you get a response with the HTTP status of 204 (No Content) and that you no longer see the VMwrae vCenter Server 10.0.010. The response body is empty.