Changes between Version 9 and Version 10 of AaronHelsinger/GAPI_AM_API_DRAFT


Ignore:
Timestamp:
03/22/12 15:31:54 (12 years ago)
Author:
Aaron Helsinger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • AaronHelsinger/GAPI_AM_API_DRAFT

    v9 v10  
    906906    string version;
    907907  };
    908   string geni_start_time;
    909908  string geni_end_time;
    910909}
     
    926925{{{
    927926{
    928    rspec (ad or Manifest - may be empty though)
    929    tickets[] (required but may be an empty list)
    930 }
    931 }}}
     927   string geni_rspec (ad or Manifest - may be empty though)
     928   string geni_urn, (slice or sliver as requested)
     929   geni_expires=<RFC3339 allocation expiration, as in geni_expires from SliversStatus>,
     930   string geni_allocation_status=<sliver state - allocated or ?? >,
     931}
     932}}}
     933
     934FIXME: Can you do !ListResources on a single sliver? Does the return show all slivers individually? 1 roll-up?
    932935
    933936 == !CreateSlivers ==
     
    955958{{{
    956959{
    957   string geni_start_time <datetime> (optional),
    958960  string geni_end_time <datetime> (optional)
    959961}
     
    964966{
    965967 string rspec=<manifest>,
    966  geni_start_time=<optional (may be omitted altogether): now if not specified>,
    967968 geni_expires=<RFC3339 allocation expiration, as in geni_expires from SliversStatus>,
    968969 string geni_allocation_status=<sliver state - allocated or ?? >,
     
    994995
    995996Options include {{{geni_atomic = True/False, default True}}}
     997FIXME: Or is it `geni_best_effort` default False?
    996998
    997999Return list of structs:
     
    10261028}}}
    10271029
    1028 Options include {{{geni_start_time}}} and {{{geni_end_time}}} and {{{geni_atomic = True/False, default True}}}
     1030Options include {{{geni_end_time}}} and {{{geni_atomic = True/False, default True}}}
     1031FIXME: Or is it `geni_best_effort` default False?
    10291032
    10301033Return a list of structs:
     
    10601063
    10611064Options include {{{geni_atomic = True/False, default True}}}
     1065FIXME: Or is it `geni_best_effort` default False?
    10621066
    10631067Return a list of structs:
     
    10681072   geni_allocation_status,
    10691073   geni_operational_status,
     1074   [optional: 'geni_resource_status' : string]
    10701075   geni_expires <time when the sliver expires from its current state>,
    10711076   <others AM or method specific>
     
    10961101}}}
    10971102
    1098 Options include {{{geni_start_time}}} and {{{geni_end_time}}} and {{{geni_atomic = True/False, default True}}}
     1103Options include {{{geni_end_time}}} and {{{geni_atomic = True/False, default True}}}
     1104FIXME: Or is it `geni_best_effort` default False?
    10991105
    11001106Return struct:
     
    11031109  string ticket=<ticket>
    11041110  string geni_status=<sliver state - ticketed>,
    1105   string geni_state_guarantee=<promise from AM of what experimenter state will be lost on trying to 'start' this allocation>,
    11061111 <others that are AM specific>
    11071112}
     
    11301135
    11311136Options include {{{geni_atomic = True/False, default True}}}
     1137FIXME: Or is it `geni_best_effort` default False?
    11321138
    11331139Return list of structs:
     
    11711177                      geni_allocation_status: provisioned
    11721178                      geni_operational_status: ready
     1179                      [optional: 'geni_resource_status' : string]
    11731180                      geni_expires: <datetime of individual sliver expiration>
    11741181                      geni_error: ''},
     
    11761183                      geni_allocation_status: provisioned
    11771184                      geni_operational_status: ready
     1185                      [optional: 'geni_resource_status' : string]
    11781186                      geni_expires: <datetime of individual sliver expiration>
    11791187                      geni_error: ''}
     
    12001208
    12011209Options include: {{{geni_atomic = True/False, default True}}}
     1210FIXME: Or is it `geni_best_effort` default False?
    12021211
    12031212Return list of structs:
    12041213{{{
    12051214[ {
    1206         'sliver_urn' : string,
     1215        'geni_urn' : string,
    12071216        'geni_operational_status' : string,
    12081217        [optional: 'geni_resource_status' : string]
     
    12311240
    12321241Options include: {{{geni_atomic = True/False, default True}}}
     1242FIXME: Or is it `geni_best_effort` default False?
    12331243
    12341244Return list of structs: