Obtaining File System ACL Information

Function

This API is used to obtain the ACL information of a file system.

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

GET /

**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.

Response Parameters

Status code: 200

**Table 3** Response body parameter
Parameter	Type	Description
Statement	Array of Statement objects	Unique identification

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

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

Example Request

GET /?sfsacl HTTP/1.1
Host: example-sfs-01.sfs3.example.region.com:443
Date: Wed, 07 Jun 2023 03:31:46 GMT
Authorization: OBS FNEX1B77SXDIB3TFMSZZ:eUqPlHnPDWGDTlgyLmsALA86wys=

Example Response

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": ""
        }
    ]
}