PowerScale OneFS API Reference

Set attributes on a directory

Sets attributes on a specified directory with the metadata query argument. You can also set attributes with a header when the directory is created with the header format x-isi-ifs-<name>=<value>.

Request syntax

PUT /namespace/<access_point>/<container_path>?metadata HTTP/1.1
Host <hostname>[:<port>]
Content-Length : <length>
Content-Type : application/JSON
Date: <date>
Authorization: <signature>

{
   "action":"<action_value>",
   "attrs":[
      {
         "name":"<key_name>",
         "value":"<key_value>",
         "namespace":"<namespace_value>",
         "op":"<operation_value>"
      },
      ...
   ]
}

NOTE:

You can omit attribute values or enter "" for the value.

Request query parameters


Parameter Name	Description	Default	Type	Required
metadata	The metadata argument must be placed at the first position of the argument list in the URI.	N/A	String	No

Request body parameters


Parameter Name	Description	Default	Type	Required
action	The values for the `<action_value>` field are replace or update. Note that the `<action_value>` field operates in conjunction with the `<operation_value>` field. To modify the existing attributes, set both `<action_value>` and`<operation_value>` to update. To delete the existing attributes, set `<action_value>` to update and `<operation_value>` to delete. To remove all extended attributes first, and then replace the attributes with the values that are specified in the attrs parameter, set `<action_value>` to replace. When `<action_value>` is set to replace, the `<operation_value>` field is ignored.	update	String	No
op	The values for the `<operation_value>` field are update or delete. The `<operation_value>` field is only applicable when `<action_value>` is set to update.	update	String	No
namespace	Specifies the namespace that is associated with the attributes set for the directory. The only supported value for this parameter is user.	user	String	No

Request headers

This call sends common request headers.

Response headers

This call returns common response headers.

Response body

No message body is returned upon success.

Example request

PUT /namespace/ifs/my_folder/?metadata HTTP/1.1
Host my_cluster:8080
Content-Length : <length>
Date: <date>
Authorization: <signature>

{
   "action":"replace",
   "attrs":[
      {
         "name":"Manufacture",
         "value":"Foo",
         "namespace":"user"
      }
   ]
}

Example response

HTTP/1.1 200 OK
Date:  Wed, 20 Mar 2013 17:19:15 GMT
Server:  Apache/2.2.21 (FreeBSD) mod_ssl/2.2.21 OpenSSL/0.9.8x mod_webkit2/1.0 mod_fastcgi/2.4.6
Allow:  DELETE, GET, HEAD, POST, PUT
x-isi-ifs-spec-version:  1.0
Vary:  Accept-Encoding
Content-Encoding:  gzip
Keep-Alive:  timeout=15, max=500
Connection:  Keep-Alive
Transfer-Encoding:  chunked
Content-Type:  text/plain

Welcome

Welcome to Dell