此操作用来查询用户Bucket的使用情况。
说明不建议使用此API,建议根据要查询的项,使用下列API:GetCapacity、GetDeleteCapcity、GetRequests、GetReturnCode、GetConcurrentConnection。
请求参数
名称 描述 是否必须 Action GetUsage。 是 BeginDate 指定查询的起始时间,统计数据的起始时间为开始日期(时区为:UTC+8)的00:00。
类型:Time
取值:
若以格式YYYY-MM-DD查询,返回以天为单位的数据。
若以格式YYYY-MM-DD-hh-mm查询,返回以5分钟为单位的数据,mm只能取00、05、10.......55。
注意若以格式YYYY-MM-DD-hh-mm查询,日期不能早于当前时间一个月。
是 EndDate 指定查询的结束时间,返回数据的时间为当天日期(时区为:UTC+8)的最后一个数据。
类型:Time
取值:EndDate既不能早于BeginDate,也不能晚于当前时间。
若以格式YYYY-MM-DD查询,返回以天为单位的数据。
若以格式YYYY-MM-DD-hh-mm查询,返回以5分钟为单位的数据,mm只能取00、05、10.......55。
是 Bucket 指定查询使用情况的Bucket的名称,如果不指定Bucket名称,则表示查询账户下所有的Bucket的统计信息之和。
类型:字符串
取值:3~63个字符,只能由小写字母、数字、短横线(-)和点(.)组成。
否
响应结果
名称 | 描述 |
---|---|
UserName | 发出请求的账户名。 |
BucketName | Bucket名字。 |
Region.Name | 数据位置。 |
Region.Data.Date | 统计的日期。 |
Region.Data.Capacity | 已使用的容量,单位为Byte。 |
Region.Data.Upload | 互联网直接上行流量,单位为Byte。 |
Region.Data.Download | 互联网直接下行流量,单位为Byte。 |
Region.Data.DeleteFlow | 互联网删除流量,单位为Byte。 |
Region.Data.RoamUpload | 互联网漫游上行流量,单位为Byte。 |
Region.Data.RoamDownload | 互联网漫游下行流量,单位为Byte。 |
Region.Data.GetRequest | 互联网Get请求次数。 |
Region.Data.HeadRequest | 互联网Head请求次数。 |
Region.Data.PutRequest | 互联网Put请求次数。 |
Region.Data.PostRequest | 互联网Post请求次数。 |
Region.Data.DeleteRequest | 互联网Delete请求次数。 |
Region.Data.OtherRequest | 互联网除Get、Head、Put、Post、Delete外的其他请求次数。 |
Region.Data.NonInternetUpload | 非互联网直接上行流量,单位为Byte。 |
Region.Data.NonInternetDownload | 非互联网直接下行流量,单位为Byte。 |
Region.Data.NonInternetDeleteFlow | 非互联网删除流量,单位为Byte。 |
Region.Data.NonInternetRoamUpload | 非互联网漫游上行流量,单位为Byte。 |
Region.Data.NonInternetRoamDownload | 非互联网漫游下行流量,单位为Byte。 |
Region.Data.NonInternetGeRequest | 非互联网Get请求次数。 |
Region.Data.NonInternetHeadRequest | 非互联网Head请求次数。 |
Region.Data.NonInternetPutRequest | 非互联网Put请求次数。 |
Region.Data.NonInternetPostRequest | 非互联网Post请求次数。 |
Region.Data.NonInternetDeleteRequest | 非互联网Delete请求次数。 |
Region.Data.NonInternetOtherRequest | 非互联网除Get、Head、Put、Post、Delete外的其他请求次数。 |
请求示例
查询Bucket名为example-bucket,2018-12-24的流量。
GET /?Action=GetUsage&BucketName=example-bucket&EndDate=2018-12-24&BeginDate=2018-12-24 HTTP/1.1
Host: oos-cn-mg.ctyunapi.cn
Authorization: SignatureValue
Date: Wed, 26 Dec 2018 09:01:30 GMT
Content-Type: application/xml; charset=utf-8
响应示例
HTTP/1.1 200 OK
x-amz-request-id: 236A8905248E5A01
Date: Wed, 26 Dec 2018 09:01:30 GMT
Content-Length:1200
Content-Type: application/xml; charset=utf-8
Server: CTYUN
<GetUsageResponse>
<UserName>test@ctyun.cn</UserName>
<BucketName>example-bucket</BucketName>
<Region>
<Name>ZhengZhou</Name>
<Data>
<Date>2018-12-24</Date>
<Capacity>3048576</Capacity>
<Upload>40000</Upload>
<Download>60000</Download>
<DeleteFlow>0</DeleteFlow>
<RoamUpload>20</RoamUpload>
<RoamDownload>30</RoamDownload>
<GetRequest>60</GetRequest>
<HeadRequest>60</HeadRequest>
<PutRequest>60</PutRequest>
<PostRequest>60</PostRequest>
<DeleteRequest>60</DeleteRequest>
<OtherRequest>80</OtherRequest>
<NonInternetUpload>0</NonInternetUpload>
<NonInternetDownload>0</NonInternetDownload>
<NonInternetDeleteFlow>0</NonInternetDeleteFlow>
<NonInternetRoamUpload>0</NonInternetRoamUpload>
<NonInternetRoamDownload>0</NonInternetRoamDownload>
<NonInternetGeRequest>0</NonInternetGetRequest>
<NonInternetHeadRequest>0</NonInternetHeadRequest>
<NonInternetPutRequest>0</NonInternetPutRequest>
<NonInternetPostRequest>0</NonInternetPostRequest>
<NonInternetDeleteRequest>0</NonInternetDeleteRequest>
<NonInternetOtherRequest>0</NonInternetOtherRequest>
</Data>
</Region>
<Region>
<Name>global</Name>
<Data>
...
</Data>
</Region>
</GetUsageResponse>