全部產品
Search
文件中心

Object Storage Service:Go擷取儲存空間的儲存容量

更新時間:Oct 26, 2024

本文介紹如何擷取指定儲存空間(Bucket)的儲存容量以及Bucket內不同儲存類型檔案(Object)的數量及其儲存容量。

注意事項

  • 本文以華東1(杭州)外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS,請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係,請參見OSS訪問網域名稱、資料中心、開放連接埠

  • 本文以從環境變數讀取存取憑證為例。如何配置訪問憑證,請參見配置訪問憑證

  • 本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient,請參見初始化

  • Go SDK 2.2.5及以上版本支援返回以下範例程式碼中包含的所有屬性。

範例程式碼

以下代碼用於擷取examplebucket的儲存容量以及該Bucket內不同儲存類型Object的數量及其儲存容量。

package main

import (
	"log"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func main() {
	// 從環境變數中擷取訪問憑證。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		log.Fatalf("Failed to get credentials from environment variables: %v", err)
	}

	// 建立OSSClient執行個體。
	// yourEndpoint填寫Bucket對應的Endpoint,以華東1(杭州)為例,填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
	// yourRegion填寫Bucket所在地區,以華東1(杭州)為例,填寫為cn-hangzhou。其它Region請按實際情況填寫。
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	// 設定簽名版本
	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
	if err != nil {
		log.Fatalf("Failed to create new OSS client: %v", err)
	}

	// 填寫Bucket名稱,例如examplebucket。
	bucketName := "examplebucket"
	stat, err := client.GetBucketStat(bucketName)
	if err != nil {
		log.Fatalf("Failed to get bucket statistics for bucket '%s': %v", bucketName, err)
	}

	// 擷取Bucket的總儲存量,單位為位元組。
	log.Printf("Bucket Stat Storage: %d bytes\n", stat.Storage)
	// 擷取Bucket中總的Object數量。
	log.Printf("Bucket Stat Object Count: %d\n", stat.ObjectCount)
}

常用儲存容量資訊列表

參數

描述

Storage

儲存空間總儲存量,單位為位元組

ObjectCount

儲存空間中總的Object數量

MultipartUploadCount

儲存空間中已經初始化但還未完成或者還未中止的分區上傳數量

LiveChannelCount

儲存空間中Live Channel的數量

LastModifiedTime

此次調用擷取到的儲存資訊的時間點,格式為時間戳記,單位為秒

StandardStorage

標準儲存類型Object的儲存量,單位為位元組

StandardObjectCount

標準儲存類型Object數量

InfrequentAccessStorage

低頻儲存類型Object的計費儲存量,單位為位元組

InfrequentAccessRealStorage

低頻儲存類型Object的實際儲存量,單位為位元組

InfrequentAccessObjectCount

低頻儲存類型Object數量

ArchiveStorage

Archive Storage類型Object的計費儲存量,單位為位元組

ArchiveRealStorage

Archive Storage類型Object的實際儲存量,單位為位元組

ArchiveObjectCount

Archive Storage類型Object數量

ColdArchiveStorage

冷Archive Storage類型Object的計費儲存量,單位為位元組

ColdArchiveRealStorage

冷Archive Storage類型Object的實際儲存量,單位為位元組

ColdArchiveObjectCount

冷Archive Storage類型Object數量

相關文檔

  • 關於儲存空間容量資訊的介面說明,請參見BucketStat