ListTagResources

调用ListTagResources查询一个或多个网关已经绑定的标签列表。

请求参数

名称

类型

是否必选

示例值

描述

Action String ListTagResources

系统规定参数。取值:ListTagResources

RegionId String cn-hangzhou

地域ID,可以通过接口DescribeRegions查看可用的地域ID。

ResourceRegionId String cn-hangzhou

资源区域ID。

ResourceType String GATEWAY

资源类型定义。唯一取值:GATEWAY。

NextToken String 212db86sca4384811e0b5e8707ec21345

用来返回更多结果。第一次查询不需要提供这个参数,如果一次查询没有返回全部结果,则可在后续查询中传入前一次返回的token继续查询。

ResourceId.N String gw-uf6wjk5xxxxxxx

网关ID列表, 可以同时查询N个网关的标签,N的取值范围:1~50。

说明 ResourceId.N参数和Tag.N.Key参数至少传入一个。
Tag.N.Key String testkey1

标签键。可以同时查询N个标签键,N的取值范围:1~20。不允许传入空字符串。

说明 ResourceId.N参数和Tag.N.Key参数至少传入一个。
Tag.N.Value String testvalue1

标签键对应的标签值。可以同时查询N个标签值,N的取值范围:1~20。允许传入空字符串。

返回数据

名称

类型

示例值

描述

NextToken String 212db86sca4384811e0b5e8707ec21345

如果一次查询没有返回全部结果,则可在后续查询中传入前一次返回的token继续查询。

RequestId String 47A514A1-4B77-4E30-B4C5-2A880650B3FD

请求ID。

TagResources Array of TagResource

查询到的网关和标签的信息。

TagResource
ResourceType String ALIYUN::HCS_SGW::GATEWAY

资源类型。ALIYUN::HCS_SGW::GATEWAY 即混合云存储网关。

TagValue String testvalue1

标签键对应的标签值。

ResourceId String 47A514A1-4B77-4E30-B4C5-2A880650B3FD

网关ID。

TagKey String testkey1

标签键。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceRegionId=cn-hangzhou
&ResourceType=GATEWAY
&NextToken=212db86sca4384811e0b5e8707ec21345
&ResourceId=[]
&Tag=[{"Key":"testkey1","Value":"testvalue1"}]
&公共请求参数

正常返回示例

XML格式

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

<ListTagResourcesResponse>
    <NextToken>212db86sca4384811e0b5e8707ec21345</NextToken>
    <RequestId>47A514A1-4B77-4E30-B4C5-2A880650B3FD</RequestId>
    <TagResources>
        <ResourceType>ALIYUN::HCS_SGW::GATEWAY</ResourceType>
        <TagValue>testvalue1</TagValue>
        <ResourceId>47A514A1-4B77-4E30-B4C5-2A880650B3FD	</ResourceId>
        <TagKey>testkey1	</TagKey>
    </TagResources>
</ListTagResourcesResponse>

JSON格式

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

{
  "NextToken" : "212db86sca4384811e0b5e8707ec21345",
  "RequestId" : "47A514A1-4B77-4E30-B4C5-2A880650B3FD",
  "TagResources" : [ {
    "ResourceType" : "ALIYUN::HCS_SGW::GATEWAY",
    "TagValue" : "testvalue1",
    "ResourceId" : "47A514A1-4B77-4E30-B4C5-2A880650B3FD\t",
    "TagKey" : "testkey1\t"
  } ]
}

错误码

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