ListTagResources - 查询标签

更新时间:

查询标签。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ResourceTypestring

资源类型。唯一取值为 instance。

instance
ResourceIdarray

资源 ID 列表。

string

要查询资源 ID,目前只支持实例,ResourceId 和 Tag 不能同时为空。

mqtt-cn-5yd3xxx
Tagarray<object>

资源标签列表,ResourceId 和 Tag 不能同时为空。

object

标签对象。

Keystring

标签键。

test
Valuestring

标签值。

test
NextTokenstring

下一个查询开始 Token。

AAAAAaFXUH1VTHnBlds7StUakOQ=

返回参数

名称类型描述示例值
object

返回对象。

RequestIdstring

Id of the request

34063BCA-0946-49C1-B824-2ED2C905****
Codestring

响应 code。

200
Messagestring

信息

operation success.
Successstring

请求是否成功。

true
NextTokenstring

下一个查询开始 Token。

AAAAAaFXUH1VTHnBlds7StUakOQ=
TagResourcesarray<object>

资源和标签的关系列表。

TagResourceobject

TagResource 对象。

ResourceTypestring

资源类型。唯一取值为 instance。

instance
TagValuestring

标签值。

test
ResourceIdstring

资源 ID。

mqtt-cn-5yd3xxx
TagKeystring

标签键。

test

示例

正常返回示例

JSON格式

{
  "RequestId": "34063BCA-0946-49C1-B824-2ED2C905****",
  "Code": "200",
  "Message": "operation success.",
  "Success": "true",
  "NextToken": "AAAAAaFXUH1VTHnBlds7StUakOQ=",
  "TagResources": [
    {
      "ResourceType": "instance",
      "TagValue": "test",
      "ResourceId": "mqtt-cn-5yd3xxx\n",
      "TagKey": "test"
    }
  ]
}

错误码

HTTP status code错误码错误信息描述
400MqttOwnerCheckErrorFailed to validate the instance permission实例权限校验失败
400ResourceIdNotFoundresourceId does not exist.标签资源不存在
403PermissionCheckFailedFailed to verify API permissions.ram权限检查失败

访问错误中心查看更多错误码。