Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.
Sign In Create an Account Dell Financial Services Premier Sign In Partner Program Sign In
Contact Us

Your Dell.com Carts

PowerScale OneFS API Reference

PDF

Set the ACL for a file when the file is created

Sets the access control list for a file by setting the headers when the file is created.

Request syntax

PUT /namespace/<access_point>/<container_path>/<file_name> HTTP/1.1
Host: <hostname>[:<port>]
Content-Length: <length>
Date: <date>
Authorization: <signature>
x-isi-ifs-access-control : "private_read" | "private" | "public_read" | "public_read_write" | "public" | "<POSIX mode>"
NOTE:

The attribute x-isi-ifs-access-control can be set to a predefined ACL value or to POSIX mode with octal string. By default, the mode for the file is set to 0600.

Predefined ACL value Access rights Access rights displayed
private_read The file owner has the following rights: read files, read attributes, read extended attributes, read access control lists, run files, and write access control list. File owner: "accessrights":["file_gen_read","file_gen_execute","std_write_dac"],"inherit_flags":[]
private The file owner has the following rights: read file, read attributes, read extended attributes, read access control list, write to the file, append to the file, write file attributes, write extended file attributes, run file, write, or modify the access control list, change owner, and delete current file. File owner:"accessrights":["file_gen_all"],"inherit_flags":[]
public_read The file owner has the following rights: read file, read attributes, read extended attributes, read access control list, write to the file, append to the file, write file attributes, write extended file attributes, run file, write, or modify the access control list, change owner, and delete current file.

All users have the following rights: read files, read attributes, read extended attributes, read access control lists, and run files.

File owner: "accessrights":["file_gen_all"],"inherit_flags":[]

All users: "accessrights":["file_gen_read","file_gen_execute"],"inherit_flags":[]

public_read_write The file owner has the following rights: read file, read attributes, read extended attributes, read access control list, write to the file, append to the file, write file attributes, write extended file attributes, run file, write/modify the access control list, change owner, and delete current file.

All users have the following rights: read files, read attributes, read extended attributes, read access control lists, write to the file, append to the file, write file attributes, write extended file attributes, and run files.

File owner: "accessrights":["file_gen_all"],"inherit_flags":[]

All users: "accessrights":["file_gen_read","file_gen_write","file_gen_execute"],"inherit_flags":[]

public All users have the following rights: read file, read attributes, read extended attributes, read access control list, write to the file, append to the file, write file attributes, write extended file attributes, run file, write/modify the access control list, change owner, and delete current file. All users: "accessrights":["file_gen_all"],"inherit_flags":[]

The POSIX mode is an absolute mode, which consists of an octal number that is constructed from the sum of one or more octal numbers that are listed in the following table.

Octal number Description
4000 The set-user-ID-on-execution bit. Executable files with this bit have their uid set to the uid of the file owner.
2000 The set-group-ID-on-execution bit. Executable files with this bit have their gd set to the gid of the file owner.
1000 The sticky bit.
0400 Allows read by owner.
0200 Allows write by owner.
0100 For files, allows execution by owner. For directories, allows directory queries by owner.
0040 Allows read by group members.
0020 Allows write by group members.
0010 For files, allows execution by group members. For directories, allows directory queries by group member.
0004 Allows read by others.
0002 Allows write by others.
0001 For files, allows execution by others. For directories, allows directory queries by others.

Request query parameters

There are no query parameters for this request.

Request headers

This call sends common request headers.

Response headers

This call returns common response headers.

Response body

There is no message body for this response.

Example request

PUT /namespace/ifs/dir1/dir2/file HTTP/1.1
Host: my_cluster:8080
Content-Length: <length>
Date: Tue, 22 May 2012 12:00:00 GMT
Authorization: <signature>
x-isi-ifs-access-control: "public_read"

Example response

HTTP/1.1 200 OK
Date: Tue, 22 May 2012 12:00:00 GMT
Content-Length: <length>
Connection: close
Server: Apache2/2.2.19

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\