排序及篩選清單結果

Cloud Key Management Service 支援透過下列 list 作業篩選及排序結果。

清單要求主體中如果存在 filter 與 orderBy 字串欄位，即表示支援在 list 作業中排序及篩選。這兩個欄位都使用簡單語言來參照排序及/或篩選物件中的欄位。

篩選器語法

篩選器語法包含在篩選物件的一或多個欄位上執行的運算式。

您可以使用下列運算式運算子。

運算子 說明
= 等於。
> 大於。
< 小於。
=> 大於或等於。
<= 小於或等於。
!=
-
NOT		 不等於。
以下會產生相同結果：
name != "quickstart"
-name="quickstart"
NOT name = "quickstart"
: 包含。這是不區分大小寫的子字串比對。
例如，name: "cloud" 會篩選在資源名稱中包含 cloud (不區分大小寫) 的資源。
AND 邏輯 AND。空格等於 AND，因此以下會產生相同結果：
name: "cloud" AND name: "kms"
name: "cloud" name: "kms"
OR 邏輯 OR。

AND 與 OR 運算子會在相同分組層級上接受。OR 優先於 AND。您可以使用括號覆寫預設優先順序。

篩選 time 值時，請將時間編碼為 RFC 3399 格式的字串，例如 2019-06-20T01:30:15Z。

存取子欄位時，請使用 dot 語法。舉例來說，CryptoKey 資源包含 primary 欄位。您可以針對特定演算法，在子欄位 primary.algorithm 上篩選 CryptoKey 結果：

primary.algorithm=RSA_SIGN_PSS_2048_SHA256

對於標籤及其他任何 map 類型，請使用 dot 語法：

labels.team=alpha

加引號的字串會解譯為單一值，而非一串值。

可篩選的欄位

您可以篩選傳回物件中的任何欄位。

List 方法 可篩選欄位的連結
keyRings.list KeyRing 欄位
cryptoKeys.list CryptoKey 欄位
cryptoKeyVersions.list CryptoKeyVersion 欄位
importJobs.list ImportJob 欄位

排序順序語法

您可以按物件的資源 name 欄位來排序結果。以下為 orderBy 欄位支援的排序順序值。

值 說明
'' (空字串) 結果會按預設順序排序。
'name' 結果會按資源的 name 欄位以遞增方式排序。
'name desc' 結果會按資源的 name 欄位以遞減方式排序。