上云无忧 > 文档中心 > 天翼云对象存储(OOS经典版)I型统计API GetRestoreCapacity
对象存储
天翼云对象存储(OOS经典版)I型统计API GetRestoreCapacity

文档简介:
此操作用来查询数据取回量。用户可以根据需求,查询指定存储桶、指定存储类型的数据取回量。 l 请求参数 名称 描述 是否必填 Action GetRestoreCapacity。 是 BeginDate 指定查询数据取回量的起始时间,统计数据的起始时间为开始日期(时区为:UTC+8)的00:00。 类型:Time。 取值:格式为yyyy-MM-dd。 是
*产品来源:中国电信天翼云。免费试用 咨询热线:400-826-7010,为您提供专业的售前咨询,让您快速了解云产品,助您轻松上云! 微信咨询
  免费试用、价格特惠

GetRestoreCapacity


此操作用来查询数据取回量。用户可以根据需求,查询指定存储桶、指定存储类型的数据取回量。

l  请求参数

名称

描述

是否必填

Action

GetRestoreCapacity。

是

BeginDate

指定查询数据取回量的起始时间,统计数据的起始时间为开始日期(时区为:UTC+8)的00:00。

类型:Time。

取值:格式为yyyy-MM-dd。

是

EndDate

指定查询数据取回量的结束时间,返回数据的时间为当天日期(时区为:UTC+8)的最后一个数据。

类型:Time。

取值:格式为yyyy-MM-dd。EndDate不能早于BeginDate。

说明:

l  Freq=by5min,EndDate与BeginDate的间隔不大于1天;

l  Freq=byHour,EndDate与BeginDate的间隔不大于7天;

l  Freq=byDay,EndDate与BeginDate的间隔不大于30天。

是

StorageClass

指定查询的存储类型。

类型:Enum

取值:

l  ALL:所有存储类型;

l  STANDARAD_IA:低频访问类型。

默认值为ALL。

否

Bucket

指定查询数据取回量的Bucket名称。如果不指定Bucket名称,则表示查询账户下所有Bucket的数据取回量之和。

类型:字符串。

取值:3~63位字符串,只能由小写字母、数字、短横线(-)和点(.)组成。

否

Region

指定查询数据取回量的数据位置。如果不指定数据位置名称,则表示查询账户下所有数据位置的数据取回量之和。

类型:字符串。

取值:ZhengZhou、ShenYang、ChengDu、WuLuMuQi、LanZhou、QingDao、GuiYang、LaSa、WuHu、WuHan、ShenZhen、SH2、SuZhou。

否

Freq

指定返回统计数据的采样粒度。

类型:Enum。

取值:

l  by5min:统计数据的采样粒度为5分钟;

l  byHour:统计数据的采样粒度为1小时;

l  byDay:统计数据的采样粒度为1天。

默认值为byHour。

否

l  响应结果

名称

描述

GetRestoreCapacityResponse.Account

发出请求的账户名。

GetRestoreCapacityResponse.UserName

发出请求的用户名。如果根用户发送的该请求,则UserName为root。

GetRestoreCapacityResponse.StorageClass

存储类型:

l  ALL:所有存储类型;

l  STANDARAD_IA:低频访问类型。

GetRestoreCapacityResponse.TimeZone

返回数据的时区,统一为UTC   +0800。

GetRestoreCapacityResponse.Freq

返回统计数据的采样粒度:

l  by5min:统计数据的采样粒度为5分钟;

l  byHour:统计数据的采样粒度为1小时;

l  byDay:统计数据的采样粒度为1天。

GetRestoreCapacityResponse.BucketName

Bucket名字。如果用户在请求中没有携带Bucket参数,BucketName为空。

GetRestoreCapacityResponse.RegionName

数据位置,如果用户在请求中没有携带Region参数,RegionName为空。

GetRestoreCapacityResponse.Statistics.Date

返回结果对应的时间:

l  当请求参数Freq为by5min或byHour时,返回格式为yyyy-MM-dd HH:mm;

l  当请求参数Freq为byDay时,返回格式为yyyy-MM-dd。

GetRestoreCapacityResponse.Statistics.Standard_ia.RestoreCapacity

低频访问存储取回量,单位是Byte。

 

l  请求示例

按天(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: AWS   7799e793ce4624ee7e5a:e09bM67kLPEKaSCmZ4JERNCTmgQ=

Host: oos-cn-mg.ctyunapi.cn

 

l  返回示例

HTTP/1.1 200 OK

x-amz-request-id:   236A8905248E5A01

Date: Wed, 18Nov 2020 07:39:02 GMT

Content-Length:120

Connection: close

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>


相似文档
  • 此操作用来查询用户删除的容量。 l 请求参数 名称 描述 是否必填 Action GetDeleteCapacity。 是 BeginDate 指定查询容量的起始时间,统计数据的起始时间为开始日期(时区为:UTC+8)的00:00。 类型:Time。 取值:格式为yyyy-MM-dd。 是
  • 此操作用来查询用户的流量。 l 请求参数 名称 描述 是否必填 Action GetTraffics。 是 BeginDate 指定查询流量的起始时间,统计数据的起始时间为开始日期(时区为:UTC+8)的00:00。 类型:Time。 取值:格式为yyyy-MM-dd。 是
  • 此操作用来查询用户的请求次数。 l 请求参数 名称 描述 是否必填 Action GetRequests。 是 BeginDate 指定查询请求次数的起始时间,统计数据的起始时间(时区为:UTC+8)为开始日期的00:00。 类型:Time。 取值:格式为yyyy-MM-dd。 是
  • 此操作用来查询用户请求返回码次数。 l 请求参数 名称 描述 是否必填 Action GetReturnCode。 是 BeginDate 指定查询返回码次数的起始时间,统计数据的起始时间为开始日期(时区为:UTC+8)的00:00。 类型:Time。 取值:格式为yyyy-MM-dd。 是
  • 此操作用来查询用户的并发连接数。 l 请求参数 名称 描述 是否必填 Action GetConcurrentConnection。 是 BeginDate 指定查询并发连接数的起始时间,统计数据的起始时间为开始日期(时区为:UTC+8)的00:00。 类型:Time。 取值:格式为yyyy-MM-dd。 是
官方微信
联系客服
400-826-7010
7x24小时客服热线
分享
  • QQ好友
  • QQ空间
  • 微信
  • 微博
返回顶部