GAPI_AM_API_V3/CommonConcepts: geni-error-codes.xml

File geni-error-codes.xml, 7.4 KB (added by Aaron Helsinger, 6 years ago)
Line 
1<?xml version="1.-" encoding="UTF-8" standalone="yes"?>
2
3<!-- Document GENI standard error codes.
4     See http://groups.geni.net/geni/wiki/GAPI_AM_API -->
5
6<!DOCTYPE geni-error-codes [
7 <!ELEMENT geni-error-codes (code)>
8 <!ATTLIST geni-error-codes as-of CDATA #REQUIRED>
9 <!ELEMENT code (value, label, description)>
10 <!ELEMENT value (#PCDATA)>
11 <!ELEMENT label (#PCDATA)>
12 <!ELEMENT description (#PCDATA)>
13]>
14
15<geni-error-codes as-of="2011-11-16">
16  <code>
17    <value>0</value>
18    <label>SUCCESS</label>
19    <description>Success</description>
20  </code>
21  <code>
22    <value>-32001</value>
23    <label>SERVERBUSY</label>
24    <description>Server is (temporarily) too busy; try again later</description>
25  </code>
26  <code>
27    <value>1</value>
28    <label>BADARGS</label>
29    <description>Bad Arguments: malformed</description>
30  </code>
31  <code>
32    <value>2</value>
33    <label>ERROR</label>
34    <description>Error (other)</description>
35  </code>
36  <code>
37    <value>3</value>
38    <label>FORBIDDEN</label>
39    <description>Operation Forbidden: eg supplied credentials do not
40    provide sufficient privileges (on the given slice)</description>
41  </code>
42  <code>
43    <value>4</value>
44    <label>BADVERSION</label>
45    <description>Bad Version (eg of RSpec)</description>
46  </code>
47  <code>
48    <value>5</value>
49    <label>SERVERERROR</label>
50    <description>Server Error</description>
51  </code>
52  <code>
53    <value>6</value>
54    <label>TOOBIG</label>
55    <description>Too Big (eg request RSpec)</description>
56  </code>
57  <code>
58    <value>7</value>
59    <label>REFUSED</label>
60    <description>Operation Refused</description>
61  </code>
62  <code>
63    <value>8</value>
64    <label>TIMEDOUT</label>
65    <description>Operation Timed Out</description>
66  </code>
67  <code>
68    <value>9</value>
69    <label>DBERROR</label>
70    <description>Database Error</description>
71  </code>
72  <code>
73    <value>10</value>
74    <label>RPCERROR</label>
75    <description>RPC Error</description>
76  </code>
77  <code>
78    <value>11</value>
79    <label>UNAVAILABLE</label>
80    <description>Unavailable (eg server in lockdown)</description>
81  </code>
82  <code>
83    <value>12</value>
84    <label>SEARCHFAILED</label>
85    <description>Search Failed (eg for slice)</description>
86  </code>
87  <code>
88    <value>13</value>
89    <label>UNSUPPORTED</label>
90    <description>Operation Unsupported</description>
91  </code>
92  <code>
93    <value>14</value>
94    <label>BUSY</label>
95    <description>Busy (resource, slice, or server); try again later</description>
96  </code>
97  <code>
98    <value>15</value>
99    <label>EXPIRED</label>
100    <description>Expired (eg slice)</description>
101  </code>
102  <code>
103    <value>16</value>
104    <label>INPROGRESS</label>
105    <description>In Progress</description>
106  </code>
107  <code>
108    <value>17</value>
109    <label>ALREADYEXISTS</label>
110    <description>Already Exists (eg slice)</description>
111  </code>
112<!-- 18+ not in original ProtoGENI implementation or Error Code --
113  -- proposal. -->
114  <code>
115    <value>18</value>
116    <label>MISSINGARGS</label>
117    <description>Required argument(s) missing</description>
118  </code>
119  <code>
120    <value>19</value>
121    <label>OUTOFRANGE</label>
122    <description>Input Argument outside of legal range</description>
123  </code>
124  <code>
125    <value>20</value>
126    <label>CREDENTIAL_INVALID</label>
127    <description>Not authorized: Supplied credential is invalid</description>
128  </code>
129  <code>
130    <value>21</value>
131    <label>CREDENTIAL_EXPIRED</label>
132    <description>Not authorized: Supplied credential expired</description>
133  </code>
134  <code>
135    <value>22</value>
136    <label>CREDENTIAL_MISMATCH</label>
137    <description>Not authorized: Supplied credential does not match client certificate or does not match the given slice URN</description>
138  </code>
139  <code>
140    <value>23</value>
141    <label>CREDENTIAL_SIGNER_UNTRUSTED</label>
142    <description>Not authorized: Supplied credential not signed by a trusted authority</description>
143  </code>
144  <code>
145    <value>24</value>
146    <label>VLAN_UNAVAILABLE</label>
147    <description>VLAN tag(s) requested not available (likely stitching failure)</description>
148  </code>
149  <code>
150    <value>25</value>
151    <label>INSUFFICIENT_BANDWIDTH</label>
152    <description>Requested capacity for link(s) not available</description>
153  </code>
154</geni-error-codes>
155
156<!--
157|| 0    || SUCCESS      || "Success" ||
158|| 1    || BADARGS      || "Bad Arguments: malformed arguments" ||
159|| 2    || ERROR        || "Error (other)" ||
160|| 3    || FORBIDDEN    || "Operation Forbidden: eg supplied credentials do not provide sufficient privileges (on given slice)" ||
161|| 4    || BADVERSION   || "Bad Version (eg of RSpec)" ||
162|| 5    || SERVERERROR  || "Server Error" ||
163|| 6    || TOOBIG       || "Too Big (eg request RSpec)" ||
164|| 7    || REFUSED      || "Operation Refused" ||
165|| 8    || TIMEDOUT     || "Operation Timed Out" ||
166|| 9    || DBERROR      || "Database Error" ||
167|| 10   || RPCERROR     || "RPC Error" ||
168|| 11   || UNAVAILABLE  || "Unavailable (eg server in lockdown)" ||
169|| 12   || SEARCHFAILED         || "Search Failed (eg for slice)" ||
170|| 13   || UNSUPPORTED  || "Operation Unsupported" ||
171|| 14   || BUSY         || "Busy (resource, slice, or server); try again later" ||
172|| 15   || EXPIRED      || "Expired (eg slice)" ||
173|| 16   || INPROGRESS   || "In Progress" ||
174|| 17   || ALREADYEXISTS        || "Already Exists (eg the slice}" ||
175|| 18   || MISSINGARGS  || "Required argument(s) missing" ||
176|| 19   || OUTOFRANGE   || "Requested expiration time or other argument not valid" ||
177|| 20   || CREDENTIAL_INVALID   || "Not authorized: Supplied credential is invalid" ||
178|| 21   || CREDENTIAL_EXPIRED   || "Not authorized: Supplied credential expired" ||
179|| 22   || CREDENTIAL_MISMATCH   || "Not authorized: Supplied credential does not match the supplied client certificate or does not match the given slice URN" ||
180|| 23   || CREDENTIAL_SIGNER_UNTRUSTED   || "Not authorized: Supplied credential not signed by trusted authority" ||
181|| 24   || VLAN_UNAVAILABLE     || "VLAN tag(s) requested not available (likely stitching failure)" ||
182|| 25   || INSUFFICIENT_BANDWIDTH       || "Requested capacity for link(s) not available" ||
183
18418+ not in original ProtoGENI implementation or Error Code proposal.
185
186Maping to SFA Faults:
187SfaAuthenticationFailure: FORBIDDEN
188SfaDBErrr: DBERROR
189SfaFault: ERROR
190SfaPermissionDenied: FORBIDDEN
191SfaNotImplemented: UNSUPPORTED
192SfaAPIError: SERVERERROR
193MalformedHrnException: BADARGS
194NonExistingRecord: SEARCHFAILED
195ExistingRecord: ALREADYEXISTS
196NonexistingCredType: SEARCHFAILED? FORBIDDEN? CREDENTIAL_INVALID?
197NonexitingFile: SEARCHFAILED
198InvalidRPCParams: RPCERROR
199ConnectionKeyGIDMismatch: FORBIDDEN? CREDENTIAL_MISMATCH?
200MissingCallerGID: SEARCHFAILED? CREDENTIAL_MISMATCH?
201RecordNotFound: SEARCHFAILED
202PlanetLAbRecordDoesNotExist: SEARCHFAILED
203PermissionError: FORBIDDEN
204InsufficientRights: FORBIDDEN
205MissingDelegateBit: CREDENTIAL_INVALID? FORBIDDEN?
206ChildRightsNotSubsetOfParent: CREDENTIAL_INVALID
207CertMissingParent: FORBIDDEN? CREDENTIAL_INVALID?
208CertNotSignedByParent: FORBIDDEN
209GidParentHrn: FORBIDDEN? CREDENTIAL_INVALID?
210GidInvalidParentHrn: FORBIDDEN? CREDENTIAL_INVALID?
211SliverDoesNotExist: SEARCHFAILED
212MissingTrustedRoots: SERVERERROR
213MissingSfaInfo: SERVERERROR
214InvalidRSpec: BADARGS
215InvalidRSpecElement: BADARGS
216AccountNotEnabled: REFUSED? FORBIDDEN?
217CredentialNotVerifiable: CREDENTIAL_INVALID
218CertExpired: EXPIRED? FORBIDDEN?
219-->