Kueri metadata bucket atau objek menggunakan perintah stat. Perintah ini memungkinkan Anda memeriksa kelas penyimpanan, daftar kontrol akses (ACL), jenis redundansi, ukuran objek, serta properti lainnya langsung dari command line.
Hanya pemilik bucket dan Pengguna RAM dengan izin oss:GetObject, oss:GetObjectAcl, dan oss:GetBucketInfo yang dapat mengkueri metadata objek menggunakan stat.
Prasyarat
Sebelum memulai, pastikan Anda telah:
menginstal ossutil. Untuk versi 1.6.16 ke atas, gunakan
ossutillangsung sebagai nama biner. Untuk versi sebelumnya, sesuaikan nama biner berdasarkan sistem operasi Anda. Lihat referensi perintah ossutil.memiliki izin yang diperlukan untuk mengkueri bucket atau objek tersebut.
Sintaksis perintah
ossutil stat oss://bucketname[/objectname]
[--encoding-type <value>]
[--payer <value>]
[--version-id <value>]Parameter dan opsi
| Parameter/Opsi | Wajib | Deskripsi |
|---|---|---|
bucketname | Ya | Nama bucket. |
objectname | Tidak | Nama objek. Abaikan untuk mengkueri informasi tingkat bucket. |
--encoding-type | Tidak | Format encoding untuk nama objek. Nilai yang valid: url. Jika tidak ditentukan, nama objek tidak diencode. |
--payer | Tidak | Atur ke requester agar pihak requester membayar biaya traffic dan permintaan yang dihasilkan oleh operasi ini. |
--version-id | Tidak | ID versi objek. Hanya berlaku untuk bucket yang telah mengaktifkan atau menangguhkan versioning. |
Contoh
Kueri informasi bucket
ossutil stat oss://examplebucketContoh output:
Name : examplebucket
Location : oss-cn-hangzhou
CreationDate : 2021-06-30 16:04:41 +0800 CST
ExtranetEndpoint : oss-cn-hangzhou.aliyuncs.com
IntranetEndpoint : oss-cn-hangzhou-internal.aliyuncs.com
ACL : private
Owner : 148562088256****
StorageClass : Standard
RedundancyType : LRS
AccessMonitor : Enabled
0.132413(s) elapsedBidang output:
| Bidang | Deskripsi |
|---|---|
Name | Nama bucket. |
Location | Wilayah tempat bucket berada. |
CreationDate | Tanggal dan waktu pembuatan bucket. |
ExtranetEndpoint | Titik akhir publik untuk mengakses bucket melalui internet. |
IntranetEndpoint | Titik akhir internal untuk mengakses bucket dalam jaringan internal Alibaba Cloud. |
ACL | Daftar kontrol akses (ACL) tingkat bucket. |
Owner | ID akun Alibaba Cloud pemilik bucket. |
StorageClass | Kelas penyimpanan bucket. |
RedundancyType | Jenis redundansi data. |
AccessMonitor | Apakah pemantauan akses diaktifkan untuk bucket tersebut. |
Kueri informasi objek
ossutil stat oss://examplebucket/exampleobject.jpgContoh output:
ACL : default
Accept-Ranges : bytes
Content-Length : 8746
Content-Md5 : cvc5wcklut76CVoEi2UW****
Content-Type : image/jpeg
Etag : 72F739C1C925BADEFA095A048B65****
Last-Modified : 2021-07-27 09:53:03 +0800 CST
Owner : 148562088256****
X-Oss-Hash-Crc64ecma : 56037670485008****
X-Oss-Object-Type : Normal
X-Oss-Storage-Class : Standard
0.194739(s) elapsedBidang output:
| Bidang | Deskripsi |
|---|---|
ACL | ACL tingkat objek. default berarti objek mewarisi ACL bucket. |
Accept-Ranges | Menunjukkan bahwa server mendukung permintaan rentang (bytes). |
Content-Length | Ukuran objek dalam byte. |
Content-Md5 | Hash MD5 konten objek yang diencode dalam Base64, digunakan untuk verifikasi integritas data. |
Content-Type | Jenis MIME objek. |
Etag | Tag entitas yang mengidentifikasi versi spesifik objek. Berubah ketika konten objek berubah. |
Last-Modified | Tanggal dan waktu terakhir objek dimodifikasi. |
Owner | ID akun Alibaba Cloud pemilik objek. |
X-Oss-Hash-Crc64ecma | Checksum CRC64 objek, digunakan untuk verifikasi integritas data end-to-end. |
X-Oss-Object-Type | Jenis unggahan yang digunakan untuk membuat objek. Normal menunjukkan unggahan standar (bukan multipart). |
X-Oss-Storage-Class | Kelas penyimpanan objek. |
Kueri objek yang namanya mengandung karakter khusus
ossutil hanya mendukung encoding URL untuk nama objek. Untuk mengkueri objek yang namanya mengandung karakter khusus, encode terlebih dahulu namanya menjadi bentuk yang aman untuk URL.
Sebagai contoh, untuk mengkueri objek 示例.txt:
ossutil stat oss://examplebucket/%E7%A4%BA%E4%BE%8B.txt --encoding-type urlContoh output:
ACL : default
Accept-Ranges : bytes
Content-Length : 113089
Content-Md5 : mAYgHM5cSkZNBxKDDqqW****
Content-Type : image/jpeg
Etag : 9806201CCE5C4A464D0712830EAA****
Last-Modified : 2021-07-27 10:08:57 +0800 CST
Owner : 148562088256****
X-Oss-Hash-Crc64ecma : 1106061527435521****
X-Oss-Object-Type : Normal
X-Oss-Storage-Class : Standard
0.168335(s) elapsedKueri versi objek tertentu
ossutil stat oss://examplebucket/test.jpg --version-id CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz****Contoh output:
ACL : default
Accept-Ranges : bytes
Content-Length : 190540
Content-Md5 : aJQnxHQ2b+zW6hh0c+2y****
Content-Type : image/jpeg
Etag : 689427C474366FECD6EA187473ED****
Last-Modified : 2021-07-27 10:19:25 +0800 CST
Owner : 148562088256****
X-Oss-Hash-Crc64ecma : 1666171672179499****
X-Oss-Object-Type : Normal
X-Oss-Storage-Class : Standard
X-Oss-Version-Id : CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz****
0.213528(s) elapsedOutput mencakup X-Oss-Version-Id selain bidang objek standar. Untuk mencari ID versi terlebih dahulu, lihat ls.
Kueri lintas akun dan lintas wilayah
Untuk mengkueri bucket di wilayah berbeda atau yang dimiliki oleh akun Alibaba Cloud lain, tambahkan opsi -e, -i, dan -k untuk menentukan titik akhir, ID AccessKey, dan Rahasia AccessKey:
ossutil stat oss://testbucket \
-e oss-cn-shanghai.aliyuncs.com \
-i yourAccessKeyID \
-k yourAccessKeySecretUntuk daftar lengkap opsi umum, lihat Opsi umum.