Changes between Version 10 and Version 11 of GeniGet

Timestamp:

11/13/13 16:15:29 (10 years ago)

Author:

Aaron Helsinger

Comment:

--

GeniGet

@@ -65 +65 @@
 $ ./geni-get commands
 {
- "client_id":    "Return the client-specified sliver ID",
+ "client_id":    "Return the experimenter-specified client_id for this node",
  "commands":     "Show all available commands",
- "control_mac":  "Show the MAC address of the control interface",
- "geni_user":    "Show user accounts and public keys",
- "getversion":   "Report the AM version",
- "manifest":     "Show the sliver manifest",
- "slice_email":  "Retrieve the e-mail address from the slice certificate",
- "slice_urn":    "Show the URN of the slice",
- "sliverstatus": "Give the current status of the sliver (AM API v2)",
- "status":       "Give the current status of the sliver (AM API v3)",
- "user_email":   "Show the e-mail address of the sliver creator",
- "user_urn":     "Show the URN of the sliver creator"
+ "control_mac":  "Show the MAC address of the control interface on this node",
+ "geni_user":    "Show user accounts and public keys installed on this node",
+ "getversion":   "Report the output of 'getversion' from the aggregate that allocated this node",
+ "manifest":     "Show the manifest RSpec for the local reservation",
+ "slice_email":  "Retrieve the e-mail address from the slice certificate that owns this node",
+ "slice_urn":    "Show the URN of the slice that owns this node",
+ "sliverstatus": "Give the current status of this sliver (AM API v2)",
+ "status":       "Give the current status of this sliver (AM API v3)",
+ "user_email":   "Show the e-mail address of this sliver's creator",
+ "user_urn":     "Show the URN of this sliver's creator"
 }
 }}}
@@ -140 +140 @@
 
 == getversion ==
-Return the return from the amapi getversion command for the latest AM API revision supported, in JSON format. Note that not every element from the AM API getversion call is required to be returned here, but all are allowed and more are encouraged.
+Return the return from the GENI AM API `getversion` command for the latest AM API revision supported, in JSON format. Note that not every element from the AM API `getversion` call is required to be returned here, but all are allowed and more are encouraged.
+
+'''FIXME: Which selected fields are returned here? If this is a full getversion return, then which AM API version# is used? The one you used to make the reservation?'''
 
 Example:
@@ -190 +192 @@
 Return the AM API v2 return from `sliverstatus` for this slice (see http://groups.geni.net/geni/wiki/GAPI_AM_API_V2#SliverStatus), a JSON struct.
 
+'''FIXME: For just the current resource (plus an overall status)? Or for all resources at this AM?'''
+
 Example:
 {{{
@@ -198 +202 @@
 == status ==
 Return the AM API v3 `status` return. Only supported if the AM supports AM API v3. See http://groups.geni.net/geni/wiki/GAPI_AM_API_V3#Status
-''' FIXME: For only the current sliver? Or for all resources at this AM?'''
+''' FIXME: For only the current sliver? Or for all resources at this AM? If only for this sliver, then the status should also include a slice-overall status.'''
 
 Example: