GetRestoreCapacity
更新时间 2025-10-10 15:40:15
最近更新时间: 2025-10-10 15:40:15
本节主要介绍GetRestoreCapacity。
此操作用来查询数据取回量。用户可以根据需求，查询指定存储桶、指定存储类型的数据取回量。
请求参数
| 名称 | 描述 | 是否必须 |
|---|---|---|
| Action | GetRestoreCapacity。 | 是 |
| BeginDate | 指定查询数据取回量的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time 取值：格式为yyyy-MM-dd。 | 是 |
| EndDate | 指定查询数据取回量的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyy-MM-dd。EndDate不能早于BeginDate。 说明
| 是 |
| StorageClass | 指定查询的存储类型。 类型：Enum 取值：
默认值为ALL。 | 否 |
| Bucket | 指定查询数据取回量的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有Bucket的数据取回量之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（-）和点（.）组成。 | 否 |
| Region | 指定查询数据取回量的数据位置。如果不指定数据位置名称，则表示查询账户下所有数据位置的数据取回量之和。 类型：字符串 取值：
| 否 |
| Freq | 指定返回统计数据的采样粒度。 类型：Enum 取值：
默认值为byHour。 | 否 |
响应结果
| 名称 | 描述 |
|---|---|
| Account | 发出请求的账户名。 |
| UserName | 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 |
| StorageClass | 存储类型：
|
| TimeZone | 返回数据的时区，统一为UTC +0800。 |
| Freq | 返回统计数据的采样粒度：
|
| BucketName | Bucket名字。如果用户在请求中没有携带Bucket参数，BucketName为空。 |
| RegionName | 数据位置，如果用户在请求中没有携带Region参数，RegionName为空。 |
| Statistics.Date | 返回结果对应的时间：
|
| 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, 18Nov 2020 07:39:02 GMT
Content-Length:120
Server: CTYUN
<GetRestoreCapacityResponse>
<Account>example@ctyun.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>
