Todos os produtos
Search
Central de documentação

Object Storage Service:Query the storage capacity of a bucket (Go SDK V1)

Última atualização: Jul 03, 2026

Este tópico descreve como obter a capacidade de armazenamento de um bucket, além da quantidade e do volume de objetos por classe de armazenamento.

Observações

  • Os exemplos deste tópico usam o endpoint público da região China (Hangzhou). Para acessar o OSS a partir de outros serviços da Alibaba Cloud na mesma região, use um endpoint interno. Para mais informações sobre regiões e endpoints do OSS, consulte Regiões e endpoints.

  • As credenciais de acesso são obtidas de variáveis de ambiente. Para saber como configure credenciais de acesso, consulte Configurar credenciais de acesso.

  • Este tópico demonstra como crie uma instância OSSClient com um endpoint do OSS. Para outras configurações, como uso de domínio personalizado ou autenticação via Security Token Service (STS), consulte Configurar um cliente (Go SDK V1).

  • O código de exemplo a seguir usa propriedades compatíveis com o Go SDK 2.2.5 ou superior.

Código de exemplo

O código a seguir obtém a capacidade de armazenamento do bucket examplebucket, bem como a quantidade e o volume de objetos de cada classe de armazenamento no bucket.

package main

import (
	"log"

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

func main() {
	// Obtain access credentials from environment variables.
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		log.Fatalf("Failed to get credentials from environment variables: %v", err)
	}

	// Create an OSSClient instance.
	// Set yourEndpoint to the endpoint of the bucket. For example, for the China (Hangzhou) region, set the endpoint to https://oss-cn-hangzhou.aliyuncs.com. For other regions, specify the actual endpoint.
	// Set yourRegion to the region where the bucket is located. For example, for the China (Hangzhou) region, set the region to cn-hangzhou. For other regions, specify the actual region.
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	// Set the signature version.
	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)
	}

	// Specify the bucket name. For example, examplebucket.
	bucketName := "examplebucket"
	stat, err := client.GetBucketStat(bucketName)
	if err != nil {
		log.Fatalf("Failed to get bucket statistics for bucket '%s': %v", bucketName, err)
	}

	// Get the total storage capacity of the bucket in bytes.
	log.Printf("Bucket Stat Storage: %d bytes\n", stat.Storage)
	// Get the total number of objects in the bucket.
	log.Printf("Bucket Stat Object Count: %d\n", stat.ObjectCount)
}

Informações comuns sobre capacidade de armazenamento

Parâmetro

Descrição

Storage

Capacidade total de armazenamento do bucket em bytes.

ObjectCount

Quantidade total de objetos no bucket.

MultipartUploadCount

Número de uploads multipart iniciados, mas não concluídos ou abortados no bucket.

LiveChannelCount

Quantidade de LiveChannels no bucket.

LastModifiedTime

Horário em que as informações de armazenamento foram obtidas nesta chamada. O valor é um timestamp UNIX. Unidade: segundos.

StandardStorage

Capacidade de armazenamento de objetos Standard em bytes.

StandardObjectCount

Quantidade de objetos Standard.

InfrequentAccessStorage

Capacidade faturável de objetos Infrequent Access em bytes.

InfrequentAccessRealStorage

Capacidade real de armazenamento de objetos Infrequent Access em bytes.

InfrequentAccessObjectCount

Quantidade de objetos Infrequent Access.

ArchiveStorage

Capacidade faturável de objetos Archive Storage em bytes.

ArchiveRealStorage

Capacidade real de armazenamento de objetos Archive Storage em bytes.

ArchiveObjectCount

Quantidade de objetos Archive Storage.

ColdArchiveStorage

Capacidade faturável de objetos Cold Archive em bytes.

ColdArchiveRealStorage

Capacidade real de armazenamento de objetos Cold Archive em bytes.

ColdArchiveObjectCount

Quantidade de objetos Cold Archive.

Referências

  • Para mais informações sobre a API de capacidade de armazenamento de buckets, consulte BucketStat.