= Federation Information and Operation Interface =

The current {{{fedd}}} implementation creates and terminates multi-testbed topologies with minimal facilities for managing the elements that make up the topology.  This page describes the emerging interfaces that will provide information about the resources and their status as well as access to infrastructure-level operations on the elements.

A topology is made up of ''elements'' and ''substrates'' that interconnect them.  Elements are owned by testbeds, interconnected by substrates that may span testbeds.  Two elements on the same substrate can communicate in some way.  Testbeds, substrates, and elements all support services and operations.  [FeddAbout#ExperimentServices Services] provide features to experimental environments, such as file service and authorization information.  Operations manipulate elements, substrates, testbeds or the services they provide.

Operations and services are discovered through the info interface and manipulated through the operation interface.

== Experiment Controller Interfaces ==

The experiment controller info interface returns information to a user about the elements in their experiment, their status, and the operations supported by the elements.  Those operations can be invoked by through the operation interface.

=== Info Interface ===

The info interface is broken into three sections, '''Testbed''', '''Element''', and '''Substrate'''.  The '''Testbed''' section tells which testbeds have given elements to the topology.  They are identified by the name the experiment controller knows them by and include the [FeddAbout#ExperimentServices services] used by the testbed and any operations that the testbed supports.  Similarly the substrate and element sections describe the current state of the object, the testbed(s) to which it is bound and the services and operations it supports.

The current data returned by the interface includes:

 * Testbeds
   * name
   * services (format below)
   * operations (format below)
 * Elements
   * testbed
   * local name
   * logical/topology name
   * status
   * services (format below)
   * operations (format below)
 * Substrates
   * testbed(s)
   * local name(s)
   * logical/topology name
   * status
   * services (format below)
   * operations (format below)