全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 阿里云办公 培训与认证 物联网
负载均衡

DescribeTags

更新时间:2017-08-23 20:09:52   分享:   

描述

  • 允许根据实例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 该标签绑定的实例总数。

示例

请求示例

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

返回示例

  • XML 格式

    1. <?xml version="1.0" encoding="UTF-8"?>
    2. <DescribeTagsResponse>
    3. <RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
    4. <TagSets>
    5. <TagSet>
    6. <TagKey>test</TagKey>
    7. <TagValue>api</TagValue>
    8. </TagSet>
    9. </TagSets>
    10. <PageSize>50</PageSize>
    11. <PageNumber>1</PageNumber>
    12. <TotalCount>1</TotalCount>
    13. </DescribeTagsResponse>
  • JSON格式

    1. {
    2. "RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710",
    3. "TagSets": {
    4. "TagSet": [
    5. {
    6. "TagKey": "test",
    7. "TagValue": "api"
    8. }
    9. "PageNumber": 1,
    10. "PageSize": 50,
    11. "TotalCount": 1
    12. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?