DoMetaQuery 操作を呼び出して、指定された条件を満たすオブジェクトをクエリし、指定されたフィールドとソート順に基づいてオブジェクト情報を一覧表示します。 - Object Storage Service

DoMetaQuery 操作を呼び出して、指定された条件を満たすオブジェクトをクエリし、指定されたフィールドとソート順に基づいてオブジェクト情報を一覧表示します。ネストされた Query 要素を使用して複雑なクエリを実行したり、集約操作を使用して異なるフィールドの値に関する統計を収集および分析したりすることもできます。

注意事項

指定された条件を満たすオブジェクトをクエリするには、oss:DoMetaQuery 権限が必要です。詳細については、「RAM ユーザーにカスタム権限を付与する」をご参照ください。

リクエスト構文

スカラー検索

POST /?metaQuery&comp=query&mode=basic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <NextToken></NextToken>
  <MaxResults>5</MaxResults>
  <Query>{"Field": "Size","Value": "1048576","Operation": "gt"}</Query>
  <Sort>Size</Sort>
  <Order>asc</Order>
  <Aggregations>
    <Aggregation>
      <Field>Size</Field>
      <Operation>sum</Operation>
    </Aggregation>
    <Aggregation>
      <Field>Size</Field>
      <Operation>max</Operation>
    </Aggregation>
  </Aggregations>
</MetaQuery>

ベクター検索

POST /?metaQuery&comp=query&mode=semantic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <MaxResults>99</MaxResults>
  <Query>An aerial view of a snow-covered forest</Query>
  <MediaTypes>
    <MediaType>image</MediaType>
  </MediaTypes>  
  <SimpleQuery>{"Operation":"gt", "Field": "Size", "Value": "30"}</SimpleQuery>
</MetaQuery>

リクエストヘッダー

DescribeRegions リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。詳細については、「共通リクエストヘッダー」をご参照ください。

リクエスト要素

スカラー検索

名前	タイプ	必須	例	説明
mode	String	はい	basic	検索モードがスカラー検索であることを指定します。
MetaQuery	コンテナー	はい	N/A	クエリ条件のコンテナー。子ノード: NextToken、MaxResults、Query、Sort、Order、および Aggregations
NextToken	String	いいえ	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	オブジェクトの総数が MaxResults の値より大きい場合のページネーションに使用されるトークン。オブジェクト情報のリストは、NextToken で指定されたオブジェクトから辞書順で返されます。この操作を初めて呼び出すときは、このフィールドを空のままにします。親ノード: MetaQuery
MaxResults	Integer	いいえ	5	返されるオブジェクトの最大数。有効値: 0～100。このパラメーターを設定しないか、0 に設定した場合、デフォルト値は 100 です。親ノード: MetaQuery
Query	String	はい	{"Field": "Size","Value": "1048576","Operation": "gt"}	クエリ条件。次のオプションが含まれます: Operation: オペレーター。有効値: eq (等しい)、gt (より大きい)、gte (以上)、lt (より小さい)、lte (以下)、match (あいまい検索)、prefix (プレフィックスクエリ)、and (論理 AND)、or (論理 OR)、not (論理 NOT)。 Field: フィールド名。サポートされているフィールドと各フィールドでサポートされているオペレーターの詳細については、「付録: スカラー検索のフィールドとオペレーター」をご参照ください。 Value: フィールド値。 SubQueries: サブクエリ条件。オプションは、単純なクエリ条件のオプションと同じです。サブクエリ条件は、Operation が論理演算子 (and、or、または not) の場合にのみ設定する必要があります。 Query の例の詳細については、「DoMetaQuery」をご参照ください。親ノード: MetaQuery
Sort	String	いいえ	Size	指定されたフィールドで結果をソートします。ソートをサポートするフィールドの詳細については、「付録: スカラー検索のフィールドとオペレーター」をご参照ください。親ノード: MetaQuery
Order	String	いいえ	asc	ソート順。有効値: asc: 昇順 desc (デフォルト): 降順親ノード: MetaQuery
Aggregations	コンテナー	いいえ	N/A	集約操作に関する情報のコンテナー。子ノード: Aggregation 親ノード: MetaQuery
Aggregation	コンテナー	いいえ	N/A	単一の集約操作に関する情報のコンテナー。子ノード: Field および Operation 親ノード: Aggregations
Field	String	いいえ	Size	フィールド名。サポートされているフィールドと各フィールドでサポートされているオペレーターの詳細については、「付録: スカラー検索のフィールドとオペレーター」をご参照ください。親ノード: Aggregation
Operation	String	いいえ	sum	集約操作のオペレーター。有効値: min: 最小値 max: 最大値 average: 平均値 sum: 合計 count: カウント distinct: 重複排除カウント group: グループカウント親ノード: Aggregation

ベクター検索

名前	タイプ	必須	例	説明
mode	String	はい	semantic	検索モードがベクター検索であることを指定します。
MetaQuery	コンテナー	はい	N/A	クエリ条件のコンテナー。子ノード: MaxResults、Query、MediaTypes、および SimpleQuery
MaxResults	Integer	いいえ	5	返されるオブジェクトの最大数。有効値: 0～100。このパラメーターを設定しないか、0 に設定した場合、デフォルト値は 100 です。親ノード: MetaQuery
Query	String	はい	An aerial view of a snow-covered forest	取得するコンテンツ。親ノード: MetaQuery
MediaTypes	コンテナー	はい	N/A	マルチメディアメタデータ検索条件。親ノード: MetaQuery
MediaType	String	はい	image	取得するマルチメディアのタイプ。有効値: image video audio document 親ノード: MediaTypes
SimpleQuery	String	いいえ	{"Operation":"gt", "Field": "Size", "Value": "30"}	クエリ条件。次のオプションが含まれます: Operation: オペレーター。有効値: eq (等しい)、gt (より大きい)、gte (以上)、lt (より小さい)、lte (以下)、match (あいまい検索)、prefix (プレフィックスクエリ)、and (論理 AND)、or (論理 OR)、not (論理 NOT)。 Field: フィールド名。サポートされているフィールドと各フィールドでサポートされているオペレーターの詳細については、「付録: ベクター検索のフィールドとオペレーター」をご参照ください。 Value: フィールド値。 SubQueries: サブクエリ条件。オプションは、単純なクエリ条件のオプションと同じです。サブクエリ条件は、Operation が論理演算子 (and、or、または not) の場合にのみ設定する必要があります。親ノード: MetaQuery

レスポンスヘッダー

DescribeRegions リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。詳細については、「共通レスポンスヘッダー」をご参照ください。

レスポンス要素

スカラー検索

名前	タイプ	例	説明
MetaQuery	コンテナー	N/A	クエリ結果のコンテナー。子ノード: NextToken、Files、および Aggregations
NextToken	String	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	オブジェクトの総数が MaxResults の値より大きい場合のページネーションに使用されるトークン。オブジェクト情報を一覧表示する次のリクエストでは、この値を NextToken に使用して、残りの結果を返します。このパラメーターは、すべてのオブジェクトが返されない場合にのみ返されます。親ノード: MetaQuery
Files	コンテナー	N/A	オブジェクト情報のコンテナー。子ノード: File 親ノード: MetaQuery
File	コンテナー	N/A	単一のオブジェクトに関する情報のコンテナー。子ノード: Filename、Size、FileModifiedTime、OSSObjectType、OSSStorageClass、ObjectACL、ETag、OSSTaggingCount、OSSTagging、および OSSCRC64 親ノード: Files
Filename	String	exampleobject.txt	オブジェクトの完全なパス。親ノード: File
Size	Integer	120	オブジェクトのサイズ (バイト単位)。親ノード: File
FileModifiedTime	String	2025-05-19T16:14:38+08:00	オブジェクトの最終更新時刻。フォーマットは RFC3339Nano です。親ノード: File
OSSObjectType	String	Normal	オブジェクトのタイプ。有効値: Normal: オブジェクトは、PutObject 操作を呼び出すことによってアップロードされるか、CreateDirectory 操作を呼び出すことによって作成されます。 Appendable: オブジェクトは、AppendObject 操作を呼び出すことによってアップロードされます。 Multipart: オブジェクトは、MultipartUpload 操作を呼び出すことによってアップロードされます。 Symlink: シンボリックリンクは、PutSymlink 操作を呼び出すことによって作成されます。親ノード: File
OSSStorageClass	String	Standard	オブジェクトのストレージクラス。有効値: Standard: 標準ストレージクラスは、頻繁なデータアクセスをサポートする、信頼性、可用性、パフォーマンスの高いオブジェクトストレージサービスを提供します。 IA: 低頻度アクセスストレージクラスは、長期間保存されるが、アクセス頻度が低い (平均して月に 1〜2 回) データに適しています。 Archive: アーカイブストレージクラスは、長期間 (6 か月以上を推奨) の保存が必要なアーカイブデータに適しています。データは、そのストレージライフサイクル中にほとんどアクセスされません。読み取り可能になる前にデータを解凍するには 1 分かかります。 ColdArchive: コールドアーカイブストレージクラスは、長期間保存され、ほとんどアクセスされないデータに適しています。親ノード: File
ObjectACL	String	default	オブジェクトのアクセス制御リスト (ACL)。有効値: default: オブジェクトは、それが保存されているバケットのアクセス権限を継承します。 private: オブジェクトは非公開リソースです。オブジェクトの所有者と承認されたユーザーのみが、オブジェクトに対する読み取りおよび書き込み権限を持ちます。他のユーザーはオブジェクトにアクセスできません。 public-read: オブジェクトは公開読み取りリソースです。オブジェクトの所有者と承認されたユーザーのみが、オブジェクトに対する読み取りおよび書き込み権限を持ちます。他のユーザーはオブジェクトに対する読み取り権限のみを持ちます。この権限は注意して使用してください。 public-read-write: オブジェクトは公開読み書きリソースです。すべてのユーザーがオブジェクトに対する読み取りおよび書き込み権限を持ちます。この権限は注意して使用してください。親ノード: File
ETag	String	"fba9dede5f27731c9771645a3986****"	オブジェクトが作成されると、対応する ETag が生成されます。 ETag は、オブジェクトのコンテンツを識別するために使用されます。 PutObject リクエストによって作成されたオブジェクトの場合、ETag 値はそのコンテンツの MD5 ハッシュです。他の方法で作成されたオブジェクトの場合、ETag 値は特定の計算ルールに基づいて生成された一意の値ですが、そのコンテンツの MD5 ハッシュではありません。説明 ETag 値は、オブジェクトのコンテンツが変更されたかどうかを確認するために使用できます。データ整合性を検証するために、オブジェクトコンテンツの MD5 ハッシュとして ETag 値を使用することはお勧めしません。親ノード: File
OSSTaggingCount	Integer	2	オブジェクトのタグの数。親ノード: File
OSSTagging	コンテナー	N/A	タグ情報のコンテナー。子ノード: Tagging 親ノード: File
Tagging	コンテナー	N/A	単一のタグに関する情報のコンテナー。子ノード: Key および Value 親ノード: OSSTagging
Key	String	owner	タグまたはユーザー定義メタデータのキー。ユーザー定義メタデータのキーには、プレフィックスとして `x-oss-meta-` を付ける必要があります。親ノード: Tagging および UserMeta
Value	String	John	タグまたはユーザー定義メタデータの値。親ノード: Tagging および UserMeta
OSSCRC64	String	4858A48BD1466884	オブジェクトの 64 ビット CRC 値。 64 ビット CRC 値は、CRC-64/XZ 標準に基づいて計算されます。親ノード: File
Aggregations	コンテナー	N/A	集約操作に関する情報のコンテナー。子ノード: Field、Operation、Operation、Value、および Groups 親ノード: MetaQuery
Field	String	Size	フィールド名。親ノード: Aggregations
Operation	String	sum	集約オペレーター。親ノード: Aggregations
Value	浮動小数点数	200	集約操作の結果値。親ノード: Aggregations
Groups	コンテナー	N/A	グループ化と集約の結果のリスト。子ノード: Value および Count 親ノード: Aggregations
Value	String	100	グループ化と集約の値。親ノード: Groups
Count	Integer	5	グループ化と集約の結果の総数。親ノード: Groups

ベクター検索

名前	タイプ	例	説明
MetaQuery	コンテナー	N/A	クエリ結果のコンテナー。子ノード: Files
Files	コンテナー	N/A	オブジェクト情報のリスト。子ノード: File 親ノード: MetaQuery
File	コンテナー	N/A	単一のオブジェクトに関する情報。親ノード: Files
URI	String	oss://examplebucket/test-object.jpg	オブジェクトの完全なパス。親ノード: File
Filename	String	exampleobject.txt	オブジェクトの名前。親ノード: File
Size	Integer	120	オブジェクトのサイズ (バイト単位)。親ノード: File
ObjectACL	String	default	オブジェクトのアクセス制御リスト (ACL)。有効値: default: オブジェクトは、それが保存されているバケットのアクセス権限を継承します。 private: オブジェクトは非公開リソースです。オブジェクトの所有者と承認されたユーザーのみが、オブジェクトに対する読み取りおよび書き込み権限を持ちます。他のユーザーはオブジェクトにアクセスできません。 public-read: オブジェクトは公開読み取りリソースです。オブジェクトの所有者と承認されたユーザーのみが、オブジェクトに対する読み取りおよび書き込み権限を持ちます。他のユーザーはオブジェクトに対する読み取り権限のみを持ちます。この権限は注意して使用してください。 public-read-write: オブジェクトは公開読み書きリソースです。すべてのユーザーがオブジェクトに対する読み取りおよび書き込み権限を持ちます。この権限は注意して使用してください。親ノード: File
FileModifiedTime	String	2025-05-19T16:15:33+08:00	オブジェクトの最終更新時刻。フォーマットは RFC3339Nano です。親ノード: File
ETag	String	"fba9dede5f27731c9771645a3986****"	オブジェクトが作成されると、対応する ETag が生成されます。 ETag は、オブジェクトのコンテンツを識別するために使用されます。 PutObject リクエストによって作成されたオブジェクトの場合、ETag 値はそのコンテンツの MD5 ハッシュです。他の方法で作成されたオブジェクトの場合、ETag 値は特定の計算ルールに基づいて生成された一意の値ですが、そのコンテンツの MD5 ハッシュではありません。説明 ETag 値は、オブジェクトのコンテンツが変更されたかどうかを確認するために使用できます。データ整合性を検証するために、オブジェクトコンテンツの MD5 ハッシュとして ETag 値を使用することはお勧めしません。親ノード: File
OSSCRC64	String	4858A48BD1466884	オブジェクトの 64 ビット CRC 値。 64 ビット CRC 値は、CRC-64/XZ 標準に基づいて計算されます。親ノード: File
ProduceTime	String	2021-06-29T14:50:13.011643661+08:00	写真またはビデオがデバイスによって撮影された時刻。親ノード: File
ContentType	String	image/jpeg	Multipurpose Internet Mail Extensions (MIME) タイプ。親ノード: File
MediaType	String	image	メディアタイプ。親ノード: File
LatLong	String	30.134390,120.074997	緯度と経度の情報。親ノード: File
Title	String	test	ファイルのタイトル。親ノード: File
OSSExpiration	String	2124-12-01T12:00:00.000Z	ファイルの有効期限。親ノード: File
AccessControlAllowOrigin	String	https://aliyundoc.com	クロスオリジンリクエストの送信が許可されているオリジン。親ノード: File
AccessControlRequestMethod	String	PUT	クロスオリジンリクエストで使用されるメソッド。親ノード: File
CacheControl	String	no-cache	オブジェクトがダウンロードされるときの Web ページのキャッシュ動作。親ノード: File
ContentDisposition	String	attachment; filename =test.jpg	ダウンロード時のオブジェクトの名前。親ノード: File
ContentEncoding	String	UTF-8	オブジェクトがダウンロードされるときのコンテンツエンコード形式。親ノード: File
ContentLanguage	String	zh-CN	オブジェクトのコンテンツで使用される言語。親ノード: File
ImageHeight	Integer	500	イメージの高さ (ピクセル単位 (px))。親ノード: File
ImageWidth	Integer	270	イメージの幅 (ピクセル単位 (px))。親ノード: File
VideoWidth	Integer	1080	ビデオフレームの幅 (ピクセル単位 (px))。親ノード: File
VideoHeight	Integer	1920	ビデオフレームの高さ (ピクセル単位 (px))。親ノード: File
VideoStreams	コンテナー	N/A	ビデオストリームのリスト。親ノード: File
VideoStream	コンテナー	N/A	ビデオストリーム。親ノード: VideoStreams
CodecName	String	h264	エンコーダーの名前。親ノード: VideoStream
Language	String	en	ビデオストリームで使用される言語。フォーマットは BCP 47 です。親ノード: VideoStream
Bitrate	Integer	5407765	ビットレート (bit/s)。親ノード: VideoStream
FrameRate	String	25/1	ビデオストリームのフレームレート。親ノード: VideoStream
StartTime	倍精度浮動小数点数	0.000000	ビデオストリームの開始時刻 (秒 (s))。親ノード: VideoStream
Duration	倍精度浮動小数点数	22.88	ビデオストリームの継続時間 (秒 (s))。親ノード: VideoStream
FrameCount	Integer	572	ビデオフレームの数。親ノード: VideoStream
BitDepth	Integer	8	ピクセルのビット深度。親ノード: VideoStream
PixelFormat	String	yuv420p	ビデオストリームのピクセルフォーマット。親ノード: VideoStream
ColorSpace	String	bt709	色空間。親ノード: VideoStream
Height	Integer	720	ビデオストリームフレームの高さ (ピクセル単位 (px))。親ノード: VideoStream
Width	Integer	1280	ビデオストリームフレームの幅 (ピクセル単位 (px))。親ノード: VideoStream
AudioStreams	コンテナー	N/A	オーディオストリームのリスト。親ノード: File
AudioStream	コンテナー	N/A	オーディオストリーム。親ノード: AudioStreams
CodecName	String	aac	エンコーダーの名前。親ノード: AudioStream
Bitrate	Integer	320087	ビットレート (bit/s)。親ノード: AudioStream
SampleRate	Integer	48000	サンプルレート (ヘルツ (Hz))。親ノード: AudioStream
StartTime	倍精度浮動小数点数	0.0235	オーディオストリームの開始時刻 (秒 (s))。親ノード: AudioStream
Duration	倍精度浮動小数点数	3.690667	オーディオストリームの継続時間 (秒 (s))。親ノード: AudioStream
Channels	Integer	2	サウンドチャンネルの数。親ノード: AudioStream
Language	String	en	オーディオストリームで使用される言語。フォーマットは BCP 47 です。親ノード: AudioStream
Subtitles	コンテナー	N/A	字幕ストリームのリスト。親ノード: File
Subtitle	コンテナー	N/A	字幕ストリーム。親ノード: Subtitles
CodecName	String	mov_text	エンコーダーの名前。親ノード: Subtitle
Language	String	en	字幕の言語。フォーマットは BCP 47 です。親ノード: Subtitle
StartTime	倍精度浮動小数点数	0.000000	字幕ストリームの開始時刻 (秒 (s))。親ノード: Subtitle
Duration	倍精度浮動小数点数	71.378	字幕ストリームの継続時間 (秒 (s))。親ノード: Subtitle
Bitrate	Integer	13091201	ビットレート (bit/s)。親ノード: File
Artist	String	Jane	アーティスト。親ノード: File
AlbumArtist	String	Jenny	アーティスト。親ノード: File
Composer	String	Jane	作曲者。親ノード: File
Performer	String	Jane	演奏者。親ノード: File
Album	String	FirstAlbum	アルバム。親ノード: File
Duration	倍精度浮動小数点数	15.263000	ビデオの総再生時間 (秒)。親ノード: File
Addresses	コンテナー	N/A	住所情報。親ノード: File
Address	コンテナー	N/A	住所情報。親ノード: Addresses
AddressLine	String	No. 969, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China	完全な住所。親ノード: Address
City	String	Hangzhou	都市です。親ノード: Address
District	String	Yuhang District	地区。親ノード: Address
Language	String	zh-Hans	言語。フォーマットは BCP 47 です。親ノード: Address
Province	String	Zhejiang	都道府県。親ノード: Address
Township	String	Wenyi West Road	通り。親ノード: Address
OSSObjectType	String	Normal	オブジェクトのタイプ。親ノード: File
OSSStorageClass	String	Standard	オブジェクトのストレージクラス。親ノード: File
OSSTaggingCount	Integer	2	オブジェクトのタグの数。親ノード: File
OSSTagging	コンテナー	N/A	タグ情報のリスト。子ノード: Tagging 親ノード: File
Tagging	コンテナー	N/A	単一のタグに関する情報のコンテナー。子ノード: Key および Value 親ノード: OSSTagging
Key	String	owner	タグのキー。親ノード: Tagging
Value	String	John	タグの値。親ノード: Tagging
Key	String	owner	ユーザー定義メタデータのキー。親ノード: Tagging
Value	String	John	ユーザー定義メタデータの値。親ノード: Tagging

例

リクエストの例

スカラー検索

POST /?metaQuery&comp=query&mode=basic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <NextToken></NextToken>
  <MaxResults>5</MaxResults>
  <Query>{"Field": "Size","Value": "1048576","Operation": "gt"}</Query>
  <Sort>Size</Sort>
  <Order>asc</Order>
  <Aggregations>
    <Aggregation>
      <Field>Size</Field>
      <Operation>sum</Operation>
    </Aggregation>
    <Aggregation>
      <Field>Size</Field>
      <Operation>max</Operation>
    </Aggregation>
  </Aggregations>
</MetaQuery>

ベクター検索

POST /?metaQuery&comp=query&mode=semantic HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 12 Sep 2024 13:08:38 GMT
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <MaxResults>99</MaxResults>
  <Query>An aerial view of a snow-covered forest</Query> // 必須
  <MediaTypes>
    <MediaType>image</MediaType>
  </MediaTypes>
  // SimpleQuery は、シンプルモードの Query フィールドに相当します。
  <SimpleQuery>{"Operation":"gt", "Field": "Size", "Value": "30"}</SimpleQuery>
</MetaQuery>

レスポンスの例

スカラー検索

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <NextToken>MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****</NextToken>
  <Files>
    <File>
      <Filename>exampleobject.txt</Filename>
      <Size>120</Size>
      <FileModifiedTime>2025-05-19T16:14:38+08:00</FileModifiedTime>
      <OSSObjectType>Normal</OSSObjectType>
      <OSSStorageClass>Standard</OSSStorageClass>
      <ObjectACL>default</ObjectACL>
      <ETag>"fba9dede5f27731c9771645a3986****"</ETag>
      <OSSCRC64>4858A48BD1466884</OSSCRC64>
      <OSSTaggingCount>2</OSSTaggingCount>
      <OSSTagging>
        <Tagging>
          <Key>owner</Key>
          <Value>John</Value>
        </Tagging>
        <Tagging>
          <Key>type</Key>
          <Value>document</Value>
        </Tagging>
      </OSSTagging>
    </File>
  </Files>
</MetaQuery>

ベクター検索

イメージ検索リクエストに対するレスポンスの例

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Thu, 12 Sep 2024 13:08:38 GMT
Content-Length: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<MetaQuery>
  <Files>
    <File>
      <URI>oss://examplebucket/test-object.jpg</URI>
      <Filename>sampleobject.jpg</Filename>
      <Size>1000</Size>
      <ObjectACL>default</ObjectACL>
      <FileModifiedTime>2025-05-19T16:14:38+08:00</FileModifiedTime>
      <ETag>\"1D9C280A7C4F67F7EF873E28449****\"</ETag>
      <OSSCRC64>559890638950338001</OSSCRC64>
      <ProduceTime>2021-06-29T14:50:15.011643661+08:00</ProduceTime>
      <ContentType>image/jpeg</ContentType>
      <MediaType>image</MediaType>
      <LatLong>30.134390,120.074997</LatLong>
      <Title>test</Title>
      <OSSExpiration>2024-12-01T12:00:00.000Z</OSSExpiration>
      <AccessControlAllowOrigin>https://aliyundoc.com</AccessControlAllowOrigin>
      <AccessControlRequestMethod>PUT</AccessControlRequestMethod>
      <CacheControl>no-cache</CacheControl>
      <ContentDisposition>attachment; filename =test.jpg</ContentDisposition>
      <ContentEncoding>UTF-8</ContentEncoding>
      <ContentLanguage>zh-CN</ContentLanguage>
      <ImageHeight>500</ImageHeight>
      <ImageWidth>270</ImageWidth>
      <Addresses>
        <Address>
          <AddressLine>No. 969, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China</AddressLine>
          <City>Hangzhou</City>
          <Country>China</Country>
          <District>Yuhang District</District>
          <Language>zh-Hans</Language>
          <Province>Zhejiang</Province>
          <Township>Wenyi West Road</Township>
        </Address>
        <Address>
          <AddressLine>No. 970, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China</AddressLine>
          <City>Hangzhou</City>
          <Country>China</Country>
          <District>Yuhang District</District>
          <Language>zh-Hans</Language>
          <Province>Zhejiang</Province>
          <Township>Wenyi West Road</Township>
        </Address>
      </Addresses>
      <OSSObjectType>Normal</OSSObjectType>
      <OSSStorageClass>Standard</OSSStorageClass>
      <OSSTaggingCount>2</OSSTaggingCount>
      <OSSTagging>
        <Tagging>
          <Key>key</Key>
          <Value>val</Value>
        </Tagging>
        <Tagging>
          <Key>key</Key>
          <Value>val</Value>
        </Tagging>
      </OSSTagging>
    </File>
  </Files>
</MetaQuery>

オーディオまたはビデオ検索リクエストに対するレスポンスの例

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Thu, 12 Sep 2024 13:08:38 GMT
Content-Length: 118
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version=\"1.0\" encoding=\"UTF-8\"?>
<MetaQuery>
  <Files>
    <File>
      <URI>oss://examplebucket/test-object.jpg</URI>
      <Filename>sampleobject.jpg</Filename>
      <Size>1000</Size>
      <ObjectACL>default</ObjectACL>
      <FileModifiedTime>2021-06-29T14:50:14.011643661+08:00</FileModifiedTime>
      <ETag>\"1D9C280A7C4F67F7EF873E28449****\"</ETag>
      <OSSCRC64>559890638950338001</OSSCRC64>
      <ProduceTime>2021-06-29T14:50:15.011643661+08:00</ProduceTime>
      <ContentType>image/jpeg</ContentType>
      <MediaType>image</MediaType>
      <LatLong>30.134390,120.074997</LatLong>
      <Title>test</Title>
      <OSSExpiration>2024-12-01T12:00:00.000Z</OSSExpiration>
      <AccessControlAllowOrigin>https://aliyundoc.com</AccessControlAllowOrigin>
      <AccessControlRequestMethod>PUT</AccessControlRequestMethod>
      <CacheControl>no-cache</CacheControl>
      <ContentDisposition>attachment; filename =test.jpg</ContentDisposition>
      <ContentEncoding>UTF-8</ContentEncoding>
      <ContentLanguage>zh-CN</ContentLanguage>
      <VideoWidth>1080</VideoWidth>
      <VideoHeight>1920</VideoHeight>
      <VideoStreams>
        <VideoStream>
          <CodecName>h264</CodecName>
          <Language>en</Language>
          <Bitrate>5407765</Bitrate>
          <FrameRate>25/1</FrameRate>
          <StartTime>0</StartTime>
          <Duration>22.88</Duration>
          <FrameCount>572</FrameCount>
          <BitDepth>8</BitDepth>
          <PixelFormat>yuv420p</PixelFormat>
          <ColorSpace>bt709</ColorSpace>
          <Height>720</Height>
          <Width>1280</Width>
        </VideoStream>
        <VideoStream>
          <CodecName>h264</CodecName>
          <Language>en</Language>
          <Bitrate>5407765</Bitrate>
          <FrameRate>25/1</FrameRate>
          <StartTime>0</StartTime>
          <Duration>22.88</Duration>
          <FrameCount>572</FrameCount>
          <BitDepth>8</BitDepth>
          <PixelFormat>yuv420p</PixelFormat>
          <ColorSpace>bt709</ColorSpace>
          <Height>720</Height>
          <Width>1280</Width>
        </VideoStream>
      </VideoStreams>
      <AudioStreams>
        <AudioStream>
          <CodecName>aac</CodecName>
          <Bitrate>1048576</Bitrate>
          <SampleRate>48000</SampleRate>
          <StartTime>0.0235</StartTime>
          <Duration>3.690667</Duration>
          <Channels>2</Channels>
          <Language>en</Language>
        </AudioStream>
      </AudioStreams>
      <Subtitles>
        <Subtitle>
          <CodecName>mov_text</CodecName>
          <Language>en</Language>
          <StartTime>0</StartTime>
          <Duration>71.378</Duration>
        </Subtitle>
        <Subtitle>
          <CodecName>mov_text</CodecName>
          <Language>en</Language>
          <StartTime>72</StartTime>
          <Duration>71.378</Duration>
        </Subtitle>
      </Subtitles>
      <Bitrate>5407765</Bitrate>
      <Artist>Jane</Artist>
      <AlbumArtist>Jenny</AlbumArtist>
      <Composer>Jane</Composer>
      <Performer>Jane</Performer>
      <Album>FirstAlbum</Album>
      <Duration>71.378</Duration>
      <Addresses>
        <Address>
          <AddressLine>No. 969, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China</AddressLine>
          <City>Hangzhou</City>
          <Country>China</Country>
          <District>Yuhang District</District>
          <Language>zh-Hans</Language>
          <Province>Zhejiang</Province>
          <Township>Wenyi West Road</Township>
        </Address>
        <Address>
          <AddressLine>No. 970, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China</AddressLine>
          <City>Hangzhou</City>
          <Country>China</Country>
          <District>Yuhang District</District>
          <Language>zh-Hans</Language>
          <Province>Zhejiang</Province>
          <Township>Wenyi West Road</Township>
        </Address>
      </Addresses>
      <OSSObjectType>Normal</OSSObjectType>
      <OSSStorageClass>Standard</OSSStorageClass>
      <OSSTaggingCount>2</OSSTaggingCount>
      <OSSTagging>
        <Tagging>
          <Key>key</Key>
          <Value>val</Value>
        </Tagging>
        <Tagging>
          <Key>key</Key>
          <Value>val</Value>
        </Tagging>
      </OSSTagging>
    </File>
  </Files>
</MetaQuery>

クエリの例

Query 要素をネストして複雑なクエリ条件を構築し、必要なコンテンツを正確にクエリできます。

1000 バイト未満の exampleobject.txt という名前のオブジェクトを検索するには、Query 要素を次のように設定します:


{
  "SubQueries":[
    {
      "Field":"Filename",
      "Value": "exampleobject.txt",
      "Operation":"eq"
    },         
    {
      "Field":"Size",
      "Value":"1000",
      "Operation":"lt"
    }
  ],
  "Operation":"and"
}

exampledir/ プレフィックスを持ち、type=document または owner=John タグを含み、10 MB より大きいオブジェクトを検索するには、Query 要素を次のように設定します:


{
  "SubQueries": [
    {
      "Field": "Filename",
      "Value": "exampledir/",
      "Operation": "prefix"
    },
    {
      "Field": "Size",
      "Value": "1048576",
      "Operation": "gt"
    },
    {
      "SubQueries": [
        {
          "Field": "OSSTagging.type",
          "Value": "document",
          "Operation": "eq"
        },
        {
          "Field": "OSSTagging.owner",
          "Value": "John",
          "Operation": "eq"
        }
      ],
      "Operation": "or"
    }
  ],
  "Operation": "and"
}

これらの検索条件に加えて、集約操作を使用してさまざまなデータの統計分析を実行できます。たとえば、検索条件を満たすすべてのオブジェクトの合計サイズ、数、平均値、最大値または最小値を計算したり、検索条件を満たすすべてのイメージのサイズ分布に関する統計を収集したりできます。

SDK

この操作には、次の SDK を使用できます:

ossutil コマンドラインツール

DoMetaQuery 操作は、ossutil の do-meta-query コマンドに対応します。