镜像服务 IMS-按标签查询镜像:请求消息
下载镜像服务 IMS用户手册完整版
请求消息
- 请求参数
参数
是否必选
参数类型
描述
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为空列表，则标签的值可以是任意值。值列表中的值之间为或的关系。
