Changes between Version 26 and Version 27 of GAPI_AM_API_V3

Timestamp:

07/17/12 15:32:13 (12 years ago)

Author:

Aaron Helsinger

Comment:

--

GAPI_AM_API_V3

@@ -242 +242 @@
 This method is part of what `ListResources` used to do in previous versions of the AM API, and is similar to ProtoGENI [http://www.protogeni.net/trac/protogeni/wiki/ComponentManagerAPIV2#Resolve `Resolve`].
 
+As described [wiki:GAPI_AM_API_V3/CommonConcepts#OperationsonIndividualSlivers here], the `geni_single_allocation` return from `GetVersion` advertises whether or not a client may invoke this method on only some of the slivers in a given `geni_allocation_state` in a given slice (default is false - the client may operate on only some of the slivers in a given state).
+
 Return: On success, the `value` field of the [wiki:GAPI_AM_API_V3/CommonConcepts#ReturnStruct return struct] will contain a struct:
 {{{
@@ -285 +287 @@
 This operation is similar to ProtoGENI's [http://www.protogeni.net/trac/protogeni/wiki/ComponentManagerAPIV2#GetTicket GetTicket] operation.
 
+As described [wiki:GAPI_AM_API_V3/CommonConcepts#OperationsonIndividualSlivers here], the `geni_single_allocation` return from `GetVersion` advertises whether or not a client may invoke this method on only some of the slivers in a given `geni_allocation_state` in a given slice (default is false - the client may operate on only some of the slivers in a given state).
+
+As described [wiki:GAPI_AM_API_V3/CommonConcepts#OperationsonIndividualSlivers here], the `geni_allocate` return from `GetVersion` advertises when a client may legally call `Allocate` (only once at a time per slice, whenever desired, or multiple times only if the requested resources do not interact).
+
 Return: On success, the `value` field of the [wiki:GAPI_AM_API_V3/CommonConcepts#ReturnStruct return struct] will contain a struct:
 {{{
@@ -331 +337 @@
 
 When `Renew` is called with `geni_best_effort` false, the entire method will fail (return non-zero code) if any requested sliver cannot be renewed to the requested time, and all slivers will keep their original expiration time. When `Renew` is called with `geni_best_effort` true, some sliver may fail to be renewed. In this case, the allocation state and expiration times do not change. `geni_error` may optionally be returned by the aggregate to explain this failure.
+
+As described [wiki:GAPI_AM_API_V3/CommonConcepts#OperationsonIndividualSlivers here], the `geni_single_allocation` return from `GetVersion` advertises whether or not a client may invoke this method on only some of the slivers in a given `geni_allocation_state` in a given slice (default is false - the client may operate on only some of the slivers in a given state).
 
 Arguments:
@@ -414 +422 @@
  - {{{geni_end_time}}}: Requested sliver expiration time
  - `struct geni_users[]`: Resource login information. See [wiki:GAPI_AM_API_V3/CommonConcepts#geni_users the Common Concepts page].
+
+As described [wiki:GAPI_AM_API_V3/CommonConcepts#OperationsonIndividualSlivers here], the `geni_single_allocation` return from `GetVersion` advertises whether or not a client may invoke this method on only some of the slivers in a given `geni_allocation_state` in a given slice (default is false - the client may operate on only some of the slivers in a given state).
 
 Return: On success, the `value` field of the [wiki:GAPI_AM_API_V3/CommonConcepts#ReturnStruct return struct] will contain a struct:
@@ -568 +578 @@
 Options include: {{{geni_best_effort}}}
 
+As described [wiki:GAPI_AM_API_V3/CommonConcepts#OperationsonIndividualSlivers here], the `geni_single_allocation` return from `GetVersion` advertises whether or not a client may invoke this method on only some of the slivers in a given `geni_allocation_state` in a given slice (default is false - the client may operate on only some of the slivers in a given state).
+
 Return: On success, the `value` field of the [wiki:GAPI_AM_API_V3/CommonConcepts#ReturnStruct return struct] will contain a list of structs: 
 {{{