全部产品
Search
文档中心

Object Storage Service:Kueri kapasitas penyimpanan bucket (Go SDK V1)

更新时间:Nov 29, 2025

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.