Changes between Version 12 and Version 13 of AaronHelsinger/GAPI_AM_API_DRAFT/MethodSignatures
- Timestamp:
- 04/16/12 12:13:41 (12 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
AaronHelsinger/GAPI_AM_API_DRAFT/MethodSignatures
v12 v13 153 153 154 154 Allocate 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. 155 Allocated 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. 156 Aggregates should implement Allocate() as quick, cheap, and not impacting Provisioned resources, such that it can be readily undone. 155 157 156 158 {{{ … … 181 183 { 182 184 geni_sliver_urn: <string sliver urn> 183 geni_expires: <dateTime.rfc3339 allocation expiration string, as in geni_expires from S liversStatus>,185 geni_expires: <dateTime.rfc3339 allocation expiration string, as in geni_expires from Status>, 184 186 geni_allocation_status: <string sliver state - allocated or ?? > 185 187 }, … … 193 195 == Renew == 194 196 AKA !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. 197 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. 196 198 197 199 {{{ … … 202 204 }}} 203 205 204 `credentials` is the standard argument defined above.205 206 Options include {{{geni_best_effort}}} 207 208 Return list of structs:206 Options 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 210 Return value is a list of structs: 209 211 {{{ 210 212 [