文档简介：
GetUsage
此操作用来查询用户Bucket的使用情况。
说明：不建议使用此API，建议根据要查询的项，使用下列API：GetCapacity、GetDeleteCapcity、GetRequests、GetReturnCode、GetConcurrentConnection。
l 请求参数
|
名称 |
描述 |
是否必填 |
|
Action |
GetUsage |
是 |
|
BeginDate |
指定查询的起始时间，统计数据的起始时间为开始日期（时区为：UTC+8）的00:00。 类型：Time。 取值： l 若以格式YYYY-MM-DD查询，返回以天为单位的数据； l 若以格式YYYY-MM-DD-hh-mm查询，返回以5分钟为单位的数据，mm只能取00、05、10.......55。 l 日期不能早于当前时间一个月。 |
是 |
|
EndDate |
指定查询的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：EndDate既不能早于BeginDate，也不能晚于当前时间。 l 若以格式YYYY-MM-DD查询，返回以天为单位的数据； l 若以格式YYYY-MM-DD-hh-mm查询，返回以5分钟为单位的数据，mm只能取00、05、10.......55。 |
是 |
|
Bucket |
指定查询使用情况的Bucket的名称，如果不指定Bucket名称，则表示查询账户下所有的Bucket的统计信息之和。 类型：字符串。 取值：3~63位字符串，只能由小写字母、数字、短横线（-）和点（.）组成。 |
否 |
l 响应结果
|
名称 |
描述 |
|
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外的其他请求次数。 |
l 请求示例
查询Bucket名为my-bucket-test，2018-12-24的流量。
|
GET /?Action=GetUsage&BucketName=my-bucket-test&Freq=byDay&EndDate=2018-12-24&BeginDate=2018-12-24 HTTP/1.1 Host: oos-cn-mg.ctyunapi.cn Authorization: AWS fad0e782cd5132563e38:xQE0diMbLRepdf3YB+FIEXAMPLE= Date: Wed, 26 Dec 2018 09:01:30 GMT Content-Type: application/xml; charset=utf-8 |
l 返回示例
|
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 Connection: close Server: CTYUN
<GetUsageResponse> <UserName>test@oos.cn</UserName> <BucketName>my-bucket-test</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> |
