Changes between Version 69 and Version 70 of GAPI_AM_API_DRAFT


Ignore:
Timestamp:
09/19/12 12:12:50 (12 years ago)
Author:
Aaron Helsinger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GAPI_AM_API_DRAFT

    v69 v70  
    5959=== Change Set N1: Add `geni_am_code_version` ===
    6060Aggregates use varying ways to identify the software version their AM uses. PlanetLab and ProtoGENI use `code_tag`, Orca uses `orca_version`, and FOAM
    61 uses `foam_version`. Automatically identifying software versions is important for monitoring and GENI operations.
     61uses `foam_version`. Automatically identifying software versions is important for monitoring and GENI operations. 
    6262
    6363This change set proposes adding `geni_am_code_version` to the return from `GetVersion`.
     
    6969=== Change Set N2: Add `geni_am_type` ===
    7070Aggregates are allowed to include AM specific return values, or even implement custom methods as part of the same interface.
    71 Currently, there is no consistent way to identify what type of aggregate a given instance is, so as to know what additional attributes or options may be used.
     71
     72Currently, there is no consistent way to identify what type of aggregate a given instance is, so as to know what additional attributes or options may be used.  This proposal would add a way for aggregates to identify what kind of aggregate this is, and therefore what aggregate specific options or returns are applicable. Aggregates of aggregates may identify as multiple types. One of those types would indicate that this is such an aggregate of aggregates, and other listed types would indicate that clients may interact with the aggregate as though it is any of the listed types.
    7273
    7374This change set proposes adding `geni_am_type` to the return from `GetVersion`.
    7475 * The field is required.
    75  * The value is a string.
     76 * The value is a list of strings, of length at least one. It should generally be a list of length 1. Aggregates of aggregates may list multiple types.
    7677 * Legal characters: alphanumeric
    7778 * Values should be one of the defined geni AM types if applicable, as defined by the AM API [http://groups.geni.net/wiki/attachment/GAPI_AM_API_V3/CommonConcepts/geni-am-types.xml geni-am-types.xml]. (As of this proposal, one of `orca`, `foam`, `protogeni`, `sfa`. More GENI AM types may be added in the future.)