すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:付録: スカラー取得のフィールドとオペレーターのリスト

最終更新日:Nov 09, 2025

このトピックでは、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

オブジェクトのサイズ。

×

×