Changes between Version 69 and Version 70 of GAPI_AM_API_DRAFT
- Timestamp:
- 09/19/12 12:12:50 (12 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
GAPI_AM_API_DRAFT
v69 v70 59 59 === Change Set N1: Add `geni_am_code_version` === 60 60 Aggregates 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. 61 uses `foam_version`. Automatically identifying software versions is important for monitoring and GENI operations. 62 62 63 63 This change set proposes adding `geni_am_code_version` to the return from `GetVersion`. … … 69 69 === Change Set N2: Add `geni_am_type` === 70 70 Aggregates 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 72 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. 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. 72 73 73 74 This change set proposes adding `geni_am_type` to the return from `GetVersion`. 74 75 * 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. 76 77 * Legal characters: alphanumeric 77 78 * 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.)