Kueri informasi bucket dan informasi objek - Object Storage Service

Tema ini menjelaskan cara menjalankan perintah stat untuk menanyakan informasi bucket atau objek. Sebagai contoh, Anda dapat menggunakan perintah ini untuk menanyakan kelas penyimpanan bucket dan metadata objek.

Penting

Untuk ossutil versi 1.6.16 ke atas, Anda dapat langsung menggunakan ossutil sebagai nama biner di baris perintah tanpa memperbarui nama biner berdasarkan sistem operasi. Untuk ossutil sebelum versi 1.6.16, Anda harus memperbarui nama biner sesuai dengan sistem operasi. Untuk informasi lebih lanjut, lihat Referensi perintah ossutil.
Hanya pemilik bucket dan pengguna RAM yang memiliki izin oss:GetObject, oss:GetObjectAcl, dan oss:GetBucketInfo yang diizinkan menggunakan perintah stat untuk menanyakan metadata objek.

Sintaks perintah

ossutil stat oss://bucketname[/objectname]
[--encoding-type <value>]
[--payer <value>]
[--version-id <value>]

Tabel berikut menjelaskan parameter dan opsi dalam sintaks perintah.

Parameter/Opsi	Deskripsi
bucketname	Nama bucket.
objectname	Nama objek yang ingin Anda tanyakan informasinya.
--encoding-type	Pengkodean nama objek. Nilai valid: url. Jika opsi ini tidak ditentukan, nama objek tidak dikodekan.
--payer	Pembayar biaya yang dihasilkan oleh operasi. Jika Anda ingin pihak peminta yang mengakses sumber daya di jalur tertentu membayar biaya yang dihasilkan oleh operasi, seperti lalu lintas dan biaya permintaan, atur parameter ini ke requester.
--version-id	ID versi objek. Parameter ini hanya berlaku untuk bucket dengan penomoran versi aktif atau dinonaktifkan.

Contoh

Kueri informasi bucket examplebucket.

 ossutil stat oss://examplebucket

Output sampel berikut menunjukkan bahwa perintah mendapatkan informasi tentang bucket examplebucket, seperti nama bucket, wilayah, waktu pembuatan, dan daftar kontrol akses (ACL).

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

Kueri informasi objek exampleobject.jpg di bucket examplebucket.

ossutil stat oss://examplebucket/exampleobject.jpg

Output sampel berikut menunjukkan bahwa perintah mendapatkan informasi tentang objek exampleobject.jpg, seperti ACL, Content-Type, ETag, dan waktu modifikasi terakhir.

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

Kueri informasi objek dengan karakter khusus dalam nama objek di bucket examplebucket.
Sebagai contoh, Anda ingin menanyakan informasi objek 示例.txt di bucket examplebucket. ossutil hanya mendukung pengkodean URL untuk nama objek. Jika nama objek berisi karakter khusus, Anda harus mengkodekan karakter tersebut menjadi format yang aman untuk URL sebelum digunakan dalam perintah.
```
ossutil stat oss://examplebucket/%E7%A4%BA%E4%BE%8B.txt --encoding-type url
```
Output sampel berikut menunjukkan bahwa perintah mendapatkan informasi tentang objek 示例.txt, seperti ACL, Content-Type, ETag, dan waktu modifikasi terakhir.
```
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 informasi objek dari versi tertentu di bucket examplebucket.

ossutil stat oss://examplebucket/test.jpg --version-id  CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz****

Untuk informasi lebih lanjut tentang cara menanyakan versi objek, lihat Is.

Output sampel berikut menunjukkan bahwa perintah mendapatkan informasi tentang objek, seperti ACL, Content-Type, ETag, waktu modifikasi terakhir, dan ID versi.

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

Opsi umum

Jika Anda menggunakan ossutil untuk beralih ke bucket yang berada di wilayah lain, tambahkan opsi -e untuk menentukan Titik akhir wilayah tempat bucket berada. Jika Anda menggunakan ossutil untuk beralih ke bucket yang dimiliki oleh akun Alibaba Cloud lain, tambahkan opsi -i untuk menentukan ID AccessKey dari akun tersebut, serta opsi -k untuk menentukan Rahasia AccessKey dari akun tersebut.

Sebagai contoh, Anda dapat menjalankan perintah berikut untuk menanyakan informasi bucket testbucket yang berada di wilayah China (Shanghai) dan dimiliki oleh akun Alibaba Cloud lain:

ossutil stat oss://testbucket  -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Untuk informasi lebih lanjut tentang opsi umum, lihat Opsi Umum.