Changes between Version 20 and Version 21 of GAPI_AM_API_V3/CommonConcepts


Ignore:
Timestamp:
05/23/12 15:13:20 (12 years ago)
Author:
Aaron Helsinger
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GAPI_AM_API_V3/CommonConcepts

    v20 v21  
    165165AMs may have their own operational states/state-machine internally. AMs are however required to advertise such states and actions that experimenters may see or use, by using an advertisement RSpec extension (if an AM does not advertise operational states, then tools can not know whether any actions are available). Operational states which the experimenter never sees, need not be advertised. Operational states and actions are generally by resource type. The standard RSpec extension attaches such definitions to the `sliver_type` element of RSpecs.
    166166
     167The standard advertisement RSpec extension for advertising operational states and actions can be found [http://www.protogeni.net/resources/rspec/ext/opstate/1 here], with an example with comments [https://www.protogeni.net/trac/protogeni/wiki/RspecAdOpState here].
     168
    167169States should be defined in terms of
    168170 a. whether the resource is accessible to the experimenter (on either the data or control planes),
     
    201203
    202204AMs may have their own operational states/state-machine internally. AMs are however required to advertise such states and actions that experimenters may see or use, by using an advertisement RSpec extension (if an AM does not advertise operational states, then tools can not know whether any actions are available). Operational states which the experimenter never sees, need not be advertised. Operational states and actions are generally by resource type. The standard RSpec extension attaches such definitions to the `sliver_type` element of RSpecs.
     205
     206The standard advertisement RSpec extension for advertising operational states and actions can be found [http://www.protogeni.net/resources/rspec/ext/opstate/1 here], with an example with comments [https://www.protogeni.net/trac/protogeni/wiki/RspecAdOpState here].
    203207
    204208Tools must use the operational states and actions advertisement to determine what operational actions to offer to experimenters, and what actions to perform for the experimenter. Tools may choose to offer actions which the tool itself does not understand, relying on the experimenter to understand the meaning of the new action.