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 參考_負載均衡-阿裏雲

相關內容

熱門內容

最新內容