Changes between Version 45 and Version 46 of GAPI_AM_API_DRAFT

Timestamp:

03/15/12 12:36:12 (13 years ago)

Author:

Aaron Helsinger

Comment:

--

GAPI_AM_API_DRAFT

@@ -107 +107 @@
 
 AMs which cannot meet the implied limit to service disruption should fail the request (return an error code).
+
+''However'' there is an alternative more widely accepted proposal, to use an RSpec extension allowing this guarantee to be per-resource:
+EG:
+{{{
+  <node ... sliver_id="urn:publicid:IDN+jonlab.tbres.emulab.net+sliver+250">
+    <sliver_type name="raw-pc"/>
+...
+    <preserve:preserve guarantee="persistent-state" />
+  </node>
+}}}
+
+This uses the RNC schema:
+{{{
+default namespace = "http://www.protogeni.net/resources/rspec/ext/preserve/1"
+
+# This is meant to extend a node or link
+Preserved = element preserve {
+  attribute guarantee { "none" | "persistent-state" |
+                        "dynamic-state" | "no-disruption" }
+}
+
+start = Preserved
+}}}
+
+In the above schema, the states represent increasing levels of state preservation guarantee.
 
 {{{
@@ -292 +317 @@
  - 3=NO_DISRUPTION (no noticeable service disruption)
 
+''However'', see above for a proposed RSpec extension to instead make the state guarantee per resource.
+
 Tickets should include the {{{geni_ticket_service_class}}} attribute for advertising the firmness of the promise that a ticket represents (case insensitive string or integer). 
  - FIXME: Provide definitions for these service classes.