调用ListTagResources接口查询云企业网实例绑定的标签信息。

使用说明

在调用ListTagResources接口时,请求参数ResourceId.NTag.N.Key至少选择输入一个:

  • 如果只输入ResourceId.N,表示要查询指定云企业网实例下已经绑定的标签信息。
  • 如果只输入Tag.N.Key,表示要查询已绑定此标签键的所有云企业网实例的信息。
  • 如果同时输入ResourceId.NTag.N.Key,表示要查询指定云企业网实例下绑定的指定标签的信息。
    • 请确保ResourceId.NTag.N.Key的值相互对应,如果不对应,则返回结果为空。
    • 如果同时输入了多个标签键,则多个标签键之间为的关系。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ListTagResources

系统规定参数。取值:ListTagResources

ResourceType String cen

资源类型。取值:cen,表示云企业网实例。

NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

  • 第一次查询和没有下一次查询时,均无需填写。
  • 如果有下一次查询,取值为上一次API调用返回的NextToken值。
PageSize Integer 10

分批次查询时每批次显示的条目数。取值范围:1~50。默认值:10

ResourceId.N String cen-8z69wtwqel33lq****

云企业网实例ID。

一次最多支持输入20个云企业网实例ID。

Tag.N.Key String test

标签键。

一个标签键最多支持输入64个字符,不能以aliyunacs:开头,不能包含http://或者https://

一次最多支持输入20个标签的标签键。

Tag.N.Value String Bp

标签值。

一个标签值最多支持输入128个字符,不能以aliyunacs:开头,不能包含http://或者https://

一次最多支持输入20个标签的标签值。

返回数据

名称 类型 示例值 描述
NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值,该取值表示下一次查询开始的令牌。
RequestId String 165B5C86-2033-5954-A89D-4CD83BA06C85

请求ID。

TagResources Array of TagResource

资源及标签信息列表。

TagResource
ResourceType String CEN

资源类型。

取值:CEN,表示云企业网实例。

TagValue String Bp

标签值。

ResourceId String cen-8z69wtwqel33lq****

云企业网实例ID。

TagKey String test

标签键。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTagResources
&ResourceType=cen
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&PageSize=10
&ResourceId=["cen-8z69wtwqel33lq****"]
&Tag=[{"Key":"test","Value":"Bp"}]
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTagResourcesResponse>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <RequestId>165B5C86-2033-5954-A89D-4CD83BA06C85</RequestId>
    <TagResources>
        <ResourceType>CEN</ResourceType>
        <TagValue>Bp</TagValue>
        <ResourceId>cen-8z69wtwqel33lq****</ResourceId>
        <TagKey>test</TagKey>
    </TagResources>
</ListTagResourcesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId" : "165B5C86-2033-5954-A89D-4CD83BA06C85",
  "TagResources" : [ {
    "ResourceType" : "CEN",
    "TagValue" : "Bp",
    "ResourceId" : "cen-8z69wtwqel33lq****",
    "TagKey" : "test"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidTagKey The tag keys are not valid. 标签的Key值不合法。
400 IllegalParam.NextToken The parameter NextToken is invalid. 指定的NextToken无效。请检查参数约束,并在修改后重试。

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