Retrieve Vshield Endpoint Service Status On An Esx Host; Uninstalling The Vshield Endpoint Service From An Esx Host; Unregister An Svm From Vshield Endpoint - VMware VSHIELD APP 1.0 - API Programming Manual

Retrieve vShield Endpoint Service Status on an ESX Host

You must specify the host ID of the ESX host.
Example 7-3. Retrieving vShield Endpoint Service Status from an ESX Host
Request:
GET <vshieldmanager-uri>/api/1.0/endpointsecurity/host/<hostId>
Example:
GET /api/1.0/endpointsecurity/host/host-1234 HTTP/1.1
host: 10.112.199.123:80
Authorization: Basic YWRtaW46ZGVmYXVsdA==
Response:
HTTP 200 OK
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<VShieldEndpointSecurity>
<lkmStatus>installed|notInstalled|badEsxVersion</lkmStatus>
</VShieldEndpointSecurity>
HTTP 401 Unauthorized : The username or password sent in Authorization header is wrong.
HTTP 404 Not Found : If the hostId is missing in the URI.
HTTP 400 Bad Request : Internal error codes. Please refer the Error Schema for more details.
40002=Acquiring 1. data from VC failed for <>
40017=hostId is malformatted or of incorrect length : <>

Uninstalling the vShield Endpoint Service from an ESX Host

Before you uninstall the vShield Endpoint from the vShield Manager and ESX host, you must unregister the
SVM from the vShield Endpoint service.
C If any of the virtual machines that are running on the target ESX host cannot be migrated to another
AUTION
ESX host, these virtual machines must be powered off or migrated manually before the uninstallation can
continue.

Unregister an SVM from vShield Endpoint

You must specify the virtual machine ID of the SVM to unregister the SVM from the vShield Endpoint service.
Example 7-4. Unregistering an SVM from vShield Endpoint
Request:
DELETE <vshieldmanager-uri>/endpointsecurity/svm/<vmId>
Example:
DELETE /api/1.0/endpointsecurity/svm/vm-1234 HTTP/1.1
host: 10.112.199.123:80
Authorization: Basic YWRtaW46ZGVmYXVsdA==
Response:
HTTP 204 No Content: The Endpoint Security VM is successfully unregistered.
HTTP 401 Unauthorized: The username or password sent in Authorized header is wrong.
HTTP 405 Method Not Allowed: If the vmId is missed in the URI.
HTTP 400 Bad Request: Internal error codes. Please refer the Error Schema for more details.
40002=Acquiring data from VC failed for <>
40007=SVM with moid: <> not registered
40015=vmId is malformatted or of incorrect length : <>
VMware, Inc.
Chapter 7 vShield Endpoint Management
65