云手机服务器 CPH-查询资源实例:请求参数

时间:2024-11-28 01:46:59

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

action

String

操作标识(仅限于filter,count):filter(过滤),count(查询总条数)。 为filter时表示分页查询,为count只需按照条件将总条数返回即可。

offset

String

索引位置, 从offset指定的下一条数据开始查询。 查询第一页数据时,不需要传入此参数,查询后续页码数据时,将查询前一页数据时响应体中的值带入此参数。action为count时无此参数。action为filter时,默认为0,必须为数字,且不能为负数。

limit

String

查询记录数。

action为count时无此参数。

action为filter时,默认为1000。limit最多为1000,不能为负数,最小值为1。

without_any_tag

Boolean

不包含任意一个标签,该字段为true时查询所有不带标签的资源。

tags

Array of Tags objects

最多包含10个key,每个key最多包含10个value,结构体不能缺失。key不能为空或者空字符串。key不能重复,同一个key中value不能重复,不同key对应的资源之间为与的关系。

matches

Array of Match objects

搜索字段。

key为要匹配的字段,当前只支持resource_name。

value为匹配的值,当前为精确匹配。

表4 Tags

参数

是否必选

参数类型

描述

key

String

键。

  • 最大长度127个unicode字符。

  • key不能为空。

values

Array of strings

值列表。

  • 最多10个value。

  • value不允许重复。

  • 每个值最大长度255个unicode字符。

  • 如果values为空则表示any_value。

  • value之间为或的关系。

表5 Match

参数

是否必选

参数类型

描述

key

String

键。

当前key的参数值只能取“resource_name”,此时value的参数值为资源名称。

value

String

值。

当前key的参数值只能取“resource_name”,此时value的参数值为资源名称。

support.huaweicloud.com/api-cph/cph_api_0555.html