
# 获取通用文件系统ACL - GetACL
#### 功能介绍
获取通用文件系统ACL。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfs/sfs_02_0079.html)。
#### URI
GET /
表1Query参数 
| 参数     | 是否必选 | 参数类型   | 描述 |
|:---|:---|:---|:---|
| sfsacl | 是    | String | /  |
   
#### 请求参数
表2请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                    |
|:---|:---|:---|:---|
| Date          | 是    | String | 请求消息时间                                                |
| Authorization | 是    | String | 请求签名信息                                                |
| Host          | 是    | String | 表明主机地址。如filesystem.sfs3.cn-north-4.myhuaweicloud.com。 |
   
#### 响应参数
**状态码： 200**
 表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范围（暂不支持该参数）。 |
   
#### 请求示例
```
GET /?sfsacl HTTP/1.1
Host: example-sfs-01.sfs3.cn-east-3.myhuaweicloud.com:443
Date: Wed, 07 Jun 2023 03:31:46 GMT
Authorization: OBS FNEX1B77SXDIB3TFMSZZ:eUqPlHnPDWGDTlgyLmsALA86wys=
```
#### 响应示例
```
HTTP/1.1 200 OK
Server: OBS
Content-Type: application/json
Content-Length: 131
Date: Wed, 07 Jun 2023 03:31:59 GMT
X-Obs-Request-Id: 0000018893E94B65C046B527778F8F14
X-Obs-Id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSc2lEdSHcA04319WknB1DD5BdBKuGr1
{
    "Statement": [
        {
            "Condition": {
                "SourceVpc": "f85adabc-a387-4d1d-94cf-65ef9034f752"
            },
            "Action": "FullControl",
            "Effect": "Allow",
            "Sid": ""
        }
    ]
}
```
#### 状态码
| 状态码 | 描述            |
|:---|:---|
| 200 | 获取通用文件系统ACL成功 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-sfs/sfs_02_0119.html)。
