全部產品
Search
文件中心

Object Storage Service:DoMetaQuery

更新時間:Oct 16, 2024

調用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=documentowner=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"
    }
            
                

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