リストの結果の並べ替えとフィルタリング

Cloud Key Management Service は、次の list オペレーションで得た結果のフィルタリングと並べ替えをサポートしています。

• keyRings.list
• cryptoKeys.list
• cryptoKeyVersions.list
• importJobs.list

list リクエストの本文に filter と orderBy の文字列フィールドがある場合は、list オペレーションで並べ替えとフィルタリングがサポートされています。どちらのフィールドでも、並べ替えやフィルタリングの対象となるオブジェクト内のフィールドを参照するのに、簡単な言語が使用されます。

フィルタの構文

フィルタの構文は、フィルタ対象となるオブジェクトの 1 つ以上のフィールドに対する式で構成されます。

式には次の演算子を使用できます。

AND 演算子と OR 演算子は、同じグループレベルで使用できます。OR は AND より優先されます。括弧を使用して、デフォルトの優先順位をオーバーライドできます。

time 値でフィルタする場合は、2019-06-20T01:30:15Z のように、時刻を RFC 3399 形式の文字列にエンコードします。

サブフィールドにアクセスする場合は、ドット構文を使用します。たとえば、CryptoKey リソースには primary フィールドが含まれています。特定のアルゴリズムについて、CryptoKey の結果をサブフィールド primary.algorithm でフィルタできます。

primary.algorithm=RSA_SIGN_PSS_2048_SHA256

ドット構文は、ラベルやその他の map 型に使用できます。

labels.team=alpha

引用符で囲まれた文字列は、一続きの値ではなく、単一の値として解釈されます。

フィルタリング可能なフィールド

返されるオブジェクトのすべてのフィールドでフィルタリングが可能です。

並べ替えの構文

オブジェクトでリソースの name フィールドを使用して結果を並べ替えることができます。orderBy フィールドでサポートされる並べ替え値は次のとおりです。