Changeset 2dafa0c for fedd/fedd_messages.wsdl

Timestamp:

Nov 6, 2008 9:18:37 PM (15 years ago)

Author:

Ted Faber <faber@…>

Branches:

axis_example, compt_changes, info-ops, master, version-1.30, version-2.00, version-3.01, version-3.02

Children:

4ed10ae

Parents:

9c166cf

Message:

content in the WSDL comments

File:

• fedd/fedd_messages.wsdl (modified) (7 diffs)

fedd/fedd_messages.wsdl

@@ -7 +7 @@
   xmlns="http://schemas.xmlsoap.org/wsdl/">
 
+  <!--
+  The message definitions are all simple embeddings of one of the types
+  from fedd_types.xsd 
+  -->
   <message name="RequestAccessRequestMessage">
     <part name="RequestAccessRequestBody" type="xsd1:requestType"/>
@@ -63 +67 @@
     <operation name="RequestAccess">
       <documentation>
-        Fill this in 
+        Request access to a testbed.  The request includes the various
+        resources needed (loosely), the identity of the requester, access
+        credentials andscheduling information.  A successful response includes
+        enough information for the federation system to access the testbed and
+        actually request resources.
       </documentation>
       <input message="tns:RequestAccessRequestMessage"/>
@@ -71 +79 @@
     <operation name="Create">
       <documentation>
-        Fill this in 
+        A request to create a federated experiment from the included
+        description.  Credentials and access information is also provided.  On
+        success a logical description of the experiment is returned as well as
+        the information about federated testbeds needed to access local
+        services.
       </documentation>
       <input message="tns:CreateRequestMessage"/>
@@ -79 +91 @@
     <operation name="Vtopo">
       <documentation>
-        Fill this in 
+        A request for the virtual topology of the experiment.  Requesters with
+        different access rights may receive different information.
       </documentation>
       <input message="tns:VtopoRequestMessage"/>
@@ -87 +100 @@
     <operation name="Vis">
       <documentation>
-        Fill this in 
+        A request for the visualization of the experiment.  This is really a
+        legacy interface for visual tools that cannot generate their own
+        visualization.  Requesters with different access rights may receive
+        different information.
       </documentation>
       <input message="tns:VisRequestMessage"/>
@@ -95 +111 @@
     <operation name="Info">
       <documentation>
-        Fill this in 
+        A one-stop request for meta-data on the experiment.  Includes all the
+        info from a Vtopo and a Vis request.
       </documentation>
       <input message="tns:InfoRequestMessage"/>
@@ -103 +120 @@
     <operation name="Terminate">
       <documentation>
-        Fill this in 
+        Stop this experiment and deallocate its resources.
       </documentation>
       <input message="tns:TerminateRequestMessage"/>