Cloud Key Management Service 支持对来自以下 list 操作的结果进行过滤和排序。
如果列表请求正文中存在 filter 和 orderBy 字符串字段，则表示支持 list 操作中的排序和过滤。这两个字段都使用简单的语言引用要排序和/或过滤的对象中的字段。
过滤器语法
过滤器语法由要过滤的对象的一个或多个字段上的表达式组成。
您可以使用以下表达式运算符。
| 运算符 | 说明 |
|---|---|
= |
相等。 |
> |
大于。 |
< |
小于。 |
=> |
大于或等于。 |
<= |
小于或等于。 |
!=-NOT |
不相等。 以下表达式是等效的： name != "quickstart"-name="quickstart"NOT name = "quickstart" |
: |
包含关系。这是一个不区分大小写的子字符串匹配。 例如， name: "cloud" 用于过滤资源名称中包含 cloud（不区分大小写）的资源。 |
AND |
逻辑与。空格相当于 AND，因此以下表达式相当于：name: "cloud" AND name: "kms"name: "cloud" name: "kms" |
OR |
逻辑或。 |
AND 和 OR 运算符具有相同的分组级别。OR 优先于 AND。您可以使用括号替换默认的优先级。
过滤 time 值时，请将时间编码为 RFC 3399 格式的字符串，例如 2019-06-20T01:30:15Z。
访问子字段时，请使用点式语法。例如，CryptoKey 资源包含 primary 字段。您可以针对特定算法对 CryptoKey 结果过滤子字段 primary.algorithm：
primary.algorithm=RSA_SIGN_PSS_2048_SHA256
您可以对标签和任何其他 map 类型使用点式语法：
labels.team=alpha
用英文引号引起来的一个字符串会被解释为单个值，而不是一系列值。
可过滤的字段
您可以过滤要返回的对象中的任何字段。
| list 方法 | 可过滤字段的链接 |
|---|---|
| keyRings.list | KeyRing 字段 |
| cryptoKeys.list | CryptoKey 字段 |
| cryptoKeyVersions.list | CryptoKeyVersion 字段 |
| importJobs.list | ImportJob 字段 |
排序顺序语法
您可以按对象的资源 name 字段对结果进行排序。下面显示了 orderBy 字段支持的排序顺序值。
| 值 | 说明 |
|---|---|
''（空字符串） |
结果按默认顺序排序。 |
'name' |
结果按资源的 name 字段升序排序。 |
'name desc' |
结果按资源的 name 字段降序排序。 |