Configuring a File System ACL

Function

This API is used to configure a file system ACL.

After an ACL is configured, the configuration takes about 30 seconds to take effect.

Authorization

Each account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned. For the specific permissions required, see Permissions Policies and Supported Actions.

URI

PUT /

**Table 1** Query parameter
Parameter	Mandatory	Type	Description
sfsacl	Yes	String	/

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Date	Yes	String	The request time.
Authorization	Yes	String	The signature information.
Host	Yes	String	The host address.

**Table 3** Request body parameter
Parameter	Mandatory	Type	Description
Statement	No	Array of Statement objects	Unique identification

**Table 4** Statement
Parameter	Mandatory	Type	Description
Sid	No	String	The statement ID.
Action	Yes	String	The allowed statement action. Enumerated values: FullControl: read/write Read: read-only
Effect	Yes	String	The effect specifying that the statement permission is Allow. Enumerated value: Allow
Condition	Yes	Condition object	The conditions for a statement to take effect.

**Table 5** Condition
Parameter	Mandatory	Type	Description
SourceVpc	Yes	String	A specified VPC ID.
VpcSourceIp	No	Array of strings	A specified IP address or IP address range. This parameter is currently not supported.

Response Parameters

This response uses common headers. For details, see Table 1.

Example Request

Configuring a file system ACL (granting the read/write permissions for IP addresses 127.0.0.1/24 and 192.168.1.85/24 in VPC 241dbf6b-dc5d-41b2-9108-ca5e56b48386):

PUT /?sfsacl HTTP/1.1
Host: examplefilesystem.sfs3.example.region.com
Date: WED, 01 Jul 2015 02:32:25 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:jZiAT8Vx4azWEvPRMWi0X5BpJMA=

{
	"Statement": [{
		"Sid": "Stmt1375240018061",
		"Action": "FullControl",
		"Effect": "Allow",
		"Condition": {
			"SourceVpc": "241dbf6b-dc5d-41b2-9108-ca5e56b48386",
			"VpcSourceIp": ["127.0.0.1/24", "192.168.1.85/24"]
		}
	}]
}

Example Response

HTTP/1.1 204 OK
Server: OBS
X-Obs-Request-Id: 0000018893B8073AC04721AA7EE3408B
X-Obs-Id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCS5QDe0QLbFNz6FXoKuXHzD2wS0eJQaj
Date: Wed, 07 Jun 2023 02:38:11 GMT