全部产品
Search
文档中心

Object Storage Service:stat (Tampilkan informasi bucket dan objek)

更新时间:Mar 21, 2026

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.

Penting

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 ossutil langsung 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/OpsiWajibDeskripsi
bucketnameYaNama bucket.
objectnameTidakNama objek. Abaikan untuk mengkueri informasi tingkat bucket.
--encoding-typeTidakFormat encoding untuk nama objek. Nilai yang valid: url. Jika tidak ditentukan, nama objek tidak diencode.
--payerTidakAtur ke requester agar pihak requester membayar biaya traffic dan permintaan yang dihasilkan oleh operasi ini.
--version-idTidakID versi objek. Hanya berlaku untuk bucket yang telah mengaktifkan atau menangguhkan versioning.

Contoh

Kueri informasi bucket

ossutil stat oss://examplebucket

Contoh 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) elapsed

Bidang output:

BidangDeskripsi
NameNama bucket.
LocationWilayah tempat bucket berada.
CreationDateTanggal dan waktu pembuatan bucket.
ExtranetEndpointTitik akhir publik untuk mengakses bucket melalui internet.
IntranetEndpointTitik akhir internal untuk mengakses bucket dalam jaringan internal Alibaba Cloud.
ACLDaftar kontrol akses (ACL) tingkat bucket.
OwnerID akun Alibaba Cloud pemilik bucket.
StorageClassKelas penyimpanan bucket.
RedundancyTypeJenis redundansi data.
AccessMonitorApakah pemantauan akses diaktifkan untuk bucket tersebut.

Kueri informasi objek

ossutil stat oss://examplebucket/exampleobject.jpg

Contoh 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) elapsed

Bidang output:

BidangDeskripsi
ACLACL tingkat objek. default berarti objek mewarisi ACL bucket.
Accept-RangesMenunjukkan bahwa server mendukung permintaan rentang (bytes).
Content-LengthUkuran objek dalam byte.
Content-Md5Hash MD5 konten objek yang diencode dalam Base64, digunakan untuk verifikasi integritas data.
Content-TypeJenis MIME objek.
EtagTag entitas yang mengidentifikasi versi spesifik objek. Berubah ketika konten objek berubah.
Last-ModifiedTanggal dan waktu terakhir objek dimodifikasi.
OwnerID akun Alibaba Cloud pemilik objek.
X-Oss-Hash-Crc64ecmaChecksum CRC64 objek, digunakan untuk verifikasi integritas data end-to-end.
X-Oss-Object-TypeJenis unggahan yang digunakan untuk membuat objek. Normal menunjukkan unggahan standar (bukan multipart).
X-Oss-Storage-ClassKelas 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 url

Contoh 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) elapsed

Kueri 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) elapsed

Output 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 yourAccessKeySecret

Untuk daftar lengkap opsi umum, lihat Opsi umum.