調用DoMetaQuery介面查詢滿足指定條件的檔案Object,並按照指定欄位和排序方式列出檔案資訊 - Object Storage Service

調用DoMetaQuery介面查詢滿足指定條件的檔案（Object），並按照指定欄位和排序方式列出檔案資訊。您也可以通過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>俯瞰白雪覆蓋的森林</Query>
  <MediaTypes>
    <MediaType>image</MediaType>
  </MediaTypes>  
  <SimpleQuery>{"Operation":"gt", "Field": "Size", "Value": "30"}</SimpleQuery>
</MetaQuery>

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

請求元素

標量檢索

名稱	類型	是否必選	樣本值	描述
mode	字串	是	basic	指定檢索模式為標量檢索。
MetaQuery	容器	是	不涉及	查詢條件的容器。子節點：NextToken、MaxResults、Query、Sort、Order、Aggregations
NextToken	字串	否	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	當Object總數大於設定的MaxResults時，用於翻頁的token。從NextToken開始按字典序返回Object資訊列表。第一次調用此介面時，設定此欄位為空白。父節點：MetaQuery
MaxResults	整型	否	5	返回Object的最大個數，取值範圍為0~100。不設定此參數或者設定為0時，則預設值為100。父節點：MetaQuery
Query	字串	是	{"Field": "Size","Value": "1048576","Operation": "gt"}	查詢條件。包括如下選項： Operation：操作符。取值範圍為eq（等於）、gt（大於）、gte（大於等於）、lt（小於）、 lte（小於等於）、match（模糊查詢）、prefix（首碼查詢）、and（邏輯與）、or（邏輯或）和not（邏輯非）。 Field：欄位名稱。支援的欄位以及欄位對操作符的支援情況請參見附錄：標量檢索的欄位和操作符列表。 Value：欄位值。 SubQueries：子查詢條件，包括的選項與簡單查詢條件相同。只有當Operations為邏輯運算子（and、or和not）時，才需要設定子查詢條件。關於Query樣本的更多資訊，請參見Query樣本。父節點：MetaQuery
Sort	字串	否	Size	對指定欄位排序。關於支援排序的欄位列表，請參見附錄：標量檢索的欄位和操作符列表。父節點：MetaQuery
Order	字串	否	asc	排序方式。取值範圍如下： asc：升序 desc（預設值）：降序父節點：MetaQuery
Aggregations	容器	否	不涉及	彙總操作資訊的容器。子節點：Aggregation 父節點：MetaQuery
Aggregation	容器	否	不涉及	單個彙總操作資訊的容器。子節點：Field、Operation 父節點：Aggregations
Field	字串	否	Size	欄位名稱。關於支援的欄位以及欄位對操作符的支援情況，請參見附錄：標量檢索的欄位和操作符列表。父節點：Aggregation
Operation	字串	否	sum	彙總操作中的操作符。取值範圍如下： min：最小值 max：最大值 average：平均數 sum：求和 count：計數 distinct：去重統計 group：分組計數父節點：Aggregation

向量檢索

名稱	類型	是否必選	樣本值	描述
mode	字串	是	semantic	指定檢索模式為向量檢索。
MetaQuery	容器	是	不涉及	查詢條件的容器。子節點：MaxResults、Query、MediaTypes、SimpleQuery
MaxResults	整型	否	5	返回Object的最大個數，取值範圍為0~100。不設定此參數或者設定為0時，則預設值為100。父節點：MetaQuery
Query	字串	是	俯瞰白雪覆蓋的森林	輸入檢索內容。父節點：MetaQuery
MediaTypes	容器	是	不涉及	多媒體中繼資料檢索條件。父節點：MetaQuery
MediaType	字串	是	image	選擇檢索的多媒體類型。取值如下： image：圖片 video：視頻 audio：音頻 document：文檔父節點：MediaTypes
SimpleQuery	字串	否	{"Operation":"gt", "Field": "Size", "Value": "30"}	查詢條件。包括如下選項： Operation：操作符。取值範圍為eq（等於）、gt（大於）、gte（大於等於）、lt（小於）、 lte（小於等於）、match（模糊查詢）、prefix（首碼查詢）、and（邏輯與）、or（邏輯或）和not（邏輯非）。 Field：欄位名稱。支援的欄位以及欄位對操作符的支援情況請參見附錄：向量檢索的欄位和操作符列表。 Value：欄位值。 SubQueries：子查詢條件，包括的選項與簡單查詢條件相同。只有當Operations為邏輯運算子（and、or和not）時，才需要設定子查詢條件。父節點：MetaQuery

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

響應元素

標量檢索

名稱	類型	樣本值	描述
MetaQuery	容器	不涉及	查詢結果的容器。子節點：NextToken、Files、Aggregations
NextToken	字串	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	當Object總數大於設定的MaxResults時，用於翻頁的token。下一次列出Object資訊時以此值為NextToken，將未返回的結果返回。當Object未全部返回時，此參數才有值。父節點：MetaQuery
Files	容器	不涉及	Object資訊的容器。子節點：File 父節點：MetaQuery
File	容器	不涉及	單個Object資訊的容器。子節點：Filename、Size、FileModifiedTime、OSSObjectType、OSSStorageClass、ObjectACL、ETag、OSSTaggingCount、OSSTagging、OSSUserMeta、OSSCRC64、ServerSideEncryption 父節點：Files
Filename	字串	exampleobject.txt	Object完整路徑。父節點：File
Size	整型	120	Object大小。單位為位元組。父節點：File
FileModifiedTime	字串	2021-06-29T15:04:05.000000000Z07:00	Object的最近一次修改時間，遵循RFC 3339標準格式。父節點：File
OSSObjectType	字串	Normal	Object的類型。取值範圍如下： Normal：通過PutObject介面上傳或者通過CreateDirectory介面建立的Object類型。 Appendable：通過AppendObject介面上傳的Object類型。 Multipart：通過MultipartUpload介面上傳的Object類型。 Symlink：通過PutSymlink介面建立的軟連結。父節點：File
OSSStorageClass	字串	Standard	Object的儲存類型。取值範圍如下： Standard：標準儲存類型提供高可靠、高可用、高效能的Object Storage Service服務，能夠支援頻繁的資料訪問。 IA：低頻訪問儲存類型適合需要長期儲存但不經常被訪問的資料（平均每月訪問頻率1到2次）。 Archive：Archive Storage類型適合需要長期儲存（建議半年以上）的歸檔資料，在儲存周期內極少被訪問，資料進入到可讀取狀態需要1分鐘的解凍時間。 ColdArchive：冷Archive Storage類型適用於需要長期儲存且幾乎不訪問的資料。父節點：File
ObjectACL	字串	default	Object的存取權限。取值範圍如下： default：Object遵循所在儲存空間的存取權限。 private：Object是私人資源。只有Object的擁有者和授權使用者有該Object的讀寫權限，其他使用者沒有許可權操作該Object。 public-read：Object是公用讀取資源。只有Object的擁有者和授權使用者有該Object的讀寫權限，其他使用者只有該Object的讀許可權。請謹慎使用該許可權。 public-read-write：Object是公用讀寫資源。所有使用者都有該Object的讀寫權限。請謹慎使用該許可權。父節點：File
ETag	字串	"fba9dede5f27731c9771645a3986****"	Object產生時會建立相應的ETag ，ETag用於標識一個Object的內容。對於PutObject請求建立的Object，ETag值是其內容的MD5值。對於其他方式建立的Object，ETag值是基於一定計算規則產生的唯一值，但不是其內容的MD5值。說明 ETag值可以用於檢查Object內容是否發生變化。不建議使用ETag作為Object內容的MD5來校正資料完整性。父節點：File
OSSTaggingCount	整型	2	Object的標籤個數。父節點：File
OSSTagging	容器	不涉及	標籤資訊的容器。子節點：Tagging 父節點：File
Tagging	容器	不涉及	單個標籤資訊的容器。子節點：Key、Value 父節點：OSSTagging
Key	字串	owner	標籤或者使用者自訂中繼資料的Key。使用者自訂中繼資料必須以`x-oss-meta-`為首碼。父節點：Tagging、UserMeta
Value	字串	John	標籤或者使用者自訂中繼資料的Value。父節點：Tagging、UserMeta
OSSUserMeta	容器	不涉及	使用者自訂中繼資料的容器。子節點：UserMeta 父節點：File
UserMeta	容器	不涉及	單個使用者自訂中繼資料的容器。子節點：Key、Value 父節點：OSSUserMeta
OSSCRC64	字串	4858A48BD1466884	Object的64位CRC值。該64位CRC根據ECMA-182標準計算得出。
ServerSideEncryption	字串	AES256	OSS建立檔案時的伺服器端加密編碼演算法。取值範圍為AES256。父節點：File
ServerSideEncryptionCustomerAlgorithm	字串	SM4	使用者在本地用戶端加密檔案時使用的加密編碼演算法。父節點：File
Aggregations	容器	不涉及	彙總操作資訊的容器。子節點：Field、Operation、Operation、Value、Groups 父節點：MetaQuery
Field	字串	Size	欄位名稱。父節點：Aggregations
Operation	字串	sum	彙總操作符。父節點：Aggregations
Value	浮點數	200	彙總操作的結果值。父節點：Aggregations
Groups	容器	不涉及	分組彙總的結果清單。子節點：Value、Count 父節點：Aggregations
Value	字串	100	分組彙總的值。父節點：Groups
Count	整型	5	分組彙總的總個數。父節點：Groups

向量檢索

名稱	類型	樣本值	描述
MetaQuery	容器	不涉及	查詢結果的容器。子節點：Files
Files	數組	不涉及	Object資訊列表。子節點：File 父節點：MetaQuery
File	容器	不涉及	單個Object資訊。父節點：Files
URI	字串	oss://examplebucket/test-object.jpg	Object完整路徑。父節點：File
Filename	字串	exampleobject.txt	Object名稱。父節點：File
Size	整型	120	Object大小。單位為位元組。父節點：File
ObjectACL	字串	default	Object的存取權限。取值範圍如下： default：Object遵循所在儲存空間的存取權限。 private：Object是私人資源。只有Object的擁有者和授權使用者有該Object的讀寫權限，其他使用者沒有許可權操作該Object。 public-read：Object是公用讀取資源。只有Object的擁有者和授權使用者有該Object的讀寫權限，其他使用者只有該Object的讀許可權。請謹慎使用該許可權。 public-read-write：Object是公用讀寫資源。所有使用者都有該Object的讀寫權限。請謹慎使用該許可權。父節點：File
FileModifiedTime	字串	2021-06-29T15:04:05.000000000Z07:00	Object的最近一次修改時間，遵循RFC 3339標準格式。父節點：File
ServerSideEncryption	字串	AES256	OSS建立檔案時的伺服器端加密編碼演算法。取值範圍為AES256。父節點：File
ServerSideEncryptionCustomerAlgorithm	字串	SM4	使用者在本地用戶端加密檔案時使用的加密編碼演算法。父節點：File
ETag	字串	"fba9dede5f27731c9771645a3986****"	Object產生時會建立相應的ETag ，ETag用於標識一個Object的內容。對於PutObject請求建立的Object，ETag值是其內容的MD5值。對於其他方式建立的Object，ETag值是基於一定計算規則產生的唯一值，但不是其內容的MD5值。說明 ETag值可以用於檢查Object內容是否發生變化。不建議使用ETag作為Object內容的MD5來校正資料完整性。父節點：File
OSSCRC64	字串	4858A48BD1466884	Object的64位CRC值。該64位CRC根據ECMA-182標準計算得出。父節點：File
ProduceTime	字串	2021-06-29T14:50:13.011643661+08:00	裝置記錄的照片或視頻的拍攝時間。父節點：File
ContentType	字串	image/jpeg	MIME類型。父節點：File
MediaType	字串	image	多媒體類型。父節點：File
LatLong	字串	30.134390,120.074997	經緯度資訊。父節點：File
Title	字串	test	檔案標題。父節點：File
OSSExpiration	字串	2124-12-01T12:00:00.000Z	檔案到期時間。父節點：File
AccessControlAllowOrigin	字串	https://aliyundoc.com	允許的跨域請求的來源。父節點：File
AccessControlRequestMethod	字串	PUT	跨域請求中用到的方法。父節點：File
ServerSideDataEncryption	字串	SM4	Object的密碼編譯演算法。父節點：File
ServerSideEncryptionKeyId	字串	9468da86-3509-4f8d-a61e-6eab1eac****	KMS託管的使用者主要金鑰。父節點：File
CacheControl	字串	no-cache	Object被下載時網頁的緩衝行為。父節點：File
ContentDisposition	字串	attachment; filename =test.jpg	Object被下載時的名稱。父節點：File
ContentEncoding	字串	UTF-8	Object被下載時的內容編碼格式。父節點：File
ContentLanguage	字串	zh-CN	Object內容使用的語言。父節點：File
ImageHeight	整型	500	圖片高度，單位為像素（px）。父節點：File
ImageWidth	整型	270	圖片寬度，單位為像素（px）。父節點：File
VideoWidth	整型	1080	視頻畫面寬度，單位為像素（px）。父節點：File
VideoHeight	整型	1920	視頻畫面高度，單位為像素（px）。父節點：File
VideoStreams	數組	不涉及	視頻流列表。父節點：File
VideoStream	容器	不涉及	視頻流。父節點：VideoStreams
CodecName	字串	h264	編碼器名稱。父節點：VideoStream
Language	字串	en	視頻流中使用的語言，格式為BCP 47。父節點：VideoStream
Bitrate	整型	5407765	碼率，單位為位元每秒（bit/s）。父節點：VideoStream
FrameRate	字串	25/1	視頻流幀率。父節點：VideoStream
StartTime	雙精確度浮點數	0.000000	視頻流起始時間，單位為秒（s）。父節點：VideoStream
Duration	雙精確度浮點數	22.88	視頻流持續時間長度，單位為秒（s）。父節點：VideoStream
FrameCount	整型	572	視訊框架數。父節點：VideoStream
BitDepth	整型	8	像素位寬。父節點：VideoStream
PixelFormat	字串	yuv420p	視頻流像素格式。父節點：VideoStream
ColorSpace	字串	bt709	色彩空間。父節點：VideoStream
Height	整型	720	視頻流畫面高度，單位為像素（px）。父節點：VideoStream
Width	整型	1280	視頻流畫面寬度，單位為像素（px）。父節點：VideoStream
AudioStreams	數組	不涉及	音頻流列表。父節點：File
AudioStream	容器	不涉及	音頻流。父節點：AudioStreams
CodecName	字串	aac	編碼器名稱。父節點：AudioStream
Bitrate	整型	320087	碼率，單位為位元每秒（bit/s）。父節點：AudioStream
SampleRate	整型	48000	採樣率，單位為赫茲（Hz）。父節點：AudioStream
StartTime	雙精確度浮點數	0.0235	音頻流起始時間，單位為秒（s）。父節點：AudioStream
Duration	雙精確度浮點數	3.690667	音頻流持續時間長度，單位為秒（s）。父節點：AudioStream
Channels	整型	2	聲道數量。父節點：AudioStream
Language	字串	en	音頻流中使用的語言，格式為BCP 47。父節點：AudioStream
Subtitles	數組	不涉及	字幕流列表。父節點：File
Subtitle	容器	不涉及	字幕流。父節點：Subtitles
CodecName	字串	mov_text	編碼器名稱。父節點：Subtitle
Language	字串	en	字幕語言，格式為BCP 47。父節點：Subtitle
StartTime	雙精確度浮點數	0.000000	字幕流起始時間，單位為秒（s）。父節點：Subtitle
Duration	雙精確度浮點數	71.378	字幕流持續時間長度，單位為秒（s）。父節點：Subtitle
Bitrate	整型	13091201	碼率，單位為位元每秒（bit/s）。父節點：File
Artist	字串	Jane	藝術家。父節點：File
AlbumArtist	字串	Jenny	演唱者。父節點：File
Composer	字串	Jane	作曲家。父節點：File
Performer	字串	Jane	演奏者。父節點：File
Album	字串	FirstAlbum	專輯。父節點：File
Duration	雙精確度浮點數	15.263000	視頻的總時間長度。單位秒。父節點：File
Addresses	數組	不涉及	地址資訊。父節點：File
Address	容器	不涉及	地址資訊。父節點：Addresses
AddressLine	字串	中國浙江省杭州市餘杭區文一西路969號	完整地址。父節點：Address
City	字串	杭州市	城市父節點：Address
District	字串	餘杭區	區父節點：Address
Language	字串	zh-Hans	語言，格式為BCP 47。父節點：Address
Province	字串	浙江省	省份父節點：Address
Township	字串	文一西路	街道父節點：Address
OSSObjectType	字串	Normal	Object的類型。父節點：File
OSSStorageClass	字串	Standard	Object的儲存類型。父節點：File
OSSTaggingCount	整型	2	Object的標籤個數。父節點：File
OSSTagging	數組	不涉及	標籤資訊列表。子節點：Tagging 父節點：File
Tagging	容器	不涉及	單個標籤資訊的容器。子節點：Key、Value 父節點：OSSTagging
Key	字串	owner	標籤的Key。父節點：Tagging
Value	字串	John	標籤的Value。父節點：Tagging
OSSUserMeta	數組	不涉及	使用者自訂中繼資料的資訊列表。子節點：UserMeta 父節點：File
UserMeta	容器	不涉及	單個使用者自訂中繼資料的容器。子節點：Key、Value 父節點：OSSUserMeta
Key	字串	owner	使用者自訂中繼資料的Key。父節點：Tagging
Value	字串	John	使用者自訂中繼資料的Value。父節點：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: Date: Thu, 12 Sep 2024 13:08:38 GMT
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
  <MaxResults>99</MaxResults>
  <Query>俯瞰白雪覆蓋的森林</Query> // 必選
  <MediaTypes>
    <MediaType>image</MediaType>
  </MediaTypes>
  // SimpleQuery等同於Simple模式下的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>2021-06-29T15:04:05.000000000Z07: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>
      <OSSUserMeta>
        <UserMeta>
          <Key>x-oss-meta-location</Key>
          <Value>hangzhou</Value>
        </UserMeta>
      </OSSUserMeta>
    </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>
      <ServerSideEncryption>AES256</ServerSideEncryption>
      <ServerSideEncryptionCustomerAlgorithm>SM4</ServerSideEncryptionCustomerAlgorithm>
      <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>
      <ServerSideDataEncryption>SM4</ServerSideDataEncryption>
      <ServerSideEncryptionKeyId>9468da86-3509-4f8d-a61e-6eab1eac****</ServerSideEncryptionKeyId>
      <CacheControl>no-cache</CacheControl>
      <ContentDisposition>attachment; filename =test.jpg</ContentDisposition>
      <ContentEncoding>UTF-8</ContentEncoding>
      <ContentLanguage>zh-CN</ContentLanguage>
      // 以下為MediaType=image時可能返回的內容
      <ImageHeight>500</ImageHeight>
      <ImageWidth>270</ImageWidth>
      // 以下為MediaType=video時可能返回的內容
      <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>
      // 以下為MediaType=audio/video時可能返回的內容
      <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>
      // 以下為MediaType=video時可能返回的內容
      <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>中國浙江省杭州市餘杭區文一西路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>key2</Key>
          <Value>val2</Value>
        </Tagging>
      </OSSTagging>
      <OSSUserMeta>
        <UserMeta>
          <Key>key</Key>
          <Value>val</Value>
        </UserMeta>
      </OSSUserMeta>
    </File>
  </Files>
</MetaQuery>

Query樣本

Query支援嵌套使用，您可以通過Query的嵌套構建複雜的查詢條件，精確查詢到所需內容。

如果要搜尋名稱為exampleobject.txt且大小小於1000位元組的檔案，則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"
}

結合以上搜尋條件，您還可以通過彙總操作實現不同資料的統計和分析，例如計算符合搜尋條件的所有檔案的大小總和、數量、平均值或者最值，統計所有符合搜尋條件圖片的尺寸分布情況。