Help Center/ Scalable File Service Turbo/ API Reference/ API/ Tag Management/ Querying Tags of All File Systems of a Tenant
Updated on 2025-11-14 GMT+08:00
View PDF

Querying Tags of All File Systems of a Tenant

Function

This API is used to query the tags of all file systems of a tenant.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

URI

GET /v1/{project_id}/sfs-turbo/tags

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

The project ID.
Table 2 Query Parameters

Parameter

Mandatory

Type

Description

limit

No

Integer

The maximum number of tags that can be returned.

offset

No

Integer

The tag query offset.

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

The account token.

Content-Type

Yes

String

The MIME type.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

tags

Array of Tag objects

The tag list.
Table 5 Tag

Parameter

Type

Description

key

String

The tag key.

A key can contain a maximum of 128 characters and cannot be left blank.

values

Array of strings

The list the tag values. Each value can contain a maximum of 255 characters. An empty list for values indicates any value. The values are in the OR relationship.

Example Requests

Querying tags of all file systems in the project whose ID is e1e45b08f3ea4480ab4655ef9c7160ba

GET HTTPS://{endpoint}/v1/e1e45b08f3ea4480ab4655ef9c7160ba/sfs-turbo/tags

Example Responses

Status code: 200

Query response body

{
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "" ]
  }, {
    "key" : "key2",
    "values" : [ "value1", "value2" ]
  } ]
}

Status Codes

Status Code

Description

200

Query response body

Error Codes

See Error Codes.

Parent topic: Tag Management