Todos os produtos
Search

Este produto

    Object Storage Service:GetBucketStat

    Central de documentação

    Object Storage Service:GetBucketStat

    Última atualização: Jul 03, 2026

    Chame a operação GetBucketStat para obter a capacidade de armazenamento, o número de objetos e o número de partes multipart de um bucket especificado.

    Observações de uso

    • Para chamar esta operação, é necessária a permissão oss:GetBucketStat.

    • Os dados retornados por esta operação não são em tempo real e podem apresentar atraso superior a uma hora.

    • Não há garantia de que as informações de armazenamento retornadas sejam as mais recentes. O valor LastModifiedTime em uma resposta pode ser anterior ao valor LastModifiedTime de uma resposta anterior.

    Sintaxe da solicitação

    GET /?stat HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    Cabeçalhos da solicitação

    DescribeRegions utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos de solicitação comuns.

    Cabeçalhos da resposta

    A resposta contém apenas cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos de resposta comuns.

    Elementos da resposta

    Name

    Type

    Example

    Description

    BucketStat

    Container

    N/A

    Contêiner da estrutura BucketStat.

    Storage

    Positive integer

    1600

    Capacidade total real de armazenamento do bucket. Unidade: bytes.

    Nó pai: BucketStat

    Nó filho: Nenhum

    ObjectCount

    Positive integer

    230

    Número total de objetos no bucket.

    Nó pai: BucketStat

    Nó filho: Nenhum

    MultipartUploadCount

    Positive integer

    40

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

    Nó pai: BucketStat

    Nó filho: Nenhum

    LiveChannelCount

    Positive integer

    4

    Total de LiveChannels no bucket.

    Nó pai: BucketStat

    Nó filho: Nenhum

    MultipartPartCount

    Positive integer

    128

    Número de partes multipart enviadas ao bucket.

    Nó pai: BucketStat

    Nó filho: Nenhum

    MultipartPartStorage

    Positive integer

    524288000

    Capacidade de armazenamento das partes multipart enviadas ao bucket. Unidade: bytes.

    Nó pai: BucketStat

    Nó filho: Nenhum

    DeleteMarkerCount

    Positive integer

    12

    Quantidade de marcadores de exclusão no bucket.

    Nó pai: BucketStat

    Nó filho: Nenhum

    LastModifiedTime

    Positive integer

    1643341269

    Momento em que as informações de armazenamento foram obtidas. O valor é um timestamp UNIX em segundos.

    Nó pai: BucketStat

    Nó filho: Nenhum

    StandardStorage

    Positive integer

    430

    Capacidade de armazenamento dos objetos Standard. Unidade: bytes.

    Nó pai: BucketStat

    Nó filho: Nenhum

    StandardObjectCount

    Positive integer

    66

    Total de objetos da classe Standard.

    Nó pai: BucketStat

    Nó filho: Nenhum

    StandardMultipartPartCount

    Positive integer

    10

    Número de partes multipart da classe Standard enviadas ao bucket.

    Nó pai: BucketStat

    Nó filho: Nenhum

    StandardMultipartPartStorage

    Positive integer

    104857600

    Capacidade de armazenamento das partes multipart da classe Standard enviadas ao bucket. Unidade: bytes.

    Nó pai: BucketStat

    Nó filho: Nenhum

    InfrequentAccessStorage

    Positive integer

    2359296

    Capacidade de armazenamento faturável dos objetos Infrequent Access (IA). Unidade: bytes.

    Importante

    Objetos menores que 64 KB são calculados como 64 KB. Para mais informações sobre faturamento, consulte Taxas de armazenamento.

    Nó pai: BucketStat

    Nó filho: Nenhum

    InfrequentAccessRealStorage

    Positive integer

    360

    Quantidade real de armazenamento utilizada pela classe Infrequent Access, em bytes.

    Nó pai: BucketStat

    Nó filho: Nenhum

    InfrequentAccessObjectCount

    Positive integer

    54

    Contagem de objetos da classe IA.

    Nó pai: BucketStat

    Nó filho: Nenhum

    InfrequentMultipartPartCount

    Positive integer

    10

    Total de partes multipart da classe IA enviadas ao bucket.

    Nó pai: BucketStat

    Nó filho: Nenhum

    InfrequentMultipartPartStorage

    Positive integer

    104857600

    Capacidade de armazenamento das partes multipart da classe IA enviadas ao bucket. Unidade: bytes.

    Nó pai: BucketStat

    Nó filho: Nenhum

    ArchiveStorage

    Positive integer

    2949120

    Capacidade de armazenamento faturável dos objetos Archive. Unidade: bytes.

    Importante

    Objetos menores que 64 KB são calculados como 64 KB. Para mais informações sobre faturamento, consulte Taxas de armazenamento.

    Nó pai: BucketStat

    Nó filho: Nenhum

    ArchiveRealStorage

    Positive integer

    450

    Capacidade real de armazenamento dos objetos Archive. Unidade: bytes.

    Nó pai: BucketStat

    Nó filho: Nenhum

    ArchiveObjectCount

    Positive integer

    74

    Quantidade de objetos da classe Archive.

    Nó pai: BucketStat

    Nó filho: Nenhum

    ArchiveMultipartPartCount

    Positive integer

    10

    Número de partes multipart da classe Archive enviadas ao bucket.

    Nó pai: BucketStat

    Nó filho: Nenhum

    ArchiveMultipartPartStorage

    Positive integer

    104857600

    Capacidade de armazenamento das partes multipart da classe Archive enviadas ao bucket. Unidade: bytes.

    Nó pai: BucketStat

    Nó filho: Nenhum

    ColdArchiveStorage

    Positive integer

    2359296

    Capacidade de armazenamento faturável dos objetos Cold Archive. Unidade: bytes.

    Importante

    Objetos menores que 64 KB são calculados como 64 KB. Para mais informações sobre faturamento, consulte Taxas de armazenamento.

    Nó pai: BucketStat

    Nó filho: Nenhum

    ColdArchiveRealStorage

    Positive integer

    360

    Capacidade real de armazenamento dos objetos Cold Archive. Unidade: bytes.

    Nó pai: BucketStat

    Nó filho: Nenhum

    ColdArchiveObjectCount

    Positive integer

    36

    Total de objetos classificados como Cold Archive.

    Nó pai: BucketStat

    Nó filho: Nenhum

    ColdArchiveMultipartPartCount

    Positive integer

    10

    Quantidade de partes multipart da classe Cold Archive enviadas ao bucket.

    Nó pai: BucketStat

    Nó filho: Nenhum

    ColdArchiveMultipartPartStorage

    Positive integer

    104857600

    Capacidade de armazenamento das partes multipart da classe Cold Archive enviadas ao bucket. Unidade: bytes.

    Nó pai: BucketStat

    Nó filho: Nenhum

    DeepColdArchiveStorage

    Positive integer

    2359296

    Capacidade de armazenamento faturável dos objetos Deep Cold Archive. Unidade: bytes.

    Importante

    Objetos menores que 64 KB são calculados como 64 KB. Para mais informações sobre faturamento, consulte Taxas de armazenamento.

    Nó pai: BucketStat

    Nó filho: Nenhum

    DeepColdArchiveRealStorage

    Positive integer

    360

    Capacidade real de armazenamento dos objetos Deep Cold Archive. Unidade: bytes.

    Nó pai: BucketStat

    Nó filho: Nenhum

    DeepColdArchiveObjectCount

    Positive integer

    36

    Número de objetos na classe Deep Cold Archive.

    Nó pai: BucketStat

    Nó filho: Nenhum

    DeepColdArchiveMultipartPartCount

    Positive integer

    10

    Total de partes multipart da classe Deep Cold Archive enviadas ao bucket.

    Nó pai: BucketStat

    Nó filho: Nenhum

    DeepColdArchiveMultipartPartStorage

    Positive integer

    104857600

    Capacidade de armazenamento das partes multipart da classe Deep Cold Archive enviadas ao bucket. Unidade: bytes.

    Nó pai: BucketStat

    Nó filho: Nenhum

    Exemplos

    • Exemplo de solicitação

      GET /?stat HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 01:17:29 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    • Exemplo de resposta

      <?xml version="1.0" encoding="UTF-8"?>
<BucketStat>
  <Storage>1600</Storage>
  <ObjectCount>230</ObjectCount>
  <MultipartUploadCount>40</MultipartUploadCount>
  <LiveChannelCount>4</LiveChannelCount>
  <LastModifiedTime>1643341269</LastModifiedTime>
  <StandardStorage>430</StandardStorage>
  <StandardObjectCount>66</StandardObjectCount>
  <InfrequentAccessStorage>2359296</InfrequentAccessStorage>
  <InfrequentAccessRealStorage>360</InfrequentAccessRealStorage>
  <InfrequentAccessObjectCount>54</InfrequentAccessObjectCount>
  <ArchiveStorage>2949120</ArchiveStorage>
  <ArchiveRealStorage>450</ArchiveRealStorage>
  <ArchiveObjectCount>74</ArchiveObjectCount>
  <ColdArchiveStorage>2359296</ColdArchiveStorage>
  <ColdArchiveRealStorage>360</ColdArchiveRealStorage>
  <ColdArchiveObjectCount>36</ColdArchiveObjectCount>
</BucketStat>

    SDK

    Os seguintes kits de desenvolvimento de software (SDKs) estão disponíveis para esta operação:

    Ferramenta de linha de comando ossutil

    Para mais informações sobre o comando ossutil referente à operação GetBucketStat, consulte get-bucket-stat.

    Códigos de erro

    Código de erro

    Código de status HTTP

    Descrição

    AccessDenied

    403

    Você não tem permissão para visualizar as informações de capacidade de armazenamento do bucket. Apenas o proprietário do bucket pode visualizar essas informações.