PowerScale OneFS API Reference

Copy a directory

Recursively copies a directory to a specified destination path. Symbolic links are copied as regular files.

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


Parameter Name	Description	Default	Type	Required
overwrite	Specifies if the existing file should be overwritten when a file with the same name exists.	False	Boolean	No
merge	Specifies if the contents of a directory should be merged with an existing directory with the same name.	False	Boolean	No
continue	Specifies whether to continue the copy operation on remaining objects when there is a conflict or error.	False	Boolean	No

Request headers


Header Name	Description	Default	Type	Required
x-isi-ifs-copy-source	Specifies the full path to the source directory. The source and destination must share the same access point.	None	String	Yes
x-isi-ifs-mode-mask	Copies the file/dir mode, ownership, ACL, and timestamps information along with file data	None	String	Yes

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)"
      }
   ],

}

Willkommen

Willkommen bei Dell