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

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.

URI

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

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

limit

No

Integer

Number of returned tags

offset

No

Integer

Tag query offset

Request Parameters

Table 3 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 4 Response body parameters

Parameter

Type

Description

tags

Array of Tag objects

Tag list

Table 5 Tag

Parameter

Type

Description

key

String

Tag key.

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

values

Array of strings

Tag values. Each value can contain a maximum of 255 characters. An empty list of values can match with any value. All values of a tag key are in the OR relationship.

Example Requests

Query 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

Response body for querying a file system

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

Status Codes

Status Code

Description

200

Response body for querying a file system

Error Codes

See Error Codes.