Changes between Version 5 and Version 6 of GAPI_AM_API_ISSUES

Timestamp:

04/27/12 10:26:53 (12 years ago)

Author:

Aaron Helsinger

Comment:

--

GAPI_AM_API_ISSUES

@@ -15 +15 @@
  1. Add a state diagram in the [wiki:GAPI_AM_API_V2#SliverStatus SliverStatus] section to indicate that a component starts in {{{configuring}}}, can go from {{{configuring}}} to either {{{ready}}} or {{{failed}}}, and can go from {{{ready}}} to {{{failed}}}. {{{failed}}} is a terminal status.
   * More generally, we need to define the state of the resources before/after each operation. Diagrams help.
+  * See [wiki:GAPI_AM_API_DRAFT#ChangeSetF:SupportAMandresource-typespecificmethods. Change Set F]
  2. No way to modify a reservation at an aggregate for a slice without deleting and recreating it
   * Proposal: See the [wiki:GAPI_AM_API_DRAFT#ChangeSetC:UpdateSliver1 UpdateSliver proposal]
  3. No way to delete or renew part of a reservation at an aggregate separate from other parts
-  * Proposal: See the [wiki:GAPI_AM_API_DRAFT#ChangeSetD:SliversandSliverGroups Sliver group proposal]
+  * Proposal: See the [wiki:GAPI_AM_API_DRAFT#ChangeSetD:Sliver-specificoperations Sliver specific operations proposal]
  4. Method names suggest you are operating on slivers, but really you are operating on all slivers at an aggregate in a slice
-  * Proposal: See the [wiki:GAPI_AM_API_DRAFT#ChangeSetD:SliversandSliverGroups Sliver group proposal]
+  * Proposal: See the [wiki:GAPI_AM_API_DRAFT#ChangeSetD:Sliver-specificoperations Sliver specific operations proposal]
  5. Tickets
   * Proposal: See the [wiki:GAPI_AM_API_DRAFT#ChangeSetE:Tickets1 Tickets proposal]
  6. Define privileges required for each operation
-  * But see the ABAC proposal
+  * But see the ABAC proposal and DRAFT proposal J
  7. Clarify use of error codes, possibly add more detailed codes
    * Proposal: Add more specific error codes for credential issues, specific bad argument cases
@@ -70 +71 @@
 
 == !CreateSliver Issues ==
+Note this method gets removed by change sets proposed for version 3.
  1. Define the behavior if you call !CreateSliver twice for the same slice. PG says you return REFUSED. !PlanetLab accepts it though. What about {{{ALREADYEXISTS}}}?
 || `REFUSED`       || Slice already exists; must be deleted first (ie you called !CreateSliver twice without a !DeleteSliver in between) || 
    * Proposal: {{{ALREADYEXISTS}}}
+   * But see also the new Allocate and Provision methods proposed
  2. Define the behavior if the AM can only give you some of what you requested
   * Proposal: {{{TOOBIG}}}?
  3. Define status of sliver(s) immediately on success of this method (need a diagram?)
+  * See Change Set F
  4. Define how many sliver(s) this creates
+  * See Change Set D
  5. Note there is no way to see the expiration time of your resources
   * Proposal: include in manifest
+  * See instead Change Sets I and M
  6. Point to restrictions on slice names, sliver names?
   * Min 3 characters?
   * Max? 19? More?
   * Only characters in set: {{{'^[a-zA-Z][-\w]+$'}}} ?
+  * See Change Set K
 
 == !DeleteSliver Issues ==
+Note this method changes with proposals for version 3.
  1. What is failure (return false) as opposed to an Error?
   * Define status (relative to !SliverStatus or ...) of the sliver(s) after success, failure, or error. Diagram?
@@ -94 +102 @@
 
 == !SliverStatus Issues ==
+See changes proposed for version 3 which address these.
  1. Are the {{{configuring}}}, {{{ready}}}, etc strings case-sensitive?
   * Proposal: no
@@ -104 +113 @@
  1. All resources indicated by the supplied URN should be renewed to the given time, or else the entire call should fail. We don't specify that currently.
   * Proposal: Add that requirement
+  * See `geni_best_effort`
  2. Specify the behavior if you fail to renew and the reservation expires
   * Proposal: AM deletes the reservation, de-allocates the resources. (Required? May?)
@@ -115 +125 @@
  1. What is the state of resources after this? Startable? Is there a procedure for this?
   * Proposal: Not restartable, not de-commissioned, not reservable, not accessible by the experimenters
+  * See proposals for version 3
  2. What happens if you call this twice?
  3. What happens if the slice has nothing local?
  4. What does a false return mean?
   * Proposal: Drop that as valid: return true or an error
-