Updated on 2023-08-29 GMT+08:00

Listing Tags of an Instance

Function

This API is used to query instance tags.

URI

GET /v2/{project_id}/kafka/{instance_id}/tags

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details about how to obtain it, see Obtaining a Project ID.

instance_id

Yes

String

Instance ID.

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

tags

Array of TagEntity objects

Tag list.

Table 3 TagEntity

Parameter

Type

Description

key

String

Key.

A key can contain 1 to 128 characters.

Include UTF-8 letters, digits, spaces, or the following special characters _.:=+-@

Do not use spaces to start or end the key.

value

String

Value.

A value can contain 0 to 255 characters.

Include UTF-8 letters, digits, spaces, or the following special characters _.:/=+-@

A value can be an empty string.

Example Requests

GET https://{endpoint}/v2/{project_id}/kafka/{instance_id}/tags

Example Responses

Status code: 200

The instance tags are listed successfully.

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

Status Codes

Status Code

Description

200

The instance tags are listed successfully.

Error Codes

See Error Codes.