调用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"
} ]
}
错误码
访问错误中心查看更多错误码。
文档内容是否对您有帮助?