请求消息

• 请求参数

  参数	是否必选	参数类型	描述
  action	是	String	操作标识（区分大小写），支持filter、count。filter就是分页查询；count是只需按照条件将总条数返回即可。
  tags	否	Array of objects	包含标签，最多包含10个key，每个key对应的values最多包含10个值，且key和values都不能重复。不能为空列表。 详情请参见表2。
  tags_any	否	Array of objects	包含任意标签，最多包含10个key，每个key对应的values最多包含10个值，且key和values都不能重复。不允许为空列表，但可以不传递参数。 详情请参见表3。
  not_tags	否	Array of objects	不包含标签，最多包含10个key，每个key对应的values最多包含10个值，且key和values都不能重复。不能为空列表。 详情请参见表4。
  not_tags_any	否	Array of objects	不包含任意标签，最多包含10个key，每个key对应的values最多包含10个值，且key和values都不能重复。不能为空列表。 详情请参见表5。
  without_any_tag	否	Boolean	不包含任意一个标签，该字段为true时查询所有不带标签的资源，此时忽略tag、not_tags、tags_any、not_tags_any字段。
  limit	否	String	最大查询记录数（action为count时，此参数无效）。如果action为filter，则limit默认为10，最多为1000，不能为负数，最小值为1。
  offset	否	String	索引位置， 从offset指定的下一条数据开始查询。 查询第一页数据时，不需要传入此参数（action为count时，此参数无效），如果action为filter，offset默认为0，不能为负数。
  matches	否	Array of objects	搜索字段，key为要匹配的字段，如resource_name、resource_id等。value为匹配的值。多个matches的key不允许重复。不允许为空列表，但可以不传递参数。 详情请参见表6。

  表2 tags字段数据结构说明

  参数	是否必选	参数类型	描述
  key	是	String	标签的键。最大长度127个unicode字符，key不能为空。
  values	是	Array of strings	标签的值列表。每个值最大长度255个unicode字符，如果values为空列表，则标签的值可以是任意值。值列表中的值之间为或的关系。

  表3 tags_any字段数据结构说明

  参数	是否必选	参数类型	描述
  key	是	String	标签的键。最大长度127个unicode字符，key不能为空。
  values	是	Array of strings	标签的值列表。每个值最大长度255个unicode字符，如果values为空列表，则标签的值可以是任意值。值列表中的值之间为或的关系。

  表4 not_tags字段数据结构说明

  参数	是否必选	参数类型	描述
  key	是	String	标签的键。最大长度127个unicode字符，key不能为空。
  values	是	Array of strings	标签的值列表。每个值最大长度255个unicode字符，如果values为空列表，则标签的值可以是任意值。值列表中的值之间为或的关系。

  表5 not_tags_any字段数据结构说明

  参数	是否必选	参数类型	描述
  key	是	String	标签的键。最大长度127个unicode字符，key不能为空。
  values	是	Array of strings	标签的值列表。每个值最大长度255个unicode字符，如果values为空列表，则标签的值可以是任意值。值列表中的值之间为或的关系。

  表6 matches字段数据结构说明

  参数	是否必选	参数类型	描述
  key	是	String	搜索的字段名称。合法值为resource_name、resource_id。 当字段名称为resource_name时，如果value为空字符串，做精确查询，否则按镜像名称全模糊查询。当字段名称为resource_id时，按镜像ID精确查询。
  value	是	String	搜索的字段名称的对应值，不允许为空。每个值最大长度255个unicode字符。