Help Center> Scalable File Service> API Reference> SFS Turbo APIs> Tag Management> Querying Tags of All File Systems of a Tenant
Updated on 2024-01-03 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

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 parameters

Parameter

Type

Description

tags

Array of Tag objects

Tag list

Table 4 Tag

Parameter

Type

Description

key

String

Tag key.

It can contain a maximum of 127 characters. It cannot be left blank.

Minimum: 1

Maximum: 127

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.

Minimum: 0

Maximum: 255

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.