Changes between Version 62 and Version 63 of GAPI_AM_API_DRAFT


Ignore:
Timestamp:
09/12/12 14:54:02 (12 years ago)
Author:
Aaron Helsinger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GAPI_AM_API_DRAFT

    v62 v63  
    5858
    5959=== Change Set N1: Add `geni_am_version` ===
    60 Aggregates use varying ways to identify the software version their AM uses. SFA and PG use `code_tag`, Orca uses `orca_version`, and FOAM
     60Aggregates use varying ways to identify the software version their AM uses. PlanetLab and ProtoGENI use `code_tag`, Orca uses `orca_version`, and FOAM
    6161uses `foam_version`. Automatically identifying software versions is important for monitoring and GENI operations.
    6262
     
    7575 * The value is a string.
    7676 * Legal characters: alphanumeric
    77  * 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]. (E.G. one of `orca`, `foam`, `protogeni`, `sfa`.)
     77 * 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.)
    7878
    7979=== Change Set N3: Use consistent types and prefixes ===
     
    9292 * The value is a string.
    9393 * Legal characters: alphanumeric
    94  * 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]. (E.G. one of `orca`, `foam`, `protogeni`, `sfa`.)
     94 * 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.)
    9595
    9696Aggregate specific options and return attributes should be named with a prefix denoting the aggregate type. It should be the same as the `am_type` and `geni_am_type` for this aggregate. Therefore, character restrictions are:
    9797 * The value is a string.
    9898 * Legal characters: alphanumeric
    99  * 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]. (E.G. one of `orca`, `foam`, `protogeni`, `sfa`.)
     99 * 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.)
    100100
    101101== Change Set O: Refine character restrictions ==
     
    106106
    107107'''Slice''':
    108  * Slice names are <=19 characters, only alphanumeric plus hyphen, underscore, period, or colon (alphanumeric only in first character): '^[a-zA-Z0-9][-\._:a-zA-Z0-9]\{0,18\}$'
     108 * Slice names are <=19 characters, only alphanumeric plus hyphen, underscore, period, or colon (alphanumeric only in first character): `'^[a-zA-Z0-9][-\._:a-zA-Z0-9]\{0,18\}$'`
    109109
    110110'''Sliver''':
     
    117117
    118118 1. From `getversion` and `listresources` and `describe`, the RSpec `type`:
    119 May use only alphanumeric characters plus hyphen, underscore, period, or colon; alphaumeric only in first character. `'^[a-zA-Z0-9][a-zA-Z0-9-_\.:]*$'`
     119     May use only alphanumeric characters plus hyphen, underscore, period, or colon; alphaumeric only in first character. `'^[a-zA-Z0-9][a-zA-Z0-9-_\.:]*$'`
    120120
    121121 2. From `getversion` and `listresources` and `describe`, the RSpec `version`:
    122 May use only alphanumeric characters plus hyphen, underscore, period, or colon; alphaumeric only in first character. `'^[a-zA-Z0-9][a-zA-Z0-9-_\.:]*$'`
     122     May use only alphanumeric characters plus hyphen, underscore, period, or colon; alphaumeric only in first character. `'^[a-zA-Z0-9][a-zA-Z0-9-_\.:]*$'`
    123123
    124124 3. From `getversion`, the RSpec `schema`, and `namespace`: Any character valid in a URL (see e.g. http://www.w3.org/Addressing/URL/url-spec.txt)
    125125
    126126 4. From `getversion` and the `credentials` argument, the credential `geni_type`:
    127 May use only alphanumeric characters plus hyphen, underscore, period, or colon; alphaumeric only in first character. `'^[a-zA-Z0-9][a-zA-Z0-9-_\.:]*$'`
     127     May use only alphanumeric characters plus hyphen, underscore, period, or colon; alphaumeric only in first character. `'^[a-zA-Z0-9][a-zA-Z0-9-_\.:]*$'`
    128128
    129129 5. From `getversion` and the `credentials argument, the credential `geni_version`:
    130 May use only alphanumeric characters plus hyphen, underscore, period, or colon; alphaumeric only in first character. `'^[a-zA-Z0-9][a-zA-Z0-9-_\.:]*$'`
     130     May use only alphanumeric characters plus hyphen, underscore, period, or colon; alphaumeric only in first character. `'^[a-zA-Z0-9][a-zA-Z0-9-_\.:]*$'`
    131131
    132132 6. From `getversion`, `geni_allocate`: alphanumeric