
vShield API Programming Guide
86 VMware, Inc.
</xs:schema>
Error Message Schema
Thisschemadetailserrormessages.
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">
<xs:element name="Errors">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="Error" type="ErrorType"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:complexType name="ErrorType">
<xs:sequence>
<xs:element name="code" type="xs:unsignedInt"/>
<xs:element name="description" type="xs:string"/>
<xs:element minOccurs="0" name="detailedDescription" type="xs:string"/>
<xs:element minOccurs="0" name="index" type="xs:int"/>
<xs:element minOccurs="0" name="resource" type="xs:NMTOKEN"/>
<xs:element minOccurs="0" name="requestId" type="xs:NMTOKEN"/>
</xs:sequence>
</xs:complexType>
</xs:schema>
IfaRESTAPIcallresultsinanerror,theHTTPreplycontainsthefollowinginformation.
AnXMLerrordocumentastheresponsebody
Content‐Type:application/xml
Anappropriate2xx,4xx,or5xxHTTPstatuscode
Table 8-1. Error Message Status Codes
Code Description
200 OK Therequestwasvalidandhasbeencompleted.Generally,thisresponseisaccompanied
byabodydocument(XML).
204 No Content Sameas200 OK,buttheresponsebodyisempty(NoXML).
400 Bad Request Therequestbodycontainsaninvalidrepresentationortherepresentationoftheentityis
missinginformation.Theresponseisaccompanied
byErrorObject(XML).
401 Unauthorized Anauthorizationheaderwasexpected.RequestwithinvalidornovShieldManager
Token.
403 Forbidden Theuserdoesnothaveenoughprivilegestoaccesstheresource.
404 Not Found Theresourcewasnotfound.TheresponseisaccompaniedbyErrorObject(XML).
500 Internal Server
Error
Unexpectederrorwiththeserver.Theresponseis
accompaniedbyErrorObject(XML).
503 Service
Unavailable
Cannotproceedwiththerequest,becausesomeoftheservicesareunavailable.Example:
vShieldEdgeisUnreachable.TheresponseisaccompaniedbyErrorObject(XML).
Comentarios a estos manuales