ListTagResources

Updated at:

Retrieves the list of resource labels.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET /v1/tags HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

ResourceType

string

No

The resource type.

Gateway

ResourceId

array

No

The resource ID. You can specify up to 50 subkeys.

["gw-xxx","gw-yyy"]

string

No

string

["gw-xxx","gw-yyy"]

Tag

array<object>

No

The list of labels to add. You can specify up to 20 subkeys.

[{"key":"env","value":"prod"}]

object

No

object

Key

string

No

The label key.

env

Value

string

No

The label value.

prod

NextToken

string

No

The token that determines the start point of the next query.

caeb235b-xxx

Response elements

Element

Type

Description

Example

object

NextToken

string

The token that determines the start point of the next query. An empty value of NextToken indicates that no more results exist.

caeb235b-xxx

RequestId

string

The request ID.

59F86F37-787A-52DB-9475-DB5A255517F0

TagResources

array<object>

The list of resources.

object

object

ResourceType

string

The resource type.

gateway

TagValue

string

The label value.

prod

ResourceId

string

The resource ID.

gw-xxx

TagKey

string

The label key.

env

Examples

Success response

JSON format

{
  "NextToken": "caeb235b-xxx",
  "RequestId": "59F86F37-787A-52DB-9475-DB5A255517F0",
  "TagResources": [
    {
      "ResourceType": "gateway",
      "TagValue": "prod",
      "ResourceId": "gw-xxx",
      "TagKey": "env"
    }
  ]
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.