Reviewed-by: Miskanin, Jan <jan.miskanin@t-systems.com>
Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>

2023-09-05 08:16:37 +00:00

17 KiB

Raw Blame History

Querying Permission Rules of a File System

Function

This API is used to query the permission rules of a file system.

URI

GET /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/perm-rules

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID
share_id	Yes	String	File system ID

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Account token
Content-Type	Yes	String	MIME type

Response Parameters

Status code: 200

**Table 3** Response body parameter
Parameter	Type	Description
rules	Array of Table 4 objects	Permission rule information
count	int	Total rules

**Table 4** OnePermRuleResponseInfo
Parameter	Type	Description
id	String	Permission rule ID
ip_cidr	String	IP address or IP address range of the authorized object
rw_type	String	Read/write permission of the authorized object. The value can be rw (read and write permission), ro (read only permission), or none (no access permission). The default value is rw.
user_type	String	File system access permission granted to the user of the authorized object. The value can be no_root_squash, root_squash, or all_squash. Value no_root_squash allows the root user on the client to access the file system as root. Value root_squash allows the root user on the client to access the file system as nfsnobody. Value all_squash allows any user on the client to access the file system as nfsnobody.

Status code: 500

**Table 5** Response body parameters
Parameter	Type	Description
errCode	String	Error code Minimum length: 8 characters Maximum length: 36 characters
errMsg	String	Error message Minimum length: 2 characters Maximum length: 512 characters

Example Request

None

Example Response

Status code: 200

Successful query

{
    "rules": [
        {
            "id": "2be0cc3d-cf1e-49d5-bce3-83e91e32ff42",
            "ip_cidr": "*",
            "rw_type": "rw",
            "user_type": "no_root_squash"
        },
        {
            "id": "d56a5130-6744-4a64-866b-9dc259f5a64c",
            "ip_cidr": "188.88.88.88",
            "rw_type": "ro",
            "user_type": "no_root_squash"
        }
    ],
    "count": 2
}

Status code: 500

Error response

{ 
  "errCode" : "SFS.TURBO.0005", 
  "errMsg" : "Internal server error" 
}

Status Codes

Status Code	Description
200	Successful query
500	Error response

Parent topic: Permissions Management

17 KiB Raw Blame History