/[volute]/trunk/projects/grid/vospace/doc/VOSpace2-1.html
ViewVC logotype

Diff of /trunk/projects/grid/vospace/doc/VOSpace2-1.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 2650 by major.brian, Thu Jun 5 22:55:17 2014 UTC revision 2651 by major.brian, Thu Jun 5 23:42:24 2014 UTC
# Line 108  Line 108 
108    Schaaff</a><br/>                      <a    Schaaff</a><br/>                      <a
109    href="http://www.ivoa.net/twiki/bin/view/IVOA/DougTody">Doug    href="http://www.ivoa.net/twiki/bin/view/IVOA/DougTody">Doug
110    Tody</a><br/>         <a    Tody</a><br/>         <a
111    href="http://www.ivoa.net/twiki/bin/view/IVOA/DougTody">Brian Major</a>    href="http://www.ivoa.net/twiki/bin/view/IVOA/BrianMajor">Brian Major</a>
112                  </dd>                  </dd>
113  </dl>  </dl>
114  <hr/></div>  <hr/></div>
# Line 1277  Line 1277 
1277  client is requesting endpoint URLs where it can read or write data.  client is requesting endpoint URLs where it can read or write data.
1278  </p><p>  </p><p>
1279  As an optimization, the /sync endpoint should support parameter-based  As an optimization, the /sync endpoint should support parameter-based
1280  HTTP GET transfer requests.  Instead of returning a redirect to the transferDetails,  HTTP POST transfer requests.  Instead of returning a redirect to the transfer details,
1281  the GET to /sync immediately returns the endpoint for performing the data transfer.  the parameter-based request to /sync returns the transferDetails document itself.
1282  Since there is no job created and persisted in this process, there is very little  As a further optimzation, if the parameter name value pair REQUEST=redirect is supplied,
1283  error reporting that can occur.  In the case of an error, clients may wish to fall  the /sync endpoint should issue a redirect to the first transfer endpoint that would been
1284  back to the HTTP POST to /sync and step through the entire transfer negotiation.  contained in the transfer details.  In the case of an error with the optimized
1285  This is an optimized route because it reduces two redirects that the client has to  transfers, clients may wish to fall back to the HTTP POST to /sync and step through
1286  perform in order to start the data transfer.  the entire transfer negotiation.
1287  </p><p>  </p><p>
1288  In addition, the following Nodes, appearing as part of a  In addition, the following Nodes, appearing as part of a
1289  node-path, are reserved:  node-path, are reserved:
# Line 2696  Line 2696 
2696  representation for the transfer to http://rest-endpoint/sync. The  representation for the transfer to http://rest-endpoint/sync. The
2697  assumed transport protocol is HTTP GET but transfer negotiation is possible.  assumed transport protocol is HTTP GET but transfer negotiation is possible.
2698  </p>  </p>
2699  <p>There is also an alternate, optimized convenience mode (for example, for web  <p>There is also an alternate, optimized convenience mode:</p>
2700  browser access):</p>  <ul><li>A HTTP GET to the /sync endpoint with transfer parameters in the query string will issue a redirect to the data transfer endpoint directly:
2701  <ul><li>A HTTP GET to the /sync endpoint with transfer parameters in the query string will return the data transfer endpoint directly:    <ul><li>curl -d "TARGET=vos://nvo.caltech!vospace/mydata1&DIRECTION=pullFromVoSpace&PROTOCOL=ivo://ivoa.net/vospace/core#httpget&REQUEST=redirct" "http://localhost:8000/sync"
   <ul><li>curl -d "TARGET=vos://nvo.caltech!vospace/mydata1&DIRECTION=pullFromVoSpace&PROTOCOL=ivo://ivoa.net/vospace/core#httpget" "http://localhost:8000/sync"  
2702    </ul></ul>    </ul></ul>
   <p>The assumed transfer protocol is HTTP GET and the View of the  
   node is its default value, i.e. no alternate Views are possible with  
   this mode. Note that no transfer  
   negotiation is possible with this convenience mode.</p>  
2703    <p>Other values of the URL parameter "view" may be used by individual    <p>Other values of the URL parameter "view" may be used by individual
2704    services for particular purposes, e.g., "view=rss" to identify a RSS    services for particular purposes, e.g., "view=rss" to identify a RSS
2705    feed on the resource.</p>    feed on the resource.</p>

Legend:
Removed from v.2650  
changed lines
  Added in v.2651

msdemlei@ari.uni-heidelberg.de
ViewVC Help
Powered by ViewVC 1.1.26