すべてのプロダクト
Search

このプロダクト

    Object Storage Service:GetBucketStat

    ドキュメントセンター

    Object Storage Service:GetBucketStat

    最終更新日:Nov 26, 2025

    GetBucketStat 操作を呼び出して、指定されたバケットのストレージ容量、オブジェクト数、およびマルチパートパート数を取得できます。

    使用上の注意

    • この操作を呼び出すには、oss:GetBucketStat 権限が必要です。

    • この操作によって返されるデータはリアルタイムではなく、1 時間以上遅延する可能性があります。

    • この操作によって返されるストレージ情報は、最新であることが保証されていません。レスポンス内の `LastModifiedTime` の値が、以前のレスポンスの `LastModifiedTime` の値よりも古い場合があります。

    リクエスト構文

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

    リクエストヘッダー

    この操作のリクエストのすべてのヘッダーは、共通リクエストヘッダーです。詳細については、「共通リクエストヘッダー」をご参照ください。

    レスポンスヘッダー

    この操作のレスポンスのすべてのヘッダーは、共通レスポンスヘッダーです。詳細については、「共通レスポンスヘッダー」をご参照ください。

    レスポンス要素

    名前

    タイプ

    例

    説明

    BucketStat

    コンテナー

    該当なし

    `BucketStat` 構造のコンテナーです。

    Storage

    正の整数

    1600

    バケットの合計実ストレージ容量です。単位：バイト。

    親ノード：BucketStat

    子ノード：なし

    ObjectCount

    正の整数

    230

    バケット内のオブジェクトの総数。

    親ノード：BucketStat

    子ノード：なし

    MultipartUploadCount

    正の整数

    40

    バケット内で開始されたが、完了または中止されていないマルチパートアップロードの数です。

    親ノード：BucketStat

    子ノード：なし

    LiveChannelCount

    正の整数

    4

    バケット内の LiveChannel の数。

    親ノード：BucketStat

    子ノード：なし

    MultipartPartCount

    正の整数

    128

    バケットにアップロードされたマルチパートパートの数です。

    親ノード：BucketStat

    子ノード：なし

    MultipartPartStorage

    正の整数

    524288000

    バケットにアップロードされたマルチパートパートのストレージ容量です。単位：バイト。

    親ノード：BucketStat

    子ノード：なし

    DeleteMarkerCount

    正の整数

    12

    バケット内の削除マーカーの数です。

    親ノード：BucketStat

    子ノード：なし

    LastModifiedTime

    正の整数

    1643341269

    取得したストレージ情報の時点です。値は秒単位の UNIX タイムスタンプです。

    親ノード：BucketStat

    子ノード：なし

    StandardStorage

    正の整数

    430

    標準ストレージオブジェクトのストレージ容量です。単位：バイト。

    親ノード：BucketStat

    子ノード：なし

    StandardObjectCount

    正の整数

    66

    標準オブジェクトの数です。

    親ノード：BucketStat

    子ノード：なし

    StandardMultipartPartCount

    正の整数

    10

    バケットにアップロードされた標準ストレージのマルチパートパートの数です。

    親ノード：BucketStat

    子ノード：なし

    StandardMultipartPartStorage

    正の整数

    104857600

    バケットにアップロードされた標準ストレージのマルチパートパートのストレージ容量です。単位：バイト。

    親ノード：BucketStat

    子ノード：なし

    InfrequentAccessStorage

    正の整数

    2359296

    低頻度アクセス (IA) オブジェクトの課金対象ストレージ容量です。単位：バイト。

    重要

    64 KB 未満のオブジェクトは 64 KB として計算されます。課金の詳細については、「ストレージ料金」をご参照ください。

    親ノード：BucketStat

    子ノード：なし

    InfrequentAccessRealStorage

    正の整数

    360

    低頻度アクセスストレージクラスが使用する実際のストレージ容量 (バイト単位) です。

    親ノード：BucketStat

    子ノード：なし

    InfrequentAccessObjectCount

    正の整数

    54

    IA オブジェクトの数です。

    親ノード：BucketStat

    子ノード：なし

    InfrequentMultipartPartCount

    正の整数

    10

    バケットにアップロードされた IA マルチパートパートの数です。

    親ノード：BucketStat

    子ノード：なし

    InfrequentMultipartPartStorage

    正の整数

    104857600

    バケットにアップロードされた IA マルチパートパートのストレージ容量です。単位：バイト。

    親ノード：BucketStat

    子ノード：なし

    ArchiveStorage

    正の整数

    2949120

    アーカイブオブジェクトの課金対象ストレージ容量です。単位：バイト。

    重要

    64 KB 未満のオブジェクトは 64 KB として計算されます。課金の詳細については、「ストレージ料金」をご参照ください。

    親ノード：BucketStat

    子ノード：なし

    ArchiveRealStorage

    正の整数

    450

    アーカイブオブジェクトの実際のストレージ容量です。単位：バイト。

    親ノード：BucketStat

    子ノード：なし

    ArchiveObjectCount

    正の整数

    74

    アーカイブオブジェクトの数です。

    親ノード：BucketStat

    子ノード：なし

    ArchiveMultipartPartCount

    正の整数

    10

    バケットにアップロードされたアーカイブマルチパートパートの数です。

    親ノード：BucketStat

    子ノード：なし

    ArchiveMultipartPartStorage

    正の整数

    104857600

    バケットにアップロードされたアーカイブマルチパートパートのストレージ容量です。単位：バイト。

    親ノード：BucketStat

    子ノード：なし

    ColdArchiveStorage

    正の整数

    2359296

    コールドアーカイブオブジェクトの課金対象ストレージ容量です。単位：バイト。

    重要

    64 KB 未満のオブジェクトは 64 KB として計算されます。課金の詳細については、「ストレージ料金」をご参照ください。

    親ノード：BucketStat

    子ノード：なし

    ColdArchiveRealStorage

    正の整数

    360

    コールドアーカイブオブジェクトの実際のストレージ容量です。単位：バイト。

    親ノード：BucketStat

    子ノード：なし

    ColdArchiveObjectCount

    正の整数

    36

    コールドアーカイブオブジェクトの数です。

    親ノード：BucketStat

    子ノード：なし

    ColdArchiveMultipartPartCount

    正の整数

    10

    バケットにアップロードされたコールドアーカイブマルチパートパートの数です。

    親ノード：BucketStat

    子ノード：なし

    ColdArchiveMultipartPartStorage

    正の整数

    104857600

    バケットにアップロードされたコールドアーカイブマルチパートパートのストレージ容量です。単位：バイト。

    親ノード：BucketStat

    子ノード：なし

    DeepColdArchiveStorage

    正の整数

    2359296

    ディープコールドアーカイブオブジェクトの課金対象ストレージ容量です。単位：バイト。

    重要

    64 KB 未満のオブジェクトは 64 KB として計算されます。課金の詳細については、「ストレージ料金」をご参照ください。

    親ノード：BucketStat

    子ノード：なし

    DeepColdArchiveRealStorage

    正の整数

    360

    ディープコールドアーカイブオブジェクトの実際のストレージ容量です。単位：バイト。

    親ノード：BucketStat

    子ノード：なし

    DeepColdArchiveObjectCount

    正の整数

    36

    ディープコールドアーカイブオブジェクトの数です。

    親ノード：BucketStat

    子ノード：なし

    DeepColdArchiveMultipartPartCount

    正の整数

    10

    バケットにアップロードされたディープコールドアーカイブマルチパートパートの数です。

    親ノード：BucketStat

    子ノード：なし

    DeepColdArchiveMultipartPartStorage

    正の整数

    104857600

    バケットにアップロードされたディープコールドアーカイブマルチパートパートのストレージ容量です。単位：バイト。

    親ノード：BucketStat

    子ノード：なし

    例

    • リクエスト例

      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

    • レスポンス例

      <?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

    この操作には、次のソフトウェア開発キット (SDK) を使用できます：

    ossutil コマンドラインツール

    `GetBucketStat` 操作の ossutil コマンドの詳細については、「get-bucket-stat」をご参照ください。

    エラーコード

    エラーコード

    HTTP ステータスコード

    説明

    AccessDenied

    403

    バケットのストレージ容量情報を表示する権限がありません。バケットの所有者のみがこの情報を表示できます。