diff --git a/federation-am-api.adoc b/federation-am-api.adoc index 0ed6813..ab5d4fe 100644 --- a/federation-am-api.adoc +++ b/federation-am-api.adoc @@ -53,14 +53,14 @@ This section compares the methods of this API to other API's, such as the link:h In particular, the notable differences with the link:http://groups.geni.net/geni/wiki/GAPI_AM_API_V3[Geni AM v3 API], on which this API is based, are listed. General differences, like replacing the +geni_+ prefix with a colon +:+ are not mentioned for each command. <>:: - ProtoGENI;; The +GetVersion+ methods have a same name and purpose, but the information returned is in a completely different format. - Geni AM v2 API;; This is the same as +GetVersion+ but contains more information. - Geni AM v3 API;; This is mostly the same, however, the format is not compatible due to dropping the +geni_+ prefix. Also, some extra info is added by this API: +:am_code_version+ and +:am_type+ + ProtoGENI;; The +GetVersion+ method has the same name and purpose, but the information returned is in a completely different format. + Geni AM v2 API;; +GetVersion+ is mostly the same, but int this API a lot more information is returned. + Geni AM v3 API;; The +GetVersion+ call is still mostly the same, however, the format is not compatible due to dropping the +geni_+ prefix in this API. Also, some extra info is added by this API: +:am_code_version+ and +:am_type+ <>:: ProtoGENI;; This operation is similar to the +GetTicket+ operation. Geni AM v2 API;; This is the first part of what +CreateSliver+ does. The second part is done by <>, and the final part is done by <>. So +CreateSliver+ also provisions the resources, and 'starts' them. - Geni AM v3 API;; This API changes +rspec_version+ into a mandatory argument instead of a mandatory option. + Geni AM v3 API;; This API changes +rspec_version+ into a mandatory argument instead of a mandatory option. <>:: ProtoGENI;; This operation is similar to the +RedeemTicket+ method. @@ -77,11 +77,10 @@ In particular, the notable differences with the link:http://groups.geni.net/geni Geni AM v2 API;; This method is what +ListResources+ does when called without a slice URN argument. Geni AM v3 API;; This API changes +rspec_version+ into a mandatory argument instead of a mandatory option. - <>:: ProtoGENI;; This operation is similar to the +Resolve+ method. Geni AM v2 API;; This method is what +ListResources+ does when called with a slice URN argument. - Geni AM v3 API;; This API changes +rspec_version+ into a mandatory argument instead of a mandatory option. + Geni AM v3 API;; This API changes +rspec_version+ into a mandatory argument instead of a mandatory option. When given a slice URN without slivers, the return value in AMv3 needed to be an empty RSpec, while this API requires that a SEARCHFAILED error is returned. <>:: ProtoGENI;; This operation is similar to the +SliverStatus+ method.