Panggil operasi DoMetaQuery untuk menanyakan objek yang memenuhi kondisi tertentu dan mendaftarkan informasi objek berdasarkan bidang dan urutan pengurutan tertentu. - Object Storage Service

Panggil operasi DoMetaQuery untuk membuat kueri objek yang memenuhi kondisi tertentu dan menampilkan daftar informasi objek berdasarkan bidang serta urutan pengurutan tertentu. Anda juga dapat menggunakan elemen Kueri bersarang untuk melakukan kueri kompleks dan menggunakan operasi agregat untuk mengumpulkan serta menganalisis statistik pada nilai-nilai dari berbagai bidang.

Langkah-langkah Pencegahan

Untuk menanyakan objek yang memenuhi kondisi tertentu, Anda harus memiliki izin oss:DoMetaQuery. Untuk informasi lebih lanjut, lihat Memberikan izin kustom kepada Pengguna RAM.

Sintaks permintaan

Pengambilan skalar

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>

Pengambilan vektor

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>Pemandangan udara hutan bersalju</Query>
  <MediaTypes>
    <MediaType>Citra</MediaType>
  </MediaTypes>  
  <SimpleQuery>{"Operation":"gt", "Field": "Size", "Value": "30"}</SimpleQuery>
</MetaQuery>

Header permintaan

Semua header dalam permintaan DescribeRegions merupakan header permintaan umum. Untuk informasi lebih lanjut, lihat Header permintaan umum.

Elemen Permintaan

Pengambilan Skalar

Nama	Tipe	Diperlukan	Contoh	Deskripsi
mode	String	Ya	basic	Menentukan bahwa mode pengambilan adalah pengambilan skalar.
MetaQuery	Kontainer	Ya	Tidak tersedia	Kontainer untuk kondisi kueri. Node anak: NextToken, MaxResults, Query, Sort, Order, dan Aggregations
NextToken	String	Tidak	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	Token yang digunakan untuk paginasi ketika jumlah total objek lebih besar dari nilai MaxResults. Daftar informasi objek dikembalikan dalam urutan leksikografis mulai dari objek yang ditentukan oleh NextToken. Saat Anda memanggil operasi ini untuk pertama kali, biarkan bidang ini kosong. Node induk: MetaQuery
MaxResults	Integer	Tidak	5	Jumlah maksimum objek yang akan dikembalikan. Nilai valid: 0 hingga 100. Jika Anda tidak menetapkan parameter ini atau menetapkannya ke 0, nilai defaultnya adalah 100. Node induk: MetaQuery
Query	String	Ya	{"Field": "Size","Value": "1048576","Operation": "gt"}	Kondisi kueri. Ini mencakup opsi berikut: 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 (logika AND), or (logika OR), dan not (logika NOT). Field: Nama bidang. Untuk informasi lebih lanjut tentang bidang yang didukung dan operator yang didukung oleh setiap bidang, lihat Lampiran: Bidang dan operator untuk pengambilan skalar. Value: Nilai bidang. SubQueries: Kondisi subkueri. Opsi tersebut sama dengan kondisi kueri sederhana. Anda hanya perlu menetapkan kondisi subkueri jika Operation adalah operator logika (and, or, atau not). Untuk informasi lebih lanjut tentang contoh Query, lihat DoMetaQuery. Node induk: MetaQuery
Sort	String	Tidak	Size	Mengurutkan hasil berdasarkan bidang tertentu. Untuk informasi lebih lanjut tentang bidang yang mendukung pengurutan, lihat Lampiran: Bidang dan operator untuk pengambilan skalar. Node induk: MetaQuery
Order	String	Tidak	asc	Urutan pengurutan. Nilai valid: asc: naik desc (default): turun Node induk: MetaQuery
Aggregations	Kontainer	Tidak	Tidak tersedia	Kontainer untuk informasi tentang operasi agregat. Node anak: Aggregation Node induk: MetaQuery
Aggregation	Kontainer	Tidak	Tidak tersedia	Kontainer untuk informasi tentang operasi agregat tunggal. Node anak: Field dan Operation Node induk: Aggregations
Field	String	Tidak	Size	Nama bidang. Untuk informasi lebih lanjut tentang bidang yang didukung dan operator yang didukung oleh setiap bidang, lihat Lampiran: Bidang dan operator untuk pengambilan skalar. Node induk: Aggregation
Operation	String	Tidak	sum	Operator dalam operasi agregat. Nilai valid: min: nilai minimum max: nilai maksimum average: nilai rata-rata sum: jumlah count: hitungan distinct: hitungan tanpa duplikat group: hitungan kelompok Node induk: Aggregation

Pengambilan Vektor

Nama	Tipe	Diperlukan	Contoh	Deskripsi
mode	String	Ya	semantic	Menentukan bahwa mode pengambilan adalah pengambilan vektor.
MetaQuery	Kontainer	Ya	Tidak tersedia	Kontainer untuk kondisi kueri. Node anak: MaxResults, Query, MediaTypes, dan SimpleQuery
MaxResults	Integer	Tidak	5	Jumlah maksimum objek yang akan dikembalikan. Nilai valid: 0 hingga 100. Jika Anda tidak menetapkan parameter ini atau menetapkannya ke 0, nilai defaultnya adalah 100. Node induk: MetaQuery
Query	String	Ya	Pemandangan udara hutan bersalju	Konten yang akan diambil. Node induk: MetaQuery
MediaTypes	Kontainer	Ya	Tidak tersedia	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. Ini mencakup opsi berikut: 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 (logika AND), or (logika OR), dan not (logika NOT). Field: Nama bidang. Untuk informasi lebih lanjut tentang bidang yang didukung dan operator yang didukung oleh setiap bidang, lihat Lampiran: Bidang dan operator untuk pengambilan vektor. Value: Nilai bidang. SubQueries: Kondisi subkueri. Opsi tersebut sama dengan kondisi kueri sederhana. Anda hanya perlu menetapkan kondisi subkueri jika Operation adalah operator logika (and, or, atau not). Node induk: MetaQuery

Header respons

Semua header dalam tanggapan terhadap permintaan DescribeRegions merupakan header respons umum. Untuk informasi lebih lanjut, lihat Header respons umum.

Elemen respons

Pengambilan Skalar

Nama	Tipe	Contoh	Deskripsi
MetaQuery	Kontainer	Tidak tersedia	Kontainer untuk hasil kueri. Node anak: NextToken, Files, dan Aggregations
NextToken	String	MTIzNDU2Nzg6aW1tdGVzdDpleGFtcGxlYnVja2V0OmRhdGFzZXQwMDE6b3NzOi8vZXhhbXBsZWJ1Y2tldC9zYW1wbGVvYmplY3QxLmpw****	Token yang digunakan untuk paginasi ketika jumlah total objek lebih besar dari nilai MaxResults. Dalam permintaan berikutnya untuk mencantumkan informasi objek, gunakan nilai ini untuk NextToken untuk mengembalikan hasil yang tersisa. Parameter ini hanya dikembalikan jika tidak semua objek dikembalikan. Node induk: MetaQuery
Files	Kontainer	Tidak tersedia	Kontainer untuk informasi objek. Node anak: File Node induk: MetaQuery
File	Kontainer	Tidak tersedia	Kontainer untuk informasi tentang 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 terakhir objek dimodifikasi. Formatnya adalah RFC3339Nano. Node induk: File
OSSObjectType	String	Normal	Tipe 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: Kelas Penyimpanan Standar menyediakan layanan penyimpanan objek yang sangat andal, sangat tersedia, dan berkinerja tinggi yang mendukung akses data sering. IA: Kelas Penyimpanan Akses Jarang cocok untuk data yang disimpan lama tetapi jarang diakses (rata-rata sekali atau dua kali sebulan). Archive: Kelas Penyimpanan Arsip cocok untuk data arsip yang memerlukan penyimpanan jangka panjang (lebih dari enam bulan direkomendasikan). Data jarang diakses selama siklus hidup penyimpanannya. Dibutuhkan 1 menit untuk memulihkan data sebelum dapat dibaca. Cold Archive: Kelas Penyimpanan Arsip Dingin cocok untuk data yang disimpan lama dan jarang diakses. Node induk: File
ObjectACL	String	default	Daftar kontrol akses (ACL) objek. Nilai valid: default: Objek mewarisi izin akses bucket tempat ia disimpan. private: Objek adalah sumber daya pribadi. Hanya pemilik objek dan pengguna yang berwenang yang memiliki izin baca dan tulis pada objek. Pengguna lain tidak dapat mengakses objek. public-read: Objek adalah sumber daya baca-publik. Hanya pemilik objek dan pengguna yang berwenang yang memiliki izin baca dan tulis pada objek. Pengguna lain hanya memiliki izin baca pada objek. Gunakan izin ini dengan hati-hati. public-read-write: Objek adalah sumber daya baca-tulis publik. Semua pengguna memiliki izin baca dan tulis pada objek. Gunakan izin ini dengan hati-hati. Node induk: File
ETag	String	"fba9dede5f27731c9771645a3986****"	Ketika sebuah objek dibuat, ETag yang sesuai dihasilkan. ETag digunakan untuk mengidentifikasi konten objek. Untuk objek yang dibuat oleh permintaan PutObject, nilai ETag adalah hash MD5 dari kontennya. Untuk objek yang dibuat dengan cara lain, nilai ETag adalah nilai unik yang dihasilkan berdasarkan aturan perhitungan tertentu, tetapi bukan hash MD5 dari kontennya. Catatan Nilai ETag dapat digunakan untuk memeriksa apakah konten objek telah berubah. Kami tidak merekomendasikan Anda menggunakan nilai ETag sebagai hash MD5 konten objek untuk memverifikasi integritas data. Node induk: File
OSSTaggingCount	Integer	2	Jumlah tag objek. Node induk: File
OSSTagging	Kontainer	Tidak tersedia	Kontainer untuk informasi tag. Node anak: Tagging Node induk: File
Tagging	Kontainer	Tidak tersedia	Kontainer untuk informasi tentang 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	Kontainer	Tidak tersedia	Kontainer untuk informasi tentang 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	Kontainer	Tidak tersedia	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 total hasil pengelompokan dan agregasi. Node induk: Groups

Pengambilan Vektor

Nama	Tipe	Contoh	Deskripsi
MetaQuery	Kontainer	N/A	Kontainer untuk hasil kueri. Node anak: Files
File	Wadah	Tidak tersedia	Daftar informasi objek. Node anak: File Node induk: MetaQuery
Berkas	Wadah	Tidak tersedia	Informasi tentang satu objek. Node induk: Berkas
URI	String	oss://examplebucket/test-object.jpg	Path lengkap dari objek. Node induk: File
Nama File	String	exampleobject.txt	Nama dari objek. Node induk: File
Ukuran	Integer	120	Ukuran objek dalam byte. Node induk: File
ObjectACL	String	default	Daftar kontrol akses (ACL) dari objek. Nilai yang valid: default: Objek mewarisi izin akses dari bucket tempat ia disimpan. private: Objek adalah sumber daya pribadi. Hanya pemilik objek dan pengguna yang berwenang yang memiliki izin baca dan tulis pada objek. Pengguna lain tidak dapat mengakses objek. baca-publik: Objek adalah sumber daya baca-publik. Hanya pemilik objek dan pengguna yang berwenang yang memiliki izin baca dan tulis pada objek. Pengguna lain hanya memiliki izin baca pada objek. Gunakan izin ini dengan hati-hati. baca-tulis publik: Objek adalah sumber daya baca-tulis publik. Semua pengguna memiliki izin baca dan tulis pada objek. Gunakan izin ini dengan hati-hati. Node induk: File
FileModifiedTime	String	2025-05-19T16:15:33+08:00	Waktu terakhir dimodifikasi dari objek. Formatnya adalah RFC3339Nano. Node induk: File
ETag	String	"fba9dede5f27731c9771645a3986****"	Saat sebuah objek dibuat, ETag yang sesuai akan dihasilkan. ETag digunakan untuk mengidentifikasi konten dari sebuah objek. Untuk objek yang dibuat melalui permintaan PutObject, nilai ETag adalah Hash MD5 dari kontennya. Untuk objek yang dibuat dengan cara lain, nilai ETag adalah nilai unik yang dihasilkan berdasarkan aturan perhitungan tertentu, tetapi bukan Hash MD5 dari kontennya. Catatan Nilai ETag dapat digunakan untuk memeriksa apakah konten objek telah berubah. Kami tidak menyarankan Anda menggunakan nilai ETag sebagai Hash MD5 dari konten objek untuk memverifikasi integritas data. Node induk: File
OSSCRC64	String	4858A48BD1466884	Nilai CRC 64-bit dari 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 ketika foto atau video diambil oleh perangkat. Node induk: File
ContentType	String	image/jpeg	Tipe Ekstensi MIME (Multipurpose Internet Mail Extensions). Node induk: File
MediaType	String	citra	Jenis media. Node induk: File
LatLong	String	30.134390,120.074997	Informasi lintang dan bujur. Node induk: File
Judul	String	test	Judul dari file. Node induk: File
OSSExpiration	String	2124-12-01T12:00:00.000Z	Waktu kedaluwarsa file. Node induk: File
AccessControlAllowOrigin	String	https://aliyundoc.com	Asal yang diizinkan untuk 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 citra dalam piksel (px). Node induk: File
ImageWidth	Integer	270	Lebar citra dalam piksel (px). Node induk: File
VideoWidth	Integer	1.080	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 dari penyandi. Node induk: VideoStream
Bahasa	String	en	Bahasa yang digunakan dalam aliran video. Formatnya adalah BCP 47. Node induk: VideoStream
Bitrate	Integer	5.407.765	Bitrate dalam bit/s. Node induk: VideoStream
FrameRate	String	25/1	Laju frame dari aliran video. Node induk: VideoStream
StartTime	Bilangan titik mengambang presisi ganda	0,000000	Waktu mulai dari aliran video dalam detik (s). Node induk: VideoStream
Durasi	Bilangan titik mengambang presisi ganda	22,88	Durasi aliran video dalam detik (s). Node induk: VideoStream
FrameCount	Bilangan Bulat	572	Jumlah frame video. Node induk: VideoStream
BitDepth	Integer	8	Kedalaman bit piksel. Node induk: VideoStream
PixelFormat	String	yuv420p	Format piksel dari aliran video. Node induk: VideoStream
ColorSpace	String	bt709	Ruang warna. Node induk: VideoStream
Tinggi	Bilangan Bulat	720	Tinggi frame aliran video dalam piksel (px). Node induk: VideoStream
Lebar	Bilangan bulat	1.280	Lebar bingkai 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 dari penyandi. Node induk: AudioStream
Bitrate	Integer	320.087	Bitrate dalam bit/s. Node induk: AudioStream
SampleRate	Integer	48.000	Laju sampel dalam hertz (Hz). Node induk: AudioStream
Waktu mulai	Bilangan titik mengambang presisi ganda	0,0235	Waktu mulai dari aliran audio dalam detik (s). Node induk: AudioStream
Durasi	Bilangan titik mengambang presisi ganda	3,690667	Durasi aliran audio dalam detik (s). Node induk: AudioStream
Saluran	Integer	2	Jumlah saluran suara. Node induk: AudioStream
Bahasa	String	en	Bahasa yang digunakan dalam aliran audio. Formatnya adalah BCP 47. Node induk: AudioStream
Subjudul	Kontainer	Tidak tersedia	Daftar aliran teks. Node induk: File
Subjudul	Kontainer	Tidak tersedia	Aliran teks. Node induk: Subtitles
CodecName	String	mov_text	Nama dari penyandi. Node induk: Subtitle
Bahasa	String	en	Bahasa dari teks. Formatnya adalah BCP 47. Node induk: Subtitle
Waktu mulai	Bilangan titik mengambang presisi ganda	0,000000	Waktu mulai dari aliran teks dalam detik (s). Node induk: Subtitle
Durasi	Bilangan titik mengambang presisi ganda	71,378	Durasi aliran teks dalam detik (s). Node induk: Subtitle
Bitrate	Integer	13.091.201	Bitrate dalam bit/s. Node induk: File
Artis	String	Jane	Artis. Node induk: File
AlbumArtist	String	Jenny	Artis. Node induk: File
Composer	String	Jane	Komposer. Node induk: File
Pelaku	String	Jane	Pelaku. Node induk: File
Album	String	FirstAlbum	Album tersebut. Node induk: File
Durasi	Bilangan titik mengambang presisi ganda	15.263000	Total durasi video dalam detik. Node induk: File
Alamat	Kontainer	Tidak tersedia	Informasi alamat. Node induk: File
Alamat	Kontainer	Tidak tersedia	Informasi alamat. Node induk: Addresses
AddressLine	String	No. 969, Jalan Wenyi Barat, Distrik Yuhang, Hangzhou, Zhejiang, Tiongkok	Alamat lengkap. Node induk: Address
Kota	String	Hangzhou	Kota. Node induk: Address
Kabupaten	String	Kabupaten Yuhang	Kabupaten. Node induk: Alamat
Bahasa	String	zh-Hans	Bahasa. Formatnya adalah BCP 47. Node induk: Address
Provinsi	String	Zhejiang	Provinsi tersebut. Node induk: Address
Kecamatan	String	Jalan Wenyi Barat	Jalanan. Node induk: Alamat
OSSObjectType	String	Normal	Tipe dari objek. Node induk: File
OSSStorageClass	String	Standar	Kelas penyimpanan objek. Node induk: File
OSSTaggingCount	Integer	2	Jumlah tag dari objek. Node induk: File
OSSTagging	Container	N/A	Daftar informasi tag. Node anak: Tagging Node induk: File
Tagging	Kontainer	Tidak tersedia	Kontainer untuk informasi tentang satu tag. Node anak: Key dan Value Node induk: OSSTagging
Kunci	String	Pemilik	Kunci dari tag. Node induk: Tagging
Nilai	String	John	Nilai dari tag. Node induk: Tagging
Kunci	String	Pemilik	Kunci dari metadata yang ditentukan pengguna. Node induk: Tagging
Nilai	String	John	Nilai dari metadata yang ditentukan pengguna. Node induk: Tagging

Contoh

Contoh Permintaan

Pengambilan Skalar

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>

Pengambilan Vektor

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>Pemandangan udara hutan bersalju</Query> // Diperlukan
  <MediaTypes>
    <MediaType>image</MediaType>
  </MediaTypes>
  // SimpleQuery setara dengan bidang Query dalam mode sederhana.
  <SimpleQuery>{"Operation":"gt", "Field": "Size", "Value": "30"}</SimpleQuery>
</MetaQuery>

Contoh Tanggapan

Pengambilan Skalar

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>

Pengambilan Vektor

Contoh tanggapan untuk permintaan pengambilan citra

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 tanggapan 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

Anda dapat menumpuk elemen Kueri untuk membangun kondisi kueri yang kompleks dan secara tepat mencari konten yang Anda butuhkan.

Untuk mencari objek bernama exampleobject.txt yang lebih kecil dari 1.000 byte, konfigurasikan elemen Kueri sebagai berikut:


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

Untuk mencari objek yang memiliki exampledir/ sebagai awalan, mengandung tag type=document atau owner=John, dan lebih besar dari 10 MB, konfigurasikan elemen Kueri 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 ini, Anda dapat menggunakan operasi agregat untuk melakukan analisis statistik pada data yang berbeda. Sebagai contoh, Anda dapat menghitung total ukuran, jumlah, nilai rata-rata, atau nilai maksimum atau minimum dari semua objek yang memenuhi kriteria pencarian, atau mengumpulkan statistik tentang distribusi ukuran semua citra yang memenuhi kriteria pencarian.

SDK

SDK berikut tersedia untuk operasi ini:

Alat baris perintah ossutil

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