Changes between Version 34 and Version 35 of GAPI_AM_API_V3/CommonConcepts


Ignore:
Timestamp:
08/08/12 14:22:12 (12 years ago)
Author:
Aaron Helsinger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • GAPI_AM_API_V3/CommonConcepts

    v34 v35  
    3232
    3333=== `credentials` ===
    34 Many methods take an array of `credentials`. This is actually an array of structures specifying the credential type and version, as well as the actual string credential.
     34Many methods take an array of `credentials` to authorize the caller to perform the given operation with the given arguments. See [wiki:GeniApiCredentials the GENI AM API Credentials page]. This array argument is actually an array of structures specifying the credential type and version, as well as the actual string credential.
    3535{{{
    3636credentials = [
    … …  
    116116
    117117=== `urns[]` ===
    118 Several methods take some URNs to identify what to operate on. These methods are defined as accepting a list of arbitrary strings called URNs.
     118Several methods take some URNs to identify what to operate on. These methods are defined as accepting a list of arbitrary strings called URNs, which follow the [wiki:GeniApiIdentifiers GENI identifier rules].
    119119This API defines two kinds of URNs that may be supplied here, slice URNs and sliver URNs (see [wiki:GeniApiIdentifiers the GENI identifiers page]). Some aggregates may understand other URNs, but these are not defined or required here. Aggregates that accept only URNs defined by this API will return an error when given URNs not in one of those forms.
    120120This API requires that aggregates accept either a single slice URN, or 1 or more sliver URNs that all belong to the same slice. Aggregates are not required to accept both a slice URN and sliver URNs, 2 or more slice URNs, or a set of sliver URNs that crosses multiple slices. Some aggregates may choose to accept other such combinations of URNs. Aggregates that accept only arguments defined by this API will return an error when given more than 1 slice URN, a combination of both slice and sliver URNs, or a set of sliver URNs that belong to more than 1 slice.