Querying Tags of a File System
Function
This API is used to query all tags of a specified file system.
URI
GET /v1/{project_id}/sfs-turbo/{share_id}/tags
Parameter | Mandatory | Type | Description |
---|---|---|---|
project_id | Yes | String | Project ID |
share_id | Yes | String | File system ID |
Request Parameters
Parameter | Mandatory | Type | Description |
---|---|---|---|
X-Auth-Token | Yes | String | Account token |
Content-Type | Yes | String | MIME type |
Response Parameters
Status code: 200
Parameter | Type | Description |
---|---|---|
tags | Array of ResourceTag objects | Tag list |
sys_tags | Array of ResourceTag objects | Only users with the op_service permission can obtain this field.
This field is not returned for users without the op_service permission. |
Parameter | Type | Description |
---|---|---|
key | String | Tag key. The key must be 1 to 128 characters long, cannot start or end with spaces, and cannot be an empty string. It can contain only UTF-8 letters, digits, spaces, and the following characters: _.:=+-@. |
value | String | Tag value. The value must be 0 to 255 characters long and can be an empty string. It can contain only UTF-8 letters, digits, spaces, and the following characters: _.:=+-@. |
Example Requests
Querying tags of the file system whose ID is 77ba6f4b-6365-4895-8dda-bc7142af4dde
GET HTTPS://{endpoint}/v1/v1/{project_id}/sfs-turbo/77ba6f4b-6365-4895-8dda-bc7142af4dde/tags
Example Responses
Status code: 200
Response body for query all tags of a specified file system
{"tags" : [ {"key" : "key1","value" : "value1"}, {"key" : "key2","value" : "value1"} ]}
Status Codes
Status Code | Description |
---|---|
200 | Response body for query all tags of a specified file system |
Error Codes
See Error Codes.
- Function
- URI
- Request Parameters
- Response Parameters
- Example Requests
- Example Responses
- Status Codes
- Error Codes