Changes between Version 19 and Version 20 of AaronHelsinger/GAPI_AM_API_DRAFT

Timestamp:

03/29/12 14:07:37 (12 years ago)

Author:

Aaron Helsinger

Comment:

--

AaronHelsinger/GAPI_AM_API_DRAFT

@@ -943 +943 @@
 Where 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.
 
+Note that the manifest RSpec for allocated slivers may contain less detail than for provisioned slivers.
+
 Return struct:
 {{{
@@ -994 +996 @@
 {{{
 {
- rspec: <string manifest>,
+ geni_rspec: <string manifest>,
  geni_slivers: [
         {
@@ -1034 +1036 @@
 Return list of structs:
 {{{ 
-  geni_slivers: 
 [
   {
@@ -1073 +1074 @@
 {{{
 {
- rspec: <string manifest>,
+ geni_rspec: <string manifest>,
  geni_slivers: [
         {
@@ -1114 +1115 @@
 Return struct:
 {{{
-  geni_manifest: <string, RSpec manifest>,
+  geni_rspec: <string, RSpec manifest>,
   geni_slivers: 
   [
@@ -1132 +1133 @@
 
 FIXME: Is the returned manifest only for newly provisioned slivers? Or all slivers at this AM for this slice?
+FIXME: Pull out users[] struct and instead add a Configure() method with AM/resource specific options?
 
  == !UpdateSlivers ==
@@ -1202 +1204 @@
 Return list of structs:
 {{{ 
-  geni_slivers: 
 [
   {
@@ -1239 +1240 @@
 {
   geni_urn: <slice URN>
-  [optional: geni_allocation_status: <string, eg provisioned>]
-  [optional: geni_operational_status: <string, eg ready >]
-  geni_expires: <datetime of expiration>
-  struct geni_resources: [ { geni_urn: <sliver URN>
+  geni_slivers: [ 
+                    { geni_sliver_urn: <sliver URN>
                       geni_allocation_status: <string, eg provisioned>
                       geni_operational_status: <string, eg ready>
                       geni_expires: <datetime of individual sliver expiration>
                       geni_error: <string, eg ''>,
-                      [optional: 'geni_resource_status' : <string>]
+                      [optional: others AM/resource specific]
                     },
-                    { geni_urn: <sliver URN>
+                    { geni_sliver_urn: <sliver URN>
                       geni_allocation_status: <string, eg provisioned>
                       geni_operational_status: <string, eg ready>
                       geni_expires: <datetime of individual sliver expiration>
                       geni_error: <string, eg ''>,
-                      [optional: 'geni_resource_status' : <string>]
+                      [optional: others AM/resource specific]
                       }
                   ]
 }
 }}}
+
+FIXME: Split Status(slice) from Status(slivers)
 
  == !PerformOperationalAction ==
@@ -1283 +1284 @@
 {{{
 [ {
-        geni_urn : <string>,
+        geni_sliver_urn : <string>,
+        geni_allocation_status: <string, eg provisioned>
         geni_operational_status : <string>,
-        [optional: geni_resource_status' : <string>]
+        geni_expires: <datetime of individual sliver expiration>
+        [optional: AM/resource specific]
         }, 
         ... 
@@ -1291 +1294 @@
 ;
 }}}
+
+FIXME: Split Perform(slice) from Perform(slivers)
 
  == !DeleteSlivers ==
@@ -1341 +1346 @@
 }}}
 
-Return list of structs:
-{{{
-[
-  {
-   geni_sliver_urn: <string>,
-   geni_allocation_status: <string>,
-   geni_expires: <time when the sliver expires from its current state>,
-   <others AM or method specific>
-  },
-  ...
-]
-}}}
+Return: boolean