Help Center/ Data Lake Insight/ API Reference/ APIs Related to Resource Tags/ Querying Tags of a Specified Resource Type
Updated on 2025-08-06 GMT+08:00

Querying Tags of a Specified Resource Type

Function

This API is used to query tags of a specified resource type, which refers to the collection of all resource tags within a specified project.

URI

GET /v3/{project_id}/{resource_type}/tags

Table 1 URI parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID, which is used for resource isolation. For details about how to obtain a project ID, see Obtaining a Project ID.

resource_type

Yes

String

Resource type. The options are:

  • dli_queue: queue
  • dli_elastic_resource_pool: elastic resource pool
  • dli_enhanced_datasource: enhanced datasource connection
  • dli_database: database
  • dli_package_resource: resource package (built-in resource packages with a module ID specified are not supported)
  • dli_flink_job: Flink job
Table 2 Query parameters

Parameter

Mandatory

Type

Description

limit

No

Integer

Number of records displayed on each page. The default value is 1000.

offset

No

Integer

Query result offset. The default value is 0.

Request Parameters

None

Response Parameters

Table 3 Response parameters

Parameter

Type

Description

tags

Array of objects

List of resource tags. For details, see Table 4.

count

Long

Number of tags.

Table 4 tags field data structure description

Parameter

Type

Description

key

String

Resource tag key.

values

Array of strings

List of resource tag values.

Example Request

None

Example Response

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

Status Codes

Status Code

Description

200

The modification is successful.

400

Request error.

500

Internal server error.

Error Codes

See Error Codes.