指定したバケットのストレージ容量とバケットに格納されているオブジェクトの数を照会します。
使用上の注意
- GetBucketStat操作を呼び出すには、
oss:GetBucketStat権限が必要です。 - この操作を呼び出すことによって得られるデータは、リアルタイムデータではなく、1時間を超えるレイテンシを有することがある。
- この操作を呼び出して取得した時刻情報が最新でない場合があります。 例えば、現在のGetBucketStatオペレーションによって取得されたLastModifiedTimeフィールドの値は、以前のGetBucketStatオペレーションによって取得されたこのフィールドの値よりも前であり得る。
リクエスト構文
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タイムスタンプです。 単位は秒です。 親ノード: 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 子ノード: なし |
例
- GET /?stat HTTP/1.1のリクエスト
のサンプル ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com 日付: 2021年12月28日火曜日01:17:29 GMT 権限付与: OSS qn6qrrqxo2oawuk53otfjbyc:ceOEyZavKY4QcjoUWYSpYbJ3 **** - サンプル応答
<?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>