Updated on 2024-11-13 GMT+08:00

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.