Changes between Version 3 and Version 4 of AaronHelsinger/GAPI_AM_API_DRAFT/MethodSignatures/CommonConcepts

Timestamp:

04/18/12 15:45:27 (12 years ago)

Author:

Aaron Helsinger

Comment:

--

AaronHelsinger/GAPI_AM_API_DRAFT/MethodSignatures/CommonConcepts

@@ -40 +40 @@
   * Aggregate reserves resources
   * Return is a manifest RSpec describing the reserved resources
+  * Optionally {{{Delete}}} some slivers, if you made a mistake, or don't like what the aggregate picked for you.
  5. {{{Provision(<slice URN or sliver URNs>, <slice credential>, <request RSpec>, <users struct>, {})}}}: 
   * Aggregate instantiates resources
@@ -53 +54 @@
 === Changes from AM API v2 ===
 This version of the AM API includes multiple changes since version 2 of the AM API. For experimenters, a few things are worth noting:
- - The old` !CreateSliver` operation has now been broken into 3 steps:
+ - The old `CreateSliver` operation has now been broken into 3 steps:
   - `Allocate` to reserve the resources
   - `Provision` to instantiate the resources, which may take time to complete
   - `PerformOperationalAction(geni_start)` to start (e.g. boot) the resources, which also may take time to complete
- - Use the intermediate `geni_allocated` state to coordinate reservations across aggregates, e.g. to ensure another aggregate can give you nodes to be the other end of a requested link
- - Multiple methods have been renamed, typically be removing the `Sliver` term from method names.
+ - Use the new intermediate `geni_allocated` state after `Allocate` to coordinate reservations across aggregates, e.g. to ensure another aggregate can give you nodes to be the other end of a requested link.
+ - Multiple methods have been renamed, typically by removing the `Sliver` term from method names.
  - Sliver expiration is available in the return from multiple other methods, like `Provision`
- - You no longer use `!ListResources` to see the contents of your slice - use `Describe` instead. `!ListResources` is only for the AM's Ad RSpec.
+ - You no longer use `ListResources` to see the contents of your slice - use `Describe` instead. `ListResources` is only for the AM's Ad RSpec.
+ - Experimenters can select when to start or stop resources, e.g. when to boot a VM. Consult the operational state machine in the AM's Ad RSpec, and use `PerformOperationalAction`.
  - SSH login names and keys should be available in manifest RSpecs in a standard format.
  - Slice name restrictions have been codified and standardized.