VMware VSHIELD APP 1.0.0 UPDATE 1 - API Programming Manual page 62

vShield API Programming Guide
Example:
POST /api/1.0/endpointsecurity/svm HTTP/1.1
accept: application/xml
content-type: application/xml
host: 10.112.199.123:80
Authorization: Basic YWRtaW46ZGVmYXVsdA==
content-length: 204
<VShieldEndpointSecurity><SvmRegister><vmId>vm-3983</vmId><ipAddress>192.168.0.1</ipAddress>
Response:
HTTP 204 No Content: The Endpoint Security VM is successfully registered.
HTTP 401 Unauthorized: The username or password sent in Authorization header is wrong.
HTTP 400 Bad Request
40002=Acquiring data from VC failed for <>
40005=SVM with moid: <> failed to register
40006=SVM with moid: <> already registered
40009=Invalid SVM details
40010=Endpoint LKM not installed
40012=Endpoint LKM not installed due to bad ESX version
40015=vmId is malformatted or of incorrect length : <>
40020=Invalid vendorId for {0}
40022=Host: <> has a registered SVM with moid: <>
Retrieve SVM-Specific Network Information
You must specify the virtual machine ID of the SVM to view network information.
Example 7-2. Retrieve SVM-Specific vShield Endpoint Network Information
Request:
GET <vshieldmanager-uri>/api/1.0/endpointsecurity/svm/<vmId>/<vendorId>/connInfo
Example:
GET /api/1.0/endpointsecurity/svm/vm-1234/JohnDoe/connInfo 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>
<HostToSvmConnectionInfo>
<ipAddress>ip_address</ipAddress>
<port>port</port>
</HostToSvmConnectionInfo>
</VShieldEndpointSecurity>
HTTP 401 Unauthorized : The username or password sent in Authorization 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 1. data from VC failed for <>
40007=SVM with moid: <> not registered
40015=vmId is malformatted or of incorrect length : <>
62
<port>6666</port><vendorId>SomeVendor</vendorId></SvmRegister>
</VShieldEndpointSecurity>
VMware, Inc.