Changes between Version 19 and Version 20 of AaronHelsinger/GAPI_AM_API_DRAFT


Ignore:
Timestamp:
03/29/12 14:07:37 (7 years ago)
Author:
Aaron Helsinger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • AaronHelsinger/GAPI_AM_API_DRAFT

    v19 v20  
    943943Where supplying `geni_sliver_urns`, whether or not the `geni_slice_urn` is also supplied, means return a manifest RSpec showing the (allocated or provisioned) slivers listed - not necessarily the complete slice at this aggregate.
    944944
     945Note that the manifest RSpec for allocated slivers may contain less detail than for provisioned slivers.
     946
    945947Return struct:
    946948{{{
     
    994996{{{
    995997{
    996  rspec: <string manifest>,
     998 geni_rspec: <string manifest>,
    997999 geni_slivers: [
    9981000        {
     
    10341036Return list of structs:
    10351037{{{
    1036   geni_slivers:
    10371038[
    10381039  {
     
    10731074{{{
    10741075{
    1075  rspec: <string manifest>,
     1076 geni_rspec: <string manifest>,
    10761077 geni_slivers: [
    10771078        {
     
    11141115Return struct:
    11151116{{{
    1116   geni_manifest: <string, RSpec manifest>,
     1117  geni_rspec: <string, RSpec manifest>,
    11171118  geni_slivers:
    11181119  [
     
    11321133
    11331134FIXME: Is the returned manifest only for newly provisioned slivers? Or all slivers at this AM for this slice?
     1135FIXME: Pull out users[] struct and instead add a Configure() method with AM/resource specific options?
    11341136
    11351137 == !UpdateSlivers ==
     
    12021204Return list of structs:
    12031205{{{
    1204   geni_slivers:
    12051206[
    12061207  {
     
    12391240{
    12401241  geni_urn: <slice URN>
    1241   [optional: geni_allocation_status: <string, eg provisioned>]
    1242   [optional: geni_operational_status: <string, eg ready >]
    1243   geni_expires: <datetime of expiration>
    1244   struct geni_resources: [ { geni_urn: <sliver URN>
     1242  geni_slivers: [
     1243                    { geni_sliver_urn: <sliver URN>
    12451244                      geni_allocation_status: <string, eg provisioned>
    12461245                      geni_operational_status: <string, eg ready>
    12471246                      geni_expires: <datetime of individual sliver expiration>
    12481247                      geni_error: <string, eg ''>,
    1249                       [optional: 'geni_resource_status' : <string>]
     1248                      [optional: others AM/resource specific]
    12501249                    },
    1251                     { geni_urn: <sliver URN>
     1250                    { geni_sliver_urn: <sliver URN>
    12521251                      geni_allocation_status: <string, eg provisioned>
    12531252                      geni_operational_status: <string, eg ready>
    12541253                      geni_expires: <datetime of individual sliver expiration>
    12551254                      geni_error: <string, eg ''>,
    1256                       [optional: 'geni_resource_status' : <string>]
     1255                      [optional: others AM/resource specific]
    12571256                      }
    12581257                  ]
    12591258}
    12601259}}}
     1260
     1261FIXME: Split Status(slice) from Status(slivers)
    12611262
    12621263 == !PerformOperationalAction ==
     
    12831284{{{
    12841285[ {
    1285         geni_urn : <string>,
     1286        geni_sliver_urn : <string>,
     1287        geni_allocation_status: <string, eg provisioned>
    12861288        geni_operational_status : <string>,
    1287         [optional: geni_resource_status' : <string>]
     1289        geni_expires: <datetime of individual sliver expiration>
     1290        [optional: AM/resource specific]
    12881291        },
    12891292        ...
     
    12911294;
    12921295}}}
     1296
     1297FIXME: Split Perform(slice) from Perform(slivers)
    12931298
    12941299 == !DeleteSlivers ==
     
    13411346}}}
    13421347
    1343 Return list of structs:
    1344 {{{
    1345 [
    1346   {
    1347    geni_sliver_urn: <string>,
    1348    geni_allocation_status: <string>,
    1349    geni_expires: <time when the sliver expires from its current state>,
    1350    <others AM or method specific>
    1351   },
    1352   ...
    1353 ]
    1354 }}}
     1348Return: boolean