DescribeTags__标签相关API_API 参考_负载均衡-阿里云

描述

允许根据实例ID/Tagkey/Tagvalue等条件查询所有符合条件的Tags.
指定的条件为and关系，只有满足所有指定条件的TagSet才会被返回
如果指定了Tagkey而没有指定Tagvalue，就查询所有该Tagkey关联的Tag
不允许用户只指定Tagvalue而不指定Tagkey
若指定了Tagkey/Tagvalue对，则精确匹配该Tag

请求参数

名称	类型	是否必须	描述
Action	String	是	操作接口名，系统规定参数。取值：DescribeTags
RegionId	String	是	负载均衡实例所属的Region编号。取值：从DescribeRegions的返回值中选取。
LoadBalancerID	String	否	负载均衡实例ID
Tags	String	否	需要查询的Tag列表。取值：是一个Json string，其结构是一个JsonList。一次请求中，List中的元素个数最多5个。List元素的结构详见下表。
PageSize	Integer	否	默认50，最大100
PageNumber	Integer	否	实例列表页码，起始值1，默认值1

Tags元素：

名称	类型	是否必须	描述
TagKey	String	否	最多支持64个字不支持aliyun开头不允许为空
TagValue	String	否	最多支持128个字符不支持aliyun开头

返回参数

名称	类型	描述
<公共参数>		详见<公共返回参数>
TagSets	List	JSON格式的数据列表，每项参数如下表所示
PageSize	Integer	默认50，最大100
PageNumber	Integer	实例列表页码，起始值1，默认值1
TotalCount	Integer	根据过滤条件得到的实例总个数

TagSets结构:

名称	类型	描述
<公共参数>		详见<公共返回参数>
TagKey	String	标签Key
TagValue	String	标签Value
InstanceCount	Integer	该标签绑定的实例总数

示例

请求示例

https://slb.aliyuncs.com/
&Action=DescribeTags
&RegionId=cn-east-hangzhou-01
&LoadBalancerID=139a00604ad-cn-east-hangzhou-01
&<公共请求参数>

返回示例

XML 格式

<?xml version="1.0" encoding="UTF-8"?>
<DescribeTagsResponse>
  <RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
   <TagSets>
      <TagSet>
          <TagKey>test</TagKey>
          <TagValue>api</TagValue>
      </TagSet>
  </TagSets>
  <PageSize>50</PageSize>
  <PageNumber>1</PageNumber>
  <TotalCount>1</TotalCount>
</DescribeTagsResponse>

JSON格式

  {
"RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710",
"TagSets": {
  "TagSet": [
    {
      "TagKey": "test",
      "TagValue": "api"
    }
"PageNumber": 1,
"PageSize": 50,
"TotalCount": 1
  }

最后更新：2016-11-23 16:04:15

DescribeTags__标签相关API_API 参考_负载均衡-阿里云

描述

请求参数

返回参数

示例

请求示例

返回示例

上一篇： AddTags__标签相关API_API 参考_负载均衡-阿里云

下一篇： RemoveTags__标签相关API_API 参考_负载均衡-阿里云

相关内容

热门内容

最新内容