Changes between Version 12 and Version 13 of AaronHelsinger/GAPI_AM_API_DRAFT/MethodSignatures


Ignore:
Timestamp:
04/16/12 12:13:41 (12 years ago)
Author:
Aaron Helsinger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • AaronHelsinger/GAPI_AM_API_DRAFT/MethodSignatures

    v12 v13  
    153153
    154154Allocate resources as described in a request RSpec argument to a slice with the named URN.  On success, one or more slivers are allocated, containing resources satisfying the request, and assigned to the given slice. This method returns a listing and description of the resources reserved for the slice by this operation, in the form of a manifest RSpec.
     155Allocated slivers are held for an aggregate-determined period. Clients must Renew or Provision slivers before the expiration time (given in the return struct), or the aggregate will automatically Delete them.
     156Aggregates should implement Allocate() as quick, cheap, and not impacting Provisioned resources, such that it can be readily undone.
    155157
    156158{{{
     
    181183        {
    182184                  geni_sliver_urn: <string sliver urn>
    183                   geni_expires: <dateTime.rfc3339 allocation expiration string, as in geni_expires from SliversStatus>,
     185                  geni_expires: <dateTime.rfc3339 allocation expiration string, as in geni_expires from Status>,
    184186                  geni_allocation_status: <string sliver state - allocated or ?? >
    185187        },
     
    193195 == Renew ==
    194196AKA !RenewSliver() or !RenewAllocated
    195 Request that the named slivers be renewed, with their expiration extended. If possible, the aggregate should extend the slivers to the requested expiration time, or to a sooner time if policy limits apply. This method applies to slivers that are `geni_allocated` or to slivers that are `geni_provisioned`, though different policies may apply to slivers in the different states, resulting in much shorter max expiration times for `geni_allocated` slivers.
     197Request that the named slivers be renewed, with their expiration extended. If possible, the aggregate should extend the slivers to the requested expiration time, or to a sooner time if policy limits apply. This method applies to slivers that are `geni_allocated` or to slivers that are `geni_provisioned`, though different policies may apply to slivers in the different states, resulting in much shorter max expiration times for `geni_allocated` slivers. 
    196198
    197199{{{
     
    202204}}}
    203205
    204 `credentials` is the standard argument defined above.
    205 
    206 Options include {{{geni_best_effort}}}
    207 
    208 Return list of structs:
     206Options include {{{geni_best_effort}}}, specifying whether the client prefers all included slivers to be renewed or none, or wants a partial success if possible.
     207
     208{{{expiration_time}}}: The date-time string in [http://tools.ietf.org/html/rfc3339 RFC 3339] format in UTC when the reservation(s) should be extended until.
     209
     210Return value is a list of structs:
    209211{{{
    210212[