panggil operasi DoMetaQuery untuk mengkueri objek yang memenuhi kondisi tertentu dan menampilkan informasi objek berdasarkan bidang dan urutan pengurutan yang ditentukan - Object Storage Service

Operasi DoMetaQuery mengkueri objek yang memenuhi kondisi tertentu serta menampilkan informasi objek berdasarkan bidang dan urutan pengurutan yang ditentukan. Anda juga dapat menyarangkan elemen Query untuk kueri kompleks dan menggunakan operasi agregasi guna mengumpulkan statistik nilai bidang.

Tindakan Kewaspadaan

Untuk mengkueri objek yang memenuhi kondisi tertentu, Anda harus memiliki izin oss:DoMetaQuery. Berikan izin khusus kepada RAM user.

Sintaks permintaan

Scalar retrieval

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>

Vector retrieval

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>

Header permintaan

Operasi ini hanya menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Header permintaan umum.

Elemen permintaan

Scalar retrieval

Nama	Tipe	Wajib	Nilai contoh	Deskripsi
mode	String	Ya	basic	Menetapkan mode pengambilan ke scalar retrieval.
MetaQuery	Container	Ya	N/A	Kontainer untuk kondisi kueri. Node anak: NextToken, MaxResults, Query, Sort, Order, dan Aggregations
NextToken	String	Tidak	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	Token paginasi. Diperlukan ketika jumlah total objek melebihi MaxResults. Informasi objek dikembalikan dalam urutan leksikografis mulai dari objek yang ditentukan oleh NextToken. Biarkan bidang ini kosong untuk permintaan pertama. Node induk: MetaQuery
MaxResults	Integer	Tidak	5	Jumlah maksimum objek yang dikembalikan. Nilai valid: 0 hingga 100. Default: 100. Berlaku saat tidak diatur atau diatur ke 0. Node induk: MetaQuery
Query	String	Ya	{"Field": "Size","Value": "1048576","Operation": "gt"}	Kondisi kueri. Opsi: Operation: Operator. Nilai valid: eq (sama dengan), gt (lebih besar dari), gte (lebih besar dari atau sama dengan), lt (kurang dari), lte (kurang dari atau sama dengan), match (kueri fuzzy), prefix (kueri awalan), and (AND logika), or (OR logika), dan not (NOT logika). Field: Nama bidang. Bidang dan operator yang didukung tercantum dalam Lampiran: Bidang dan operator untuk scalar retrieval. Value: Nilai bidang. SubQueries: Kondisi subkueri. Opsi sama seperti kondisi kueri sederhana. Hanya diperlukan saat Operation adalah operator logika (and, or, atau not). Contoh kueri, lihat DoMetaQuery. Node induk: MetaQuery
Sort	String	Tidak	Size	Mengurutkan hasil berdasarkan bidang tertentu. Bidang yang dapat diurutkan tercantum dalam Lampiran: Bidang dan operator untuk scalar retrieval. Node induk: MetaQuery
Order	String	Tidak	asc	Urutan pengurutan. Nilai valid: asc: ascending desc (default): descending Node induk: MetaQuery
Aggregations	Container	Tidak	N/A	Kontainer untuk operasi agregasi. Node anak: Aggregation Node induk: MetaQuery
Aggregation	Container	Tidak	N/A	Kontainer untuk satu operasi agregasi. Node anak: Field dan Operation Node induk: Aggregations
Field	String	Tidak	Size	Nama bidang. Bidang dan operator yang didukung tercantum dalam Lampiran: Bidang dan operator untuk scalar retrieval. Node induk: Aggregation
Operation	String	Tidak	sum	Operator dalam operasi agregasi. Nilai valid: min: nilai minimum max: nilai maksimum average: nilai rata-rata sum: jumlah Count distinct: jumlah tanpa duplikat group: jumlah per kelompok Node induk: Aggregation

Vector retrieval

Nama	Tipe	Wajib	Contoh	Deskripsi
mode	String	Ya	semantic	Menetapkan mode pengambilan ke vector retrieval.
MetaQuery	Container	Ya	N/A	Kontainer untuk kondisi kueri. Node anak: MaxResults, Query, MediaTypes, dan SimpleQuery
MaxResults	Integer	Tidak	5	Jumlah maksimum objek yang dikembalikan. Nilai valid: 0 hingga 100. Default: 100. Berlaku saat tidak diatur atau diatur ke 0. Node induk: MetaQuery
Query	String	Ya	An aerial view of a snow-covered forest	Konten yang akan diambil. Node induk: MetaQuery
MediaTypes	Container	Ya	N/A	Kondisi pengambilan metadata multimedia. Node induk: MetaQuery
MediaType	String	Ya	image	Jenis multimedia yang akan diambil. Nilai valid: Image: video audio document Node induk: MediaTypes
SimpleQuery	String	Tidak	{"Operation":"gt", "Field": "Size", "Value": "30"}	Kondisi kueri. Opsi: Operation: Operator. Nilai valid: eq (sama dengan), gt (lebih besar dari), gte (lebih besar dari atau sama dengan), lt (kurang dari), lte (kurang dari atau sama dengan), match (kueri fuzzy), prefix (kueri awalan), and (AND logika), or (OR logika), dan not (NOT logika). Field: Nama bidang. Bidang dan operator yang didukung tercantum dalam Lampiran: Bidang dan operator untuk vector retrieval. Value: Nilai bidang. SubQueries: Kondisi subkueri. Opsi sama seperti kondisi kueri sederhana. Hanya diperlukan saat Operation adalah operator logika (and, or, atau not). Node induk: MetaQuery

Header respons

Respons hanya berisi header respons umum. Untuk informasi selengkapnya, lihat Header respons umum.

Elemen respons

Scalar retrieval

Nama	Tipe	Contoh	Deskripsi
MetaQuery	Container	N/A	Kontainer untuk hasil kueri. Node anak: NextToken, Files, dan Aggregations
NextToken	String	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	Token paginasi. Diperlukan ketika jumlah total objek melebihi MaxResults. Gunakan nilai ini sebagai NextToken pada permintaan berikutnya untuk mengambil sisa hasil. Hanya dikembalikan jika tidak semua objek termasuk dalam respons. Node induk: MetaQuery
Files	Container	N/A	Kontainer untuk informasi objek. Node anak: File Node induk: MetaQuery
File	Container	N/A	Kontainer untuk satu objek. Node anak: Filename, Size, FileModifiedTime, OSSObjectType, OSSStorageClass, ObjectACL, ETag, OSSTaggingCount, OSSTagging, dan OSSCRC64 Node induk: Files
Filename	String	exampleobject.txt	Jalur lengkap objek. Node induk: File
Size	Integer	120	Ukuran objek dalam byte. Node induk: File
FileModifiedTime	String	2025-05-19T16:14:38+08:00	Waktu modifikasi terakhir objek. Formatnya adalah RFC3339Nano. Node induk: File
OSSObjectType	String	Normal	Jenis objek. Nilai valid: Normal: Objek diunggah dengan memanggil operasi PutObject atau dibuat dengan memanggil operasi CreateDirectory. Appendable: Objek diunggah dengan memanggil operasi AppendObject. Multipart: Objek diunggah dengan memanggil operasi MultipartUpload. Symlink: Tautan simbolik dibuat dengan memanggil operasi PutSymlink. Node induk: File
OSSStorageClass	String	Standard	Kelas penyimpanan objek. Nilai valid: Standard: Penyimpanan sangat andal, sangat tersedia, dan berkinerja tinggi untuk data yang sering diakses. IA: Cocok untuk penyimpanan jangka panjang dengan akses jarang (rata-rata sekali atau dua kali sebulan). Archive: Cocok untuk arsip jangka panjang data yang jarang diakses (disarankan enam bulan atau lebih). Memerlukan waktu sekitar 1 menit untuk memulihkan sebelum dibaca. ColdArchive: Cocok untuk penyimpanan jangka panjang data yang jarang diakses. Node induk: File
ObjectACL	String	default	ACL objek. Nilai valid: default: Mewarisi ACL bucket. private: Hanya pemilik objek dan pengguna yang berwenang yang dapat membaca dan menulis. Pengguna lain tidak dapat mengakses objek. public-read: Pemilik dan pengguna yang berwenang dapat membaca dan menulis. Pengguna lain hanya dapat membaca. Gunakan dengan hati-hati. public-read-write: Semua pengguna dapat membaca dan menulis. Gunakan dengan hati-hati. Node induk: File
ETag	String	"fba9dede5f27731c9771645a3986****"	ETag dihasilkan saat objek dibuat. ETag mengidentifikasi konten objek. Untuk objek yang dibuat melalui permintaan PutObject, nilai ETag adalah Hash MD5 dari kontennya. Untuk objek yang dibuat dengan metode lain, ETag adalah nilai unik tetapi bukan Hash MD5 dari kontennya. Catatan Anda dapat menggunakan ETag untuk memeriksa apakah konten objek telah berubah, tetapi jangan menggunakannya sebagai Hash MD5 untuk verifikasi integritas data. Node induk: File
OSSTaggingCount	Integer	2	Jumlah tag objek. Node induk: File
OSSTagging	Container	N/A	Kontainer untuk informasi tag. Node anak: Tagging Node induk: File
Tagging	Container	N/A	Kontainer untuk satu tag. Node anak: Key dan Value Node induk: OSSTagging
Key	String	owner	Kunci tag atau metadata yang ditentukan pengguna. Kunci metadata yang ditentukan pengguna harus diawali dengan `x-oss-meta-`. Node induk: Tagging dan UserMeta
Value	String	John	Nilai tag atau metadata yang ditentukan pengguna. Node induk: Tagging dan UserMeta
OSSCRC64	String	4858A48BD1466884	Nilai CRC 64-bit objek. Nilai CRC 64-bit dihitung berdasarkan standar CRC-64/XZ. Node induk: File
Aggregations	Container	N/A	Kontainer untuk operasi agregasi. Node anak: Field, Operation, Operation, Value, dan Groups Node induk: MetaQuery
Field	String	Size	Nama bidang. Node induk: Aggregations
Operation	String	sum	Operator agregasi. Node induk: Aggregations
Value	bilangan titik mengambang	200	Nilai hasil operasi agregasi. Node induk: Aggregations
Groups	Container	N/A	Daftar hasil pengelompokan dan agregasi. Node anak: Value dan Count Node induk: Aggregations
Value	String	100	Nilai pengelompokan dan agregasi. Node induk: Groups
Count	Integer	5	Jumlah hasil pengelompokan dan agregasi. Node induk: Groups

Vector retrieval

Nama	Tipe	Contoh	Deskripsi
MetaQuery	Container	N/A	Kontainer untuk hasil kueri. Node anak: Files
Files	Container	N/A	Daftar informasi objek. Node anak: File Node induk: MetaQuery
File	Container	N/A	Informasi tentang satu objek. Node induk: Files
URI	String	oss://examplebucket/test-object.jpg	Jalur lengkap objek. Node induk: File
Filename	String	exampleobject.txt	Nama objek. Node induk: File
Size	Integer	120	Ukuran objek dalam byte. Node induk: File
ObjectACL	String	default	ACL objek. Nilai valid: default: Mewarisi ACL bucket. private: Hanya pemilik objek dan pengguna yang berwenang yang dapat membaca dan menulis. Pengguna lain tidak dapat mengakses objek. public-read: Pemilik dan pengguna yang berwenang dapat membaca dan menulis. Pengguna lain hanya dapat membaca. Gunakan dengan hati-hati. public-read-write: Semua pengguna dapat membaca dan menulis. Gunakan dengan hati-hati. Node induk: File
FileModifiedTime	String	2025-05-19T16:15:33+08:00	Waktu modifikasi terakhir objek. Formatnya adalah RFC3339Nano. Node induk: File
ETag	String	"fba9dede5f27731c9771645a3986****"	ETag dihasilkan saat objek dibuat. ETag mengidentifikasi konten objek. Untuk objek yang dibuat melalui permintaan PutObject, nilai ETag adalah Hash MD5 dari kontennya. Untuk objek yang dibuat dengan metode lain, ETag adalah nilai unik tetapi bukan Hash MD5 dari kontennya. Catatan Anda dapat menggunakan ETag untuk memeriksa apakah konten objek telah berubah, tetapi jangan menggunakannya sebagai Hash MD5 untuk verifikasi integritas data. Node induk: File
OSSCRC64	String	4858A48BD1466884	Nilai CRC 64-bit objek. Nilai CRC 64-bit dihitung berdasarkan standar CRC-64/XZ. Node induk: File
ProduceTime	String	2021-06-29T14:50:13.011643661+08:00	Waktu foto atau video diambil oleh perangkat. Node induk: File
ContentType	String	image/jpeg	Jenis Multipurpose Internet Mail Extensions (MIME). Node induk: File
MediaType	String	image	Jenis media. Node induk: File
LatLong	String	30.134390,120.074997	Informasi lintang dan bujur. Node induk: File
Title	String	test	Judul file. Node induk: File
OSSExpiration	String	2124-12-01T12:00:00.000Z	Waktu kedaluwarsa file. Node induk: File
AccessControlAllowOrigin	String	https://aliyundoc.com	Origin yang diizinkan mengirim permintaan lintas asal. Node induk: File
AccessControlRequestMethod	String	PUT	Metode yang digunakan dalam permintaan lintas asal. Node induk: File
CacheControl	String	no-cache	Perilaku caching halaman web saat objek diunduh. Node induk: File
ContentDisposition	String	attachment; filename =test.jpg	Nama objek saat diunduh. Node induk: File
ContentEncoding	String	UTF-8	Format encoding konten saat objek diunduh. Node induk: File
ContentLanguage	String	zh-CN	Bahasa yang digunakan dalam konten objek. Node induk: File
ImageHeight	Integer	500	Tinggi gambar dalam piksel (px). Node induk: File
ImageWidth	Integer	270	Lebar gambar dalam piksel (px). Node induk: File
VideoWidth	Integer	1080	Lebar frame video dalam piksel (px). Node induk: File
VideoHeight	Integer	1920	Tinggi frame video dalam piksel (px). Node induk: File
VideoStreams	Container	N/A	Daftar aliran video. Node induk: File
VideoStream	Container	N/A	Aliran video. Node induk: VideoStreams
CodecName	String	h264	Nama penyandi. Node induk: VideoStream
Language	String	en	Bahasa yang digunakan dalam aliran video. Formatnya adalah BCP 47. Node induk: VideoStream
Bitrate	Integer	5407765	Bitrate dalam bit/s. Node induk: VideoStream
FrameRate	String	25/1	Laju frame aliran video. Node induk: VideoStream
StartTime	bilangan titik mengambang presisi ganda	0.000000	Waktu mulai aliran video dalam detik (s). Node induk: VideoStream
Duration	bilangan titik mengambang presisi ganda	22.88	Durasi aliran video dalam detik (s). Node induk: VideoStream
FrameCount	Integer	572	Jumlah frame video. Node induk: VideoStream
BitDepth	Integer	8	Kedalaman bit piksel. Node induk: VideoStream
PixelFormat	String	yuv420p	Format piksel aliran video. Node induk: VideoStream
ColorSpace	String	bt709	Ruang warna. Node induk: VideoStream
Height	Integer	720	Tinggi frame aliran video dalam piksel (px). Node induk: VideoStream
Width	Integer	1280	Lebar frame aliran video dalam piksel (px). Node induk: VideoStream
AudioStreams	Container	N/A	Daftar aliran audio. Node induk: File
AudioStream	Container	N/A	Aliran audio. Node induk: AudioStreams
CodecName	String	aac	Nama penyandi. Node induk: AudioStream
Bitrate	Integer	320087	Bitrate dalam bit/s. Node induk: AudioStream
SampleRate	Integer	48000	Laju sampel dalam hertz (Hz). Node induk: AudioStream
StartTime	bilangan titik mengambang presisi ganda	0.0235	Waktu mulai aliran audio dalam detik (s). Node induk: AudioStream
Duration	bilangan titik mengambang presisi ganda	3.690667	Durasi aliran audio dalam detik (s). Node induk: AudioStream
Channels	Integer	2	Jumlah saluran suara. Node induk: AudioStream
Language	String	en	Bahasa yang digunakan dalam aliran audio. Formatnya adalah BCP 47. Node induk: AudioStream
Subtitles	Container	N/A	Daftar aliran keterangan. Node induk: File
Subtitle	Container	N/A	Aliran teks. Node induk: Subtitles
CodecName	String	mov_text	Nama penyandi. Node induk: Subtitle
Language	String	en	Bahasa teks. Formatnya adalah BCP 47. Node induk: Subtitle
StartTime	bilangan titik mengambang presisi ganda	0.000000	Waktu mulai aliran teks dalam detik (s). Node induk: Subtitle
Duration	bilangan titik mengambang presisi ganda	71.378	Durasi aliran teks dalam detik (s). Node induk: Subtitle
Bitrate	Integer	13091201	Bitrate dalam bit/s. Node induk: File
Artist	String	Jane	Artis. Node induk: File
AlbumArtist	String	Jenny	Artis. Node induk: File
Composer	String	Jane	Komposer. Node induk: File
Performer	String	Jane	Penampil. Node induk: File
Album	String	FirstAlbum	Album. Node induk: File
Duration	bilangan titik mengambang presisi ganda	15.263000	Durasi total video dalam detik. Node induk: File
Addresses	Container	N/A	Informasi alamat. Node induk: File
Address	Container	N/A	Informasi alamat. Node induk: Addresses
AddressLine	String	No. 969, Wenyi West Road, Yuhang District, Hangzhou, Zhejiang, China	Alamat lengkap. Node induk: Address
City	String	Hangzhou	Kota. Node induk: Address
District	String	Yuhang District	Distrik. Node induk: Address
Language	String	zh-Hans	Bahasa. Formatnya adalah BCP 47. Node induk: Address
Province	String	Zhejiang	Provinsi. Node induk: Address
Township	String	Wenyi West Road	Jalan. Node induk: Address
OSSObjectType	String	Normal	Jenis objek. Node induk: File
OSSStorageClass	String	Standard	Kelas penyimpanan objek. Node induk: File
OSSTaggingCount	Integer	2	Jumlah tag objek. Node induk: File
OSSTagging	Container	N/A	Daftar informasi tag. Node anak: Tagging Node induk: File
Tagging	Container	N/A	Kontainer untuk satu tag. Node anak: Key dan Value Node induk: OSSTagging
Key	String	owner	Kunci tag. Node induk: Tagging
Value	String	John	Nilai tag. Node induk: Tagging
Key	String	owner	Kunci metadata yang ditentukan pengguna. Node induk: Tagging
Value	String	John	Nilai metadata yang ditentukan pengguna. Node induk: Tagging

Contoh

Contoh permintaan

Scalar retrieval

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>

Vector retrieval

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> // Required
  <MediaTypes>
    <MediaType>image</MediaType>
  </MediaTypes>
  // SimpleQuery is equivalent to the Query field in simple mode.
  <SimpleQuery>{"Operation":"gt", "Field": "Size", "Value": "30"}</SimpleQuery>
</MetaQuery>

Contoh respons

Scalar retrieval

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>

Vector retrieval

Contoh respons untuk permintaan pengambilan gambar

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>

Contoh respons untuk permintaan pengambilan audio atau video

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>

Contoh kueri

Sarangkan elemen Query untuk membuat kondisi kueri kompleks dan mengambil konten yang Anda butuhkan secara tepat.

Untuk mencari objek bernama exampleobject.txt yang ukurannya kurang dari 1.000 byte, konfigurasikan elemen Query sebagai berikut:


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

Untuk mencari objek yang memiliki awalan exampledir/, memiliki tag type=document atau owner=John, dan ukurannya lebih dari 10 MB, konfigurasikan elemen Query sebagai berikut:


{
  "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"
}

Selain kondisi pencarian, Anda dapat menggunakan operasi agregasi untuk melakukan analisis statistik—seperti total ukuran, jumlah, rata-rata, maksimum, atau minimum—pada objek yang sesuai kriteria, atau menganalisis distribusi ukuran gambar yang cocok.

SDK

SDK yang tersedia untuk operasi ini:

Alat baris perintah ossutil

Operasi DoMetaQuery berkorespondensi dengan perintah do-meta-query di ossutil.