Querying Tags of All File Systems of a Tenant

Updated on 2025-04-28 GMT+08:00

View PDF

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

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.

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	The account token.
Content-Type	Yes	String	The MIME type.

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.

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

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

Status code: 200

Query response body

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

Status Code	Description
200	Query response body

Parent topic: Tag Management

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel