DoMetaQuery オペレーションは、指定した条件に一致するオブジェクトをクエリし、指定したフィールドとソート順でオブジェクト情報を一覧表示します -

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。デフォルト値： 100。設定しない場合、または 0 に設定した場合に適用されます。親ノード： 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) の場合にのみ必要です。クエリの例については、「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。デフォルト値： 100。設定しない場合、または 0 に設定した場合に適用されます。親ノード： 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	オブジェクトのタイプ。有効値：通常： PutObject API を呼び出してアップロードされたオブジェクト、または CreateDirectory API を呼び出して作成されたオブジェクト。追加可能： AppendObject API を呼び出してアップロードされたオブジェクト。マルチパート： MultipartUpload API を呼び出してアップロードされたオブジェクト。シンボリックリンク： PutSymlink API を呼び出して作成されたシンボリックリンク。親ノード：File
OSSStorageClass	String	Standard	オブジェクトのストレージクラス。有効値： Standard：頻繁にアクセスされるデータ向けの、高い信頼性、高い可用性、高性能のストレージです。 IA：低頻度アクセス (平均で月 1〜2 回) の長期保存に適しています。アーカイブ：アクセス頻度の低い (推奨 6 か月以上) データの長期アーカイブに適しています。読み取り前に約 1 分の復元が必要です。コールドアーカイブ：アクセス頻度の低いデータの長期保存に適しています。親ノード：File
ObjectACL	String	default	オブジェクトの ACL。有効値： default：バケットの ACL を継承します。プライベート：オブジェクトの所有者と承認されたユーザーのみが読み書きできます。他のユーザーはオブジェクトにアクセスできません。パブリック読み取り：所有者と承認されたユーザーは読み書きできます。他のユーザーは読み取りのみ可能です。注意してご使用ください。パブリック読み書き：すべてのユーザーが読み書きできます。注意してご使用ください。親ノード：File
ETag	String	"fba9dede5f27731c9771645a3986****"	オブジェクトが作成されると ETag が生成されます。これは、オブジェクトのコンテンツを識別します。 PutObject リクエストによって作成されたオブジェクトの場合、ETag 値はそのコンテンツの MD5 ハッシュです。他の方法で作成されたオブジェクトの場合、ETag は一意の値ですが、コンテンツの MD5 ハッシュではありません。説明 ETag を使用してオブジェクトのコンテンツが変更されたかどうかを確認できますが、データ整合性検証のために MD5 ハッシュとして使用しないでください。親ノード：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	田中一郎	タグまたはユーザー定義メタデータの値です。親ノード：Tagging、UserMeta
OSSCRC64	String	4858A48BD1466884	オブジェクトの 64 ビット CRC 値です。64 ビット CRC 値は、CRC-64/XZ 標準に基づいて計算されます。親ノード：File
Aggregations	コンテナ	N/A	集計操作のコンテナです。子ノード：Field、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：バケットの ACL を継承します。非公開：オブジェクトの所有者と承認されたユーザーのみが読み書きできます。他のユーザーはオブジェクトにアクセスできません。公開読み取り：所有者と承認されたユーザーは読み書きできます。他のユーザーは読み取りのみ可能です。取り扱いには注意が必要です。 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 ハッシュとして使用しないでください。親ノード： 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	オブジェクトがダウンロードされる際のウェブページのキャッシュ動作です。親ノード： 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	ビデオストリームの開始時刻 (秒) です。親ノード： VideoStream
Duration	倍精度浮動小数点数	22.88	ビデオストリームの継続時間 (秒) です。親ノード： 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	サンプルレート (ヘルツ) です。親ノード： AudioStream
StartTime	倍精度浮動小数点数	0.0235	オーディオストリームの開始時刻 (秒) です。親ノード： AudioStream
Duration	倍精度浮動小数点数	3.690667	オーディオストリームの継続時間 (秒) です。親ノード： 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	字幕ストリームの開始時刻 (秒) です。親ノード： Subtitle
Duration	倍精度浮動小数点数	71.378	字幕ストリームの継続時間 (秒) です。親ノード： Subtitle
Bitrate	Integer	13091201	ビットレート (bit/s) です。親ノード： File
Artist	String	鈴木花子	アーティストです。親ノード： File
AlbumArtist	String	佐藤恵子	アルバムアーティストです。親ノード： File
Composer	String	鈴木花子	作曲家です。親ノード： File
Performer	String	鈴木花子	演奏者です。親ノード： File
Album	String	FirstAlbum	アルバムです。親ノード： File
Duration	倍精度浮動小数点数	15.263000	ビデオの合計時間 (秒) です。親ノード： File
Addresses	コンテナ	N/A	住所情報です。親ノード： File
Address	コンテナ	N/A	住所情報です。親ノード： Addresses
AddressLine	String	神奈川県横浜市西区みなとみらい2-2-1	完全な住所です。親ノード： Address
City	String	横浜市	市です。親ノード： Address
District	String	西区	区です。親ノード： Address
Language	String	zh-Hans	言語です。フォーマットは BCP 47 です。親ノード： Address
Province	String	神奈川県	都道府県です。親ノード： Address
Township	String	みなとみらい	地区です。親ノード： Address
OSSObjectType	String	通常	オブジェクトのタイプです。親ノード： 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	田中一郎	タグの値です。親ノード： Tagging
Key	String	owner	The key of the user-defined metadata. Parent node: Tagging
Value	String	John	The value of the user-defined metadata. Parent node: 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>田中一郎</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>中国浙江省杭州市余杭区文一西路969号</AddressLine>
          <City>杭州</City>
          <Country>中国</Country>
          <District>余杭区</District>
          <Language>zh-Hans</Language>
          <Province>浙江</Province>
          <Township>文一西路</Township>
        </Address>
        <Address>
          <AddressLine>中国浙江省杭州市余杭区文一西路970号</AddressLine>
          <City>杭州</City>
          <Country>中国</Country>
          <District>余杭区</District>
          <Language>zh-Hans</Language>
          <Province>浙江</Province>
          <Township>文一西路</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.mp4</URI>
      <Filename>sampleobject.mp4</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>video/mp4</ContentType>
      <MediaType>video</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>鈴木花子</Artist>
      <AlbumArtist>佐藤恵子</AlbumArtist>
      <Composer>鈴木花子</Composer>
      <Performer>鈴木花子</Performer>
      <Album>FirstAlbum</Album>
      <Duration>71.378</Duration>
      <Addresses>
        <Address>
          <AddressLine>中国浙江省杭州市余杭区文一西路969号</AddressLine>
          <City>杭州</City>
          <Country>中国</Country>
          <District>余杭区</District>
          <Language>zh-Hans</Language>
          <Province>浙江</Province>
          <Township>文一西路</Township>
        </Address>
        <Address>
          <AddressLine>中国浙江省杭州市余杭区文一西路970号</AddressLine>
          <City>杭州</City>
          <Country>中国</Country>
          <District>余杭区</District>
          <Language>zh-Hans</Language>
          <Province>浙江</Province>
          <Township>文一西路</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>

クエリの例

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

名前が exampleobject.txt で、サイズが 1000 バイト未満のオブジェクトを検索するには、クエリ要素を次のように設定します：


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

プレフィックスが exampledir/ で、タグに type=document または owner=John を含み、1 MB を超えるオブジェクトを検索するには、クエリ要素を次のように設定します：


{
  "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 API は、ossutil のdo-meta-query コマンドに対応します。