GetUsage
更新時間 2024-11-18 09:44:01
最近更新時間: 2024-11-18 09:44:01
分享文章
本節主要介紹GetUsage。
此操作用來查詢用戶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@daliqc.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>
