此操作用来查询数据取回量。用户可以根据需求,查询指定存储桶、指定存储类型的数据取回量。
请求参数
名称 描述 是否必须 Action GetRestoreCapacity。 是 BeginDate 指定查询数据取回量的起始时间,统计数据的起始时间为开始日期(时区为:UTC+8)的00:00。
类型:Time
取值:格式为yyyy-MM-dd。
是 EndDate 指定查询数据取回量的结束时间,返回数据的时间为当天日期(时区为:UTC+8)的最后一个数据。
类型:Time
取值:格式为yyyy-MM-dd。EndDate不能早于BeginDate。
说明
Freq=by5min,EndDate与BeginDate的间隔小于1天。
Freq=byHour,EndDate与BeginDate的间隔小于7天。
Freq=byDay,EndDate与BeginDate的间隔小于30天。
是 StorageClass 指定查询的存储类型。
类型:Enum
取值:
ALL:所有存储类型。
STANDARAD_IA:低频访问类型。
默认值为ALL。
否 Bucket 指定查询数据取回量的Bucket名称。如果不指定Bucket名称,则表示查询账户下所有Bucket的数据取回量之和。
类型:字符串
取值:3~63个字符,只能由小写字母、数字、短横线(-)和点(.)组成。
否 Region 指定查询数据取回量的数据位置。如果不指定数据位置名称,则表示查询账户下所有数据位置的数据取回量之和。
类型:字符串
取值:
对象存储网络:ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、LaSa、WuHu、WuHan、ShenZhen、SH2、SuZhou。
对象存储网络2:NeiMeng1、HangZhou1。
香港节点:HongKong。
否 Freq 指定返回统计数据的采样粒度。
类型:Enum
取值:
by5min:统计数据的采样粒度为5分钟。
byHour:统计数据的采样粒度为1小时。
byDay:统计数据的采样粒度为1天。
默认值为byHour。
否
响应结果
名称 描述 Account 发出请求的账户名。 UserName 发出请求的用户名。如果根用户发送的该请求,则UserName为root。 StorageClass 存储类型:
ALL:所有存储类型。
STANDARAD_IA:低频访问类型。
TimeZone 返回数据的时区,统一为UTC +0800。 Freq 返回统计数据的采样粒度:
by5min:统计数据的采样粒度为5分钟。
byHour:统计数据的采样粒度为1小时。
byDay:统计数据的采样粒度为1天。
BucketName Bucket名字。如果用户在请求中没有携带Bucket参数,BucketName为空。 RegionName 数据位置,如果用户在请求中没有携带Region参数,RegionName为空。 Statistics.Date 返回结果对应的时间:
当请求参数Freq为by5min或byHour时,返回格式为yyyy-MM-dd HH:mm。
当请求参数Freq为byDay时,返回格式为yyyy-MM-dd。
Statistics.Standard_ia.RestoreCapacity 低频访问存储取回量,单位是Byte。
请求示例
按天(byDay)查询所有存储桶、所有地域2020-11-17所有存储类型的数据取回量。
GET/?Action= GetRestoreCapacity&BeginDate=2020-11-17&EndDate=2020-11-17&StorageClass=ALL&Freq=byDay HTTP/1.1
Date: Wed, 18 Nov 2020 07:38:27 GMT
Authorization: SignatureValue
Host: oos-cn-mg.ctyunapi.cn
响应示例
HTTP/1.1 200 OK
x-amz-request-id: 236A8905248E5A01
Date: Wed, 18 Nov 2020 07:39:02 GMT
Content-Length:120
Server: CTYUN
<GetRestoreCapacityResponse>
<Account>example@oos.cn</Account>
<UserName>user1</UserName>
<StorageClass>ALL</StorageClass>
<TimeZone>utc+8:00</TimeZone>
<Freq>byDay</Freq>
<BucketName></BucketName>
<RegionName></RegionName>
<Statistics>
<Date>2020-11-17</Date>
<Standard_ia>
<RestoreCapacity>731920486</RestoreCapacity>
</Standard_ia>
</Statistics>
</GetRestoreCapacityResponse>