Changes between Version 80 and Version 81 of GAPI_AM_API_DRAFT


Ignore:
Timestamp:
10/25/12 18:50:00 (11 years ago)
Author:
Aaron Helsinger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GAPI_AM_API_DRAFT

    v80 v81  
    5353
    5454== Change Set C: `Update()` ==
     55This change was adopted at the GEC15 coding sprint for inclusion in API v4. Aggregates are permitted to include this method in the API v3 implementations.
     56
    5557Add an ability for experimenters to modify their allocated resources at an aggregate without deleting (and possibly losing) existing resource allocations.
    5658
    57 This change was briefly discussed at GEC13, discussed at the GEC14 coding sprint, and is a topic for ongoing discussion.
     59This change was briefly discussed at GEC13, discussed at the GEC14 coding sprint, and the GEC15 AM Topics and Coding Sprint.
    5860
    5961=== Motivation ===
     
    121123
    122124Any new resources requested in the RSpec not associated with a current sliver will be in the `geni_allocated` state and will be added to slivers, just as after a call to `Allocate()`.
     125
     126While slivers are `geni_updating`, operational actions are not permitted (`PerformOperationalAction()` should return an error code).
    123127
    124128==== Return ====
     
    132136                  geni_expires: <dateTime.rfc3339 allocation expiration string, as in geni_expires from Status>,
    133137                  geni_allocation_status: <string sliver state - e.g. geni_allocated, geni_updating>,
     138                  geni_next_allocation_status: <string state of the sliver after the next Provision() call - geni_unallocated or geni_provisioned>,
    134139                  geni_error: <optional string, may be omitted entirely, explaining any failure for a sliver>
    135140        },
     
    139144}}}
    140145
    141 The list of returned slivers includes even those that will be deleted.
     146The list of returned slivers includes even those that will be deleted. For those slivers, `geni_next_allocation_status` will be `geni_unallocated`.
    142147
    143148=== State Guarantees ===
     
    212217A call to `Delete()` can be used to delete slivers in any state.
    213218
     219=== Changes to `PerformOperationalAction()` ===
     220
     221While slivers are `geni_updating`, operational actions are not permitted (`PerformOperationalAction()` should return an error code).
     222
    214223=== Change to `geni_single_allocation` ===
    215224
     
    237246
    238247== Change Set N: Add information to `GetVersion` ==
    239 This change set adds some additional information to the return from `GetVersion`. If adopted, aggregates may implement this as part of their AM API v3 implementation, but will be required to do so as part of AM API v4.
     248This change set adds some additional information to the return from `GetVersion`.
     249
     250This change set was adopted at the GEC15 coding sprint. Aggregates may implement this as part of their AM API v3 implementation, but will be required to do so as part of AM API v4.
    240251
    241252=== Change Set N1: Add `geni_am_code_version` ===
     
    285296
    286297== Change Set O: Refine character restrictions ==
    287 If adopted, aggregates may implement this as part of their AM API v3 implementation, but will be required to do so as part of AM API v4.
     298This change set was adopted at the GEC15 coding sprint. Aggregates may implement this as part of their AM API v3 implementation, but will be required to do so as part of AM API v4.
    288299
    289300=== Change Set O1: Allow other characters in sliver names ===