# 设置通用文件系统ACL - PutACL
#### 功能介绍
设置通用文件系统ACL。
![](https://support.huaweicloud.com/api-sfs/public_sys-resources/note_3.0-zh-cn.png)
通用文件系统ACL设置生效会有30s的滞后时间。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfs/sfs_02_0079.html)。
#### URI
PUT /
表1Query参数 
| 参数     | 是否必选 | 参数类型   | 描述 |
|:---|:---|:---|:---|
| sfsacl | 是    | String | /  |
   
#### 请求参数
表2请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                    |
|:---|:---|:---|:---|
| Date          | 是    | String | 请求消息时间                                                |
| Authorization | 是    | String | 请求签名信息                                                |
| Host          | 是    | String | 表明主机地址。如filesystem.sfs3.cn-north-4.myhuaweicloud.com。 |
   
 表3请求Body参数 
| 参数        | 是否必选 | 参数类型                                                                                                                    | 描述                    |
|:---|:---|:---|:---|
| Statement | 否    | Array of [Statement] objects | Unique identification |
   
表4Statement 
| 参数        | 是否必选 | 参数类型                                                                                                          | 描述                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| Sid       | 否    | String                                                                                                        | statement Id，描述statement的字符串                                                                                                                                                                                                                                                                         |
| Action    | 是    | String                                                                                                        | 本条statement作用的操作，取值范围：FullControl（读写）、Read（只读）。 枚举值： - **FullControl**  - **Read**   |
| Effect    | 是    | String                                                                                                        | 效果，指定本条statement的权限是允许，必须为Allow。 枚举值： - **Allow**                                                                                           |
| Condition | 是    | [Condition] object | 本条statement生效的条件。                                                                                                                                                                                                                                                                                    |
   
 表5Condition 
| 参数          | 是否必选 | 参数类型             | 描述                   |
|:---|:---|:---|:---|
| SourceVpc   | 是    | String           | 指定VPC的VPCid。         |
| VpcSourceIp | 否    | Array of strings | 指定的IP或IP范围（暂不支持该参数）。 |
   
#### 响应参数
该请求的响应消息使用公共消息头，具体请参考 [表1](https://support.huaweicloud.com/api-sfs/sfs_02_0106.html#sfs_02_0106__zh-cn_topic_0000001263068826_d0e686)。
#### 请求示例
设置通用文件系统ACL，授予读写权限，VPC ID为"241dbf6b-dc5d-41b2-9108-ca5e56b48386"，IP范围为\["127.0.0.1/24", "192.168.1.85/24"\]。
```
PUT /?sfsacl HTTP/1.1
Host: examplefilesystem.sfs3.cn-north-4.myhuaweicloud.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"]
}
}]
}
```
#### 响应示例
```
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
```
#### 状态码
| 状态码 | 描述            |
|:---|:---|
| 204 | 设置通用文件系统ACL成功 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-sfs/sfs_02_0119.html)。