Changes between Version 20 and Version 21 of GAPI_AM_API_DRAFT


Ignore:
Timestamp:
11/04/11 10:31:40 (12 years ago)
Author:
Aaron Helsinger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GAPI_AM_API_DRAFT

    v20 v21  
    268268
    269269Proposal 2:
    270  * {{{code}}}: An XMLRPC string, of the form "<namespace string><separator><integer code>", where
    271   * <separator> is a colon (':')
    272   * <integer codes> MUST NOT be longer than 6 characters, and MUST be positive integers
    273   * <namespace string>:
    274    * Namespace names are case insensitive
    275    * Names MUST NOT be more than 16 characters
    276    * Names MUST use only ISO-8859-1 characters
    277    * Names are maintained at a registry linked off of the GENI AM API wiki page at geni.net
    278    * Names MUST NOT include the separator character
    279   * The namespace 'GENI' is reserved for error codes that are common across aggregates.
    280    * The GENI namespace SHALL contain errors which are common across multiple (although not necessarily all) aggregates. If the GENI namespace has a code which articulates the error you are returning, you MUST use this code instead of one from your own namespace.
    281   * Success MUST be indicated by the use of 0 in the GENI namespace: "GENI:0". There is currently no way to indicate "degrees" of success with qualifiers - if you want to reflect this it should be in an error.
    282 
    283 Rationale for this proposal is available here: https://openflow.stanford.edu/display/FOAM/AM+return+code+proposal
    284 
     270 * {{{code}}}: An XMLRPC string, of the form "<namespace string><separator><integer code>". For details on this proposal, see: https://openflow.stanford.edu/display/FOAM/AM+return+code+proposal
    285271
    286272 * {{{value}}}: On success, this is required. Optional on failure or error. Object representing the successful return value. This will be the object previously returned by the function (for example the manifest RSpec for !CreateSliver, or the struct for !SliverStatus). The value is not defined on error, though aggregates are free to use it.