弹性云服务器 ECS-按标签查询云服务器列表(废弃):请求消息

时间:2025-02-12 15:02:28

请求消息

请求参数如表2所示。
表2 请求参数

参数

是否必选

参数类型

描述

action

String

值为filter:表示按标签过滤弹性云服务器,返回符合条件的云服务器列表。

limit

String

查询返回的云服务器数量限制,最多为1000,不能为负数。

  • 如果action的值为count时,此参数无效。
  • 如果action的值为filter时,limit必填,取值范围[0-1000],如果不传值,系统默认limit值为1000。

offset

String

偏移量:指定返回记录的开始位置,必须为数字,取值范围为大于或等于0。

查询第一页数据时,可以不传入此参数。

  • 如果action的值为count时,此参数无效。
  • 如果action的值为filter时,必填,如果用户不传值,系统默认offset值为0。

tags

Array of objects

查询包含所有指定标签的弹性云服务器,详情请参见表3

  • 结构体不能缺失。
  • key不能为空或者空字符串。
  • key不能重复。
  • 同一个key中values不能重复。

not_tags

Array of strings

查询不包含所有指定标签的弹性云服务器。

  • 结构体不能缺失。
  • key不能为空或者空字符串。
  • Key不能重复。
  • 同一个key中values不能重复。

matches

Array of objects

搜索字段,用于按条件搜索弹性云服务器。

当前仅支持按resource_name进行搜索。更多信息,请参见表4

表3 tag字段数据结构说明

参数

是否必选

参数类型

描述

key

String

键。

  • 最大长度127个unicode字符。
  • key不能为空。

values

Array of strings

值列表。

  • value不允许重复。
  • 每个值最大长度255 个unicode字符。
  • 如果values为空则表示any_value。
  • value之间为或的关系。
表4 match字段数据结构说明

参数

是否必选

参数类型

描述

key

String

键,表示要匹配的字段。

当前key的参数值只能取“resource_name”,此时value的参数值为云服务器名称。

  • key不能重复,value为匹配的值。
  • 此字段为固定字典值。
  • 不允许为空字符串。

value

String

值。

当前key的参数值只能取“resource_name”,此时value的参数值为云服务器名称。

  • 每个值最大长度255个unicode字符。
  • 不可以为空 。
support.huaweicloud.com/api-ecs/ecs_02_1005.html