You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

复制全文
下载 pdf
ObjectSet
GetObjectSetStorage
复制全文
下载 pdf
GetObjectSetStorage
功能描述​
此接口用于查询指定 ObjectSet 的实际存储用量与对象数,按存储类型维度返回统计值。​
注意事项​
  • ObjectSet 必须存在。​
  • 通过子账号使用时,需要授予当前桶的 GetObjectSetStorage 权限。​
请求消息样式​
​
GET /?objectsetstorage&ObjectSetName=a/b/c HTTP/1.1​
Host: bucket-name.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string​
​
请求参数和消息头​
该请求使用的公共请求消息头,请参见公共参数。​
请求元素​
​
名称​
位置​
参数类型​
是否必选​
示例值​
说明​
ObjectSetName​
Query​
String​
是​
"a/b/c"​
需要查询用量的 ObjectSet 名称。​
说明​
  • 长度限制为 3 ~ 256 个字符。​
  • 如果 Bucket 配置了 PathLevel,则 ObjectSetName 的层级数必须与 Bucket 的配置保持一致。​
  • 不允许以自定义分隔符开头。​
​
响应消息头​
该请求返回的公共响应消息头,请参见公共参数。​
响应元素​
​
名称​
参数类型​
示例值​
说明​
TotalStorageStat​
Object​
-​
总存储统计。​
子节点:Storage、ObjectCount。​
StandardStorageStat​
Object​
-​
标准存储统计。​
子节点:Storage、ObjectCount。​
IAStorageStat​
Object​
-​
低频存储统计。​
子节点:Storage、ObjectCount。​
ArchiveFrStorageStat​
Object​
-​
归档闪回存储统计。​
子节点:Storage、ObjectCount。​
IntelligentTieringStorageStats​
Object​
-​
智能分层存储统计。​
子节点:HighFreqStorageStat、LowFreqStorageStat、ArchiveStorageStat。​
HighFreqStorageStat​
Object​
-​
​
智能分层高频统计。​
父节点:IntelligentTieringStorageStats。​
子节点:Storage、ObjectCount。​
LowFreqStorageStat​
Object​
-​
​
智能分层低频统计。​
父节点:IntelligentTieringStorageStats。​
子节点:Storage、ObjectCount。​
ArchiveStorageStat​
Object​
-​
归档存储统计(归档)。​
子节点:Storage、ObjectCount。​
说明​
若 ArchiveStorageStat 字段位于 IntelligentTieringStorageStats 内,则表示智能分层归档闪回统计。​
ColdArchiveStat​
Object​
-​
冷归档存储统计。​
子节点:Storage、ObjectCount。​
DeepColdArchiveStorageStat​
Object​
-​
深度冷归档存储统计。​
子节点:Storage、ObjectCount。​
Storage​
String​
"1024"​
存储用量,单位为 Byte。必须以字符串形式返回。​
父节点:任意一个 StorageStat​
ObjectCount​
Integer​
10​
对象数量。​
父节点:任意一个 StorageStat​
​
请求示例​
​
GET /?objectsetstorage&ObjectSetName=a/b/c/ HTTP/1.1​
Host: bucket-name.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string​
​
响应示例​
​
{​
"TotalStorageStat": {"Storage": "1024", "ObjectCount": 10},​
"StandardStorageStat": {"Storage": "512", "ObjectCount": 5},​
"IAStorageStat": {"Storage": "256", "ObjectCount": 3},​
"ArchiveFrStorageStat": {"Storage": "128", "ObjectCount": 1},​
"ArchiveStorageStat": {"Storage": "64", "ObjectCount": 1},​
"ColdArchiveStat": {"Storage": "32", "ObjectCount": 0},​
"DeepColdArchiveStorageStat": {"Storage": "0", "ObjectCount": 0},​
"IntelligentTieringStorageStats": {​
"HighFreqStorageStat": {"Storage": "0", "ObjectCount": 0},​
"LowFreqStorageStat": {"Storage": "0", "ObjectCount": 0},​
"ArchiveStorageStat": {"Storage": "0", "ObjectCount": 0}​
}​
}​
​
最近更新时间:2026.05.21 16:23:29
这个页面对您有帮助吗?
有用
有用
无用
无用