Chame a operação GetBucketStat para obter a capacidade de armazenamento, o número de objetos e o número de partes de uploads multipart de um bucket específico.
Notas 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 um atraso superior a uma hora.
Não há garantia de que as informações de armazenamento retornadas por esta operação sejam as mais recentes. O valor de LastModifiedTime em uma resposta pode ser anterior ao valor de LastModifiedTime de uma resposta anterior.
Sintaxe da requisição
GET /?stat HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueCabeçalhos da requisição
O DescribeRegions utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte Common request headers.
Cabeçalhos da resposta
A resposta contém apenas cabeçalhos de resposta comuns. Para mais informações, consulte Common response headers.
Elementos da resposta
|
Nome |
Tipo |
Exemplo |
Descrição |
|
BucketStat |
Contêiner |
N/A |
Um contêiner para a estrutura BucketStat. |
|
Storage |
Inteiro positivo |
1600 |
A capacidade total real de armazenamento do bucket. Unidade: bytes. Nó pai: BucketStat Nó filho: Nenhum |
|
ObjectCount |
Inteiro positivo |
230 |
O número total de objetos no bucket. Nó pai: BucketStat Nó filho: Nenhum |
|
MultipartUploadCount |
Inteiro positivo |
40 |
O número de uploads multipart iniciados, mas não concluídos ou abortados no bucket. Nó pai: BucketStat Nó filho: Nenhum |
|
LiveChannelCount |
Inteiro positivo |
4 |
O número de LiveChannels no bucket. Nó pai: BucketStat Nó filho: Nenhum |
|
MultipartPartCount |
Inteiro positivo |
128 |
O número de partes de uploads multipart enviadas para o bucket. Nó pai: BucketStat Nó filho: Nenhum |
|
MultipartPartStorage |
Inteiro positivo |
524288000 |
A capacidade de armazenamento das partes de uploads multipart enviadas para o bucket. Unidade: bytes. Nó pai: BucketStat Nó filho: Nenhum |
|
DeleteMarkerCount |
Inteiro positivo |
12 |
O número de marcadores de exclua no bucket. Nó pai: BucketStat Nó filho: Nenhum |
|
LastModifiedTime |
Inteiro positivo |
1643341269 |
O momento em que as informações de armazenamento foram obtidas. O valor é um timestamp UNIX em segundos. Nó pai: BucketStat Nó filho: Nenhum |
|
StandardStorage |
Inteiro positivo |
430 |
A capacidade de armazenamento de objetos Standard. Unidade: bytes. Nó pai: BucketStat Nó filho: Nenhum |
|
StandardObjectCount |
Inteiro positivo |
66 |
O número de objetos Standard. Nó pai: BucketStat Nó filho: Nenhum |
|
StandardMultipartPartCount |
Inteiro positivo |
10 |
O número de partes de uploads multipart Standard enviadas para o bucket. Nó pai: BucketStat Nó filho: Nenhum |
|
StandardMultipartPartStorage |
Inteiro positivo |
104857600 |
A capacidade de armazenamento das partes de uploads multipart Standard enviadas para o bucket. Unidade: bytes. Nó pai: BucketStat Nó filho: Nenhum |
|
InfrequentAccessStorage |
Inteiro positivo |
2359296 |
A capacidade de armazenamento faturável de objetos Infrequent Access (IA). Unidade: bytes. Importante
Um objeto menor que 64 KB é calculado como 64 KB. Para mais informações sobre faturamento, consulte Storage fees. Nó pai: BucketStat Nó filho: Nenhum |
|
InfrequentAccessRealStorage |
Inteiro positivo |
360 |
A capacidade de armazenamento real utilizada pela classe de armazenamento Infrequent Access, em bytes. Nó pai: BucketStat Nó filho: Nenhum |
|
InfrequentAccessObjectCount |
Inteiro positivo |
54 |
O número de objetos IA. Nó pai: BucketStat Nó filho: Nenhum |
|
InfrequentMultipartPartCount |
Inteiro positivo |
10 |
O número de partes de uploads multipart IA enviadas para o bucket. Nó pai: BucketStat Nó filho: Nenhum |
|
InfrequentMultipartPartStorage |
Inteiro positivo |
104857600 |
A capacidade de armazenamento das partes de uploads multipart IA enviadas para o bucket. Unidade: bytes. Nó pai: BucketStat Nó filho: Nenhum |
|
ArchiveStorage |
Inteiro positivo |
2949120 |
A capacidade de armazenamento faturável de objetos Archive. Unidade: bytes. Importante
Um objeto menor que 64 KB é calculado como 64 KB. Para mais informações sobre faturamento, consulte Storage fees. Nó pai: BucketStat Nó filho: Nenhum |
|
ArchiveRealStorage |
Inteiro positivo |
450 |
A capacidade de armazenamento real de objetos Archive. Unidade: bytes. Nó pai: BucketStat Nó filho: Nenhum |
|
ArchiveObjectCount |
Inteiro positivo |
74 |
O número de objetos Archive. Nó pai: BucketStat Nó filho: Nenhum |
|
ArchiveMultipartPartCount |
Inteiro positivo |
10 |
O número de partes de uploads multipart Archive enviadas para o bucket. Nó pai: BucketStat Nó filho: Nenhum |
|
ArchiveMultipartPartStorage |
Inteiro positivo |
104857600 |
A capacidade de armazenamento das partes de uploads multipart Archive enviadas para o bucket. Unidade: bytes. Nó pai: BucketStat Nó filho: Nenhum |
|
ColdArchiveStorage |
Inteiro positivo |
2359296 |
A capacidade de armazenamento faturável de objetos Cold Archive. Unidade: bytes. Importante
Um objeto menor que 64 KB é calculado como 64 KB. Para mais informações sobre faturamento, consulte Storage fees. Nó pai: BucketStat Nó filho: Nenhum |
|
ColdArchiveRealStorage |
Inteiro positivo |
360 |
A capacidade de armazenamento real de objetos Cold Archive. Unidade: bytes. Nó pai: BucketStat Nó filho: Nenhum |
|
ColdArchiveObjectCount |
Inteiro positivo |
36 |
O número de objetos Cold Archive. Nó pai: BucketStat Nó filho: Nenhum |
|
ColdArchiveMultipartPartCount |
Inteiro positivo |
10 |
O número de partes de uploads multipart Cold Archive enviadas para o bucket. Nó pai: BucketStat Nó filho: Nenhum |
|
ColdArchiveMultipartPartStorage |
Inteiro positivo |
104857600 |
A capacidade de armazenamento das partes de uploads multipart Cold Archive enviadas para o bucket. Unidade: bytes. Nó pai: BucketStat Nó filho: Nenhum |
|
DeepColdArchiveStorage |
Inteiro positivo |
2359296 |
A capacidade de armazenamento faturável de objetos Deep Cold Archive. Unidade: bytes. Importante
Um objeto menor que 64 KB é calculado como 64 KB. Para mais informações sobre faturamento, consulte Storage fees. Nó pai: BucketStat Nó filho: Nenhum |
|
DeepColdArchiveRealStorage |
Inteiro positivo |
360 |
A capacidade de armazenamento real de objetos Deep Cold Archive. Unidade: bytes. Nó pai: BucketStat Nó filho: Nenhum |
|
DeepColdArchiveObjectCount |
Inteiro positivo |
36 |
O número de objetos Deep Cold Archive. Nó pai: BucketStat Nó filho: Nenhum |
|
DeepColdArchiveMultipartPartCount |
Inteiro positivo |
10 |
O número de partes de uploads multipart Deep Cold Archive enviadas para o bucket. Nó pai: BucketStat Nó filho: Nenhum |
|
DeepColdArchiveMultipartPartStorage |
Inteiro positivo |
104857600 |
A capacidade de armazenamento das partes de uploads multipart Deep Cold Archive enviadas para o bucket. Unidade: bytes. Nó pai: BucketStat Nó filho: Nenhum |
Exemplos
-
Exemplo de requisiçã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 para a 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 visualize as informações de capacidade de armazenamento do bucket. Somente o proprietário do bucket pode visualize essas informações. |