特定のバケットのストレージ使用率とバケット内のオブジェクト数を照会します。 - Object Storage Service

特定のバケットのストレージ使用量とバケット内のオブジェクト数を照会します。

使用上の注意

GetBucketStat操作を呼び出すには、oss:GetBucketStat権限が必要です。
この操作を呼び出すことによって取得されるデータは、リアルタイムデータではなく、1時間を超えるレイテンシを有する場合がある。
この操作を呼び出して取得した時間は最新ではない場合があります。例えば、現在のGetBucketStat要求によって取得されたLastModifiedTimeの値は、前のGetBucketStat要求によって取得されたこのLastModifiedTimeの値よりも前であり得る。

リクエスト構文

GET /?stat HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue

リクエストヘッダー

このリクエストには、共通リクエストヘッダーのみが含まれます。詳細については、「共通HTTPヘッダー」をご参照ください。

レスポンスヘッダー

このリクエストには、共通のレスポンスヘッダーのみが含まれます。詳細については、「共通HTTPヘッダー」をご参照ください。

レスポンス要素

要素	データ型	例	説明
BucketStat	Container	N/A	GetBucketStatリクエストに対して返されたすべての情報を格納するコンテナー。
ストレージ	正の整数	1600	バケットのストレージ使用率。単位：バイト親ノード: BucketStat 子ノード: なし
オブジェクトカウント	正の整数	230	バケット内のオブジェクトの総数。親ノード: BucketStat 子ノード: なし
MultipartUploadCount	正の整数	40	開始されたが完了またはキャンセルされていないマルチパートアップロードタスクの数。親ノード: BucketStat 子ノード: なし
LiveChannelCount	正の整数	4	バケット内のLiveChannelsの数。親ノード: BucketStat 子ノード: なし
LastModifiedTime	正の整数	1643341269	取得した情報が最後に変更された時刻。このパラメーターの値はUNIX timestampです。単位は秒です。親ノード: BucketStat 子ノード: なし
StandardStorage	正の整数	430	バケット内のStandardオブジェクトのストレージ使用率。単位：バイト親ノード: BucketStat 子ノード: なし
StandardObjectCount	正の整数	66	バケット内のStandardオブジェクトの数。親ノード: BucketStat 子ノード: なし
InfrequientAccessStorage	正の整数	2359296	バケット内の低頻度アクセス (IA) オブジェクトの課金ストレージ使用量。単位：バイト重要サイズが64 KB未満のIAオブジェクトは、64 KBとして請求されます。詳細については、「ストレージ料金」をご参照ください。親ノード: BucketStat 子ノード: なし
Infrequency AccessRealStorage	正の整数	360	バケット内のIAオブジェクトの実際のストレージ使用量。単位：バイト親ノード: BucketStat 子ノード: なし
Infrequency AccessObjectCount	正の整数	54	バケット内のIAオブジェクトの数。親ノード: BucketStat 子ノード: なし
ArchiveStorage	正の整数	2949120	バケット内のArchiveオブジェクトの課金ストレージ使用量。単位：バイト重要サイズが64 KB未満のアーカイブオブジェクトは、64 KBとして請求されます。詳細については、「ストレージ料金」をご参照ください。親ノード: BucketStat 子ノード: なし
ArchiveRealStorage	正の整数	450	バケット内のアーカイブオブジェクトの実際のストレージ使用量。単位：バイト親ノード: BucketStat 子ノード: なし
ArchiveObjectCount	正の整数	74	バケット内のアーカイブオブジェクトの数。親ノード: BucketStat 子ノード: なし
ColdArchiveStorage	正の整数	2359296	バケット内のCold Archiveオブジェクトの課金ストレージ使用量。単位：バイト重要サイズが64 KB未満のCold Archiveオブジェクトは、64 KBとして請求されます。詳細については、「ストレージ料金」をご参照ください。親ノード: BucketStat 子ノード: なし
ColdArchiveRealStorage	正の整数	360	バケット内のCold Archiveオブジェクトの実際のストレージ使用量。単位：バイト親ノード: BucketStat 子ノード: なし
ColdArchiveObjectCount	正の整数	36	バケット内のCold Archiveオブジェクトの数。親ノード: BucketStat 子ノード: なし
DeepColdArchiveStorage	正の整数	2359296	バケット内のDeep Cold Archiveオブジェクトの課金ストレージ使用量。単位：バイト重要サイズが64 KB未満のDeep Cold Archiveオブジェクトは、64 KBとして請求されます。詳細については、「ストレージ料金」をご参照ください。親ノード: BucketStat 子ノード: なし
DeepColdArchiveRealStorage	正の整数	360	バケット内のDeep Cold Archiveオブジェクトの実際のストレージ使用量。単位：バイト親ノード: BucketStat 子ノード: なし
DeepColdArchiveObjectCount	正の整数	36	バケット内のDeep Cold Archiveオブジェクトの数。単位：バイト親ノード: BucketStat 子ノード: なし

例

リクエストの例

GET /?stat HTTP/1.1
ホスト: examplebucket.oss-cn-hangzhou.aliyuncs.com
日付: 2021年12月28日火曜日01:17:29 GMT
承認: OSS qn6q ****************: 77Dv **************************

正常に処理された場合のレスポンス例

<?xml version="1.0" encoding="UTF-8"?>
<BucketStat>
  <ストレージ> 1600</ストレージ>
  <ObjectCount>230</ObjectCount>
  <MultipartUploadCount>40</MultipartUploadCount>
  <LiveChannelCount>4</LiveChannelCount>
  <LastModifiedTime>1643341269</LastModifiedTime>
  <StandardStorage>430</StandardStorage>
  <StandardObjectCount>66</StandardObjectCount>
  <Infrequency AccessStorage>2359296</Infrequency AccessStorage>
  <Infrequency AccessRealStorage>360</Infrequency AccessRealStorage>
  <Infrequency AccessObjectCount>54</Infrequency AccessObjectCount>
  <ArchiveStorage>2949120</ArchiveStorage>
  <ArchiveRealStorage>450</ArchiveRealStorage>
  <ArchiveObjectCount>74</ArchiveObjectCount>
  <ColdArchiveStorage>2359296</ColdArchiveStorage>
  <ColdArchiveRealStorage>360</ColdArchiveRealStorage>
  <ColdArchiveObjectCount>36</ColdArchiveObjectCount>
</BucketStat>