Topik ini menjelaskan cara mengambil kapasitas penyimpanan bucket serta jumlah dan kapasitas penyimpanan objek untuk setiap kelas penyimpanan dalam bucket tersebut.
Catatan penggunaan
Pada topik ini digunakan titik akhir publik wilayah China (Hangzhou). Jika Anda ingin mengakses OSS dari layanan Alibaba Cloud lainnya yang berada di wilayah yang sama dengan OSS, gunakan titik akhir internal. Untuk informasi selengkapnya mengenai wilayah dan titik akhir OSS, lihat Wilayah dan titik akhir.
Pada topik ini, kredensial akses diperoleh dari variabel lingkungan. Untuk informasi selengkapnya tentang cara mengonfigurasi kredensial akses, lihat Konfigurasi kredensial akses.
Pada topik ini, instans OSSClient dibuat menggunakan titik akhir OSS. Jika Anda ingin membuat instans OSSClient menggunakan nama domain kustom atau Security Token Service (STS), lihat Konfigurasi client (Go SDK V1).
Kode contoh berikut menggunakan properti yang didukung pada Go SDK versi 2.2.5 dan yang lebih baru.
Kode contoh
Kode berikut mengambil kapasitas penyimpanan bucket bernama examplebucket serta jumlah dan kapasitas penyimpanan objek untuk setiap kelas penyimpanan dalam bucket tersebut.
package main
import (
"log"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
)
func main() {
// Dapatkan kredensial akses dari variabel lingkungan.
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
log.Fatalf("Gagal mendapatkan kredensial dari variabel lingkungan: %v", err)
}
// Buat instans OSSClient.
// Setel yourEndpoint ke titik akhir bucket. Misalnya, untuk wilayah China (Hangzhou), setel titik akhir ke https://oss-cn-hangzhou.aliyuncs.com. Untuk wilayah lain, tentukan titik akhir yang sesuai.
// Setel yourRegion ke wilayah tempat bucket berada. Misalnya, untuk wilayah China (Hangzhou), setel wilayah ke cn-hangzhou. Untuk wilayah lain, tentukan wilayah yang sesuai.
clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
clientOptions = append(clientOptions, oss.Region("yourRegion"))
// Setel versi signature.
clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
client, err := oss.New("yourEndpoint", "", "", clientOptions...)
if err != nil {
log.Fatalf("Gagal membuat client OSS baru: %v", err)
}
// Tentukan nama bucket. Misalnya, examplebucket.
bucketName := "examplebucket"
stat, err := client.GetBucketStat(bucketName)
if err != nil {
log.Fatalf("Gagal mendapatkan statistik bucket '%s': %v", bucketName, err)
}
// Dapatkan total kapasitas penyimpanan bucket dalam byte.
log.Printf("Bucket Stat Storage: %d bytes\n", stat.Storage)
// Dapatkan total jumlah objek dalam bucket.
log.Printf("Bucket Stat Object Count: %d\n", stat.ObjectCount)
}
Informasi umum mengenai kapasitas penyimpanan
Parameter | Deskripsi |
Storage | Total kapasitas penyimpanan bucket dalam byte. |
ObjectCount | Total jumlah objek dalam bucket. |
MultipartUploadCount | Jumlah unggah multi-bagian yang telah dimulai tetapi belum diselesaikan atau dibatalkan dalam bucket. |
LiveChannelCount | Jumlah LiveChannel dalam bucket. |
LastModifiedTime | Waktu saat informasi penyimpanan diperoleh oleh panggilan ini. Nilainya berupa stempel waktu UNIX. Satuan: detik. |
StandardStorage | Kapasitas penyimpanan objek Standard dalam byte. |
StandardObjectCount | Jumlah objek Standard. |
InfrequentAccessStorage | Kapasitas penyimpanan objek Akses Jarang yang dikenai tagihan dalam byte. |
InfrequentAccessRealStorage | Kapasitas penyimpanan aktual objek Akses Jarang dalam byte. |
InfrequentAccessObjectCount | Jumlah objek Akses Jarang. |
ArchiveStorage | Kapasitas penyimpanan objek Archive Storage yang dikenai tagihan dalam byte. |
ArchiveRealStorage | Kapasitas penyimpanan aktual objek Archive Storage dalam byte. |
ArchiveObjectCount | Jumlah objek Archive Storage. |
ColdArchiveStorage | Kapasitas penyimpanan objek Cold Archive yang dikenai tagihan dalam byte. |
ColdArchiveRealStorage | Kapasitas penyimpanan aktual objek Cold Archive dalam byte. |
ColdArchiveObjectCount | Jumlah objek Cold Archive. |
Referensi
Untuk informasi selengkapnya mengenai API kapasitas penyimpanan bucket, lihat BucketStat.