Changes between Version 80 and Version 81 of GAPI_AM_API_DRAFT
- Timestamp:
- 10/25/12 18:50:00 (12 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
GAPI_AM_API_DRAFT
v80 v81 53 53 54 54 == Change Set C: `Update()` == 55 This 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 55 57 Add an ability for experimenters to modify their allocated resources at an aggregate without deleting (and possibly losing) existing resource allocations. 56 58 57 This change was briefly discussed at GEC13, discussed at the GEC14 coding sprint, and is a topic for ongoing discussion.59 This change was briefly discussed at GEC13, discussed at the GEC14 coding sprint, and the GEC15 AM Topics and Coding Sprint. 58 60 59 61 === Motivation === … … 121 123 122 124 Any 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 126 While slivers are `geni_updating`, operational actions are not permitted (`PerformOperationalAction()` should return an error code). 123 127 124 128 ==== Return ==== … … 132 136 geni_expires: <dateTime.rfc3339 allocation expiration string, as in geni_expires from Status>, 133 137 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>, 134 139 geni_error: <optional string, may be omitted entirely, explaining any failure for a sliver> 135 140 }, … … 139 144 }}} 140 145 141 The list of returned slivers includes even those that will be deleted. 146 The list of returned slivers includes even those that will be deleted. For those slivers, `geni_next_allocation_status` will be `geni_unallocated`. 142 147 143 148 === State Guarantees === … … 212 217 A call to `Delete()` can be used to delete slivers in any state. 213 218 219 === Changes to `PerformOperationalAction()` === 220 221 While slivers are `geni_updating`, operational actions are not permitted (`PerformOperationalAction()` should return an error code). 222 214 223 === Change to `geni_single_allocation` === 215 224 … … 237 246 238 247 == 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. 248 This change set adds some additional information to the return from `GetVersion`. 249 250 This 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. 240 251 241 252 === Change Set N1: Add `geni_am_code_version` === … … 285 296 286 297 == 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.298 This 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. 288 299 289 300 === Change Set O1: Allow other characters in sliver names ===
