PowerScale OneFS API Reference

Request syntax

PUT /namespace/<access_point>/<container_path> HTTP/1.1
x-isi-ifs-copy-source: /namespace/<access_point>/<source_path>
Host <hostname>[:<port>]
Date: <date>
Authorization: <signature>

Request query parameters

Request headers

Response headers

This call returns common response headers.

Response body

No message body is returned upon success.

For this operation, the HTTP status code 200 OK does not always indicate a complete success. If the response body contains a JSON message, the operation has partially failed, and the error message is reported in a structured JSON array.

If the server fails to initiate a copy due to an error (such as an invalid copy source), an error is returned. If the server initiates the copy, and then fails, "copy_errors" are returned in structured JSON format.

Because the copy operation is synchronous, the client cannot stop an ongoing copy or check the status of a copy asynchronously.

Example request 1

PUT /namespace/ifs/dest1/ / HTTP/1.1
x-isi-ifs-copy-source: /namespace/ifs/src1/
Host my_cluster:8080
Content-Length: <length>
Date: Thu, 22 Sep 2011 12:00:00 GMT
Authorization: <signature>

Example response 1

HTTP/1.1 200 Ok
Date: Thu, 22 Sep 2011 12:00:00 GMT
Server: Apache2/2.2.19
Content-Encoding: gzip
x-isi-ifs-spec-version: 1.0
Connection: Keep-Alive
Transfer-Encoding: chunked
Content-Type: text/plain

Example request 2

In this example, the directory 'src1' contains files {f1, f2, f3, f4} and the directory 'dest1' exists and contains files {f1, f2}.

PUT /namespace/ifs/dest1/?merge=true&continue=true HTTP/1.1
x-isi-ifs-copy-source: /namespace/ifs/src1/
Host my_cluster:8080
Content-Length: <length>
Date: Thu, 22 Sep 2011 12:00:00 GMT
Authorization: <signature>

Example response 2

HTTP/1.1 200 OK
Date: Thu, 22 Sep 2011 12:00:00 GMT
Server: Apache2/2.2.19
x-isi-ifs-spec-version: 1.0
Connection: Keep-Alive
Transfer-Encoding: chunked
Content-Type: application/json

{
   "copy_errors":[
      {
         "source":"/ap1/src1/f1",
         "target":"/ap1/dest1/f1",
         "error_src":"target side",
         "message":"target exists(not copied)",

      },
      {
         "source":"/ap1/src1/f2",
         "target":"/ap1/dest1/f2",
         "error_src":"target side",
         "message":"target exists(not copied)"
      }
   ],

}