このトピックでは、OSS スカラー取得で使用できるフィールドとオペレーターについて説明します。
注意事項
単純なクエリでは、eq (等しい)、gt (より大きい)、gte (以上)、lt (より小さい)、lte (以下)、match (あいまい検索)、prefix (プレフィックスクエリ) のオペレーターがサポートされています。集約操作では、min (最小値)、max (最大値)、average (平均値)、sum (合計)、count (カウント)、distinct (重複排除カウント)、group (グループ化カウント) のオペレーターがサポートされています。
OSSUserMeta.*フィールドを使用してファイルを検索するには、アスタリスク (*) をユーザー定義メタデータのキーに置き換えます。システムは、ユーザー定義メタデータのキーと値のペアに基づいてファイルを検索します。キーでは大文字と小文字は区別されませんが、値では大文字と小文字が区別されます。たとえば、ユーザー定義メタデータ
x-oss-meta-location=hangzhouを持つファイルを検索するには、クエリ条件を{"Field": "OSSUserMeta.x-oss-meta-location", "Value": "hangzhou", "Operation": "eq"}に設定します。OSSTagging.*フィールドを使用してファイルを検索するには、アスタリスク (*) をオブジェクトタグのキーに置き換えます。システムは、オブジェクトタグのキーと値のペアに基づいてファイルを検索します。オブジェクトタグのキーと値はどちらも大文字と小文字が区別されます。たとえば、タグ
owner=Johnを持つファイルを検索するには、クエリ条件を{"Field": "OSSTagging.owner", "Value": "John", "Operation": "eq"}に設定します。
サポートリスト
次の表に、単純なクエリ、集約操作、およびソートで使用できるフィールドを示します。この表では、各フィールドでサポートされているオペレーターも指定しています。
表では、✓ はフィールドがオペレーターをサポートしていることを示し、× はフィールドがオペレーターをサポートしていないことを示します。
フィールド | 説明 | オペレーター (単純なクエリ条件) | オペレーター (集約操作) | ソート | |||
eq, gt, gte, lt, lte | match | prefix | min, max, sum, average | count, distinct, group | |||
ETag | オブジェクトのコンテンツを識別します。 | ✓ | × | ✓ | × | ✓ | ✓ |
FileModifiedTime | オブジェクトの最終更新日時。 | ✓ | × | × | × | ✓ | ✓ |
Filename | 完全なパスとファイル名を含むオブジェクトの名前。 | ✓ | ✓ | ✓ | × | ✓ | ✓ |
ObjectACL | オブジェクトのアクセス制御リスト (ACL)。 | ✓ | × | ✓ | × | ✓ | ✓ |
OSSCRC64 | オブジェクトの 64 ビット CRC-64 値。 | ✓ | × | ✓ | × | ✓ | ✓ |
OSSObjectType | オブジェクトのタイプ。 | ✓ | × | ✓ | × | ✓ | ✓ |
OSSStorageClass | オブジェクトのストレージクラス。 | ✓ | × | ✓ | × | ✓ | ✓ |
OSSTagging.* | オブジェクトタグ。 | ✓ | × | ✓ | × | × | × |
OSSTaggingCount | オブジェクトタグの数。 | ✓ | × | × | ✓ | ✓ | ✓ |
Size | オブジェクトのサイズ。 | ✓ | × | × | ✓ | ✓ | ✓ |