doc-exports/docs/sfs/api-ref/sfs_02_0117.html

Obtaining File System ACL Information

Function

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

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

Status Codes

Status Code	Description
200	The file system ACL is obtained.

Error Codes

See General Purpose File System Error Codes.

Parent topic: File System Access Rules