此操作用來查詢用戶的已用帶寬。

請求參數

名稱
描述
是否必須
Action
GetBandwidth。
是
BeginDate
指定查詢已用帶寬的起始時間（時區為：UTC+8）。
類型：Time
取值：格式為yyyy-MM-dd-HH-mm，mm只能取00、05、10.......55。日期早于當前時間不能超過一個月。
是
EndDate
指定查詢已用帶寬的結束時間（時區為：UTC+8），返回數據時間間隔為5分鐘。
類型：Time
取值：格式為yyyy-MM-dd-HH-mm，mm只能取00、05、10.......55。EndDate既不能早于BeginDate，也不能晚于當前時間。
是
BucketName
指定查詢已用帶寬的Bucket名稱，如果不指定Bucket名稱，則表示查詢賬戶下所有的Bucket的統計信息。
類型：字符串
取值：3~63個字符，只能由小寫字母、數字、短橫線（-）和點（.）組成。
否
NetType
指定返回的網絡類型-精品網（CN2）/普通網（163）。
注意
僅香港節點支持本參數。
類型：字符串
取值：
all：指定返回精品網和普通網的帶寬。
highqualitynet：指定返回精品網的帶寬。
normalqualitynet：指定返回普通網的帶寬。
默認值為all。
否

響應結果

名稱
描述
UserName
發出請求的賬戶名。
BucketName
Bucket名稱。
NetType
網絡類型-精品網（CN2）/普通網（163）：
all：精品網和普通網。
highqualitynet：精品網。
normalqualitynet：普通網。
注意
僅香港節點會返回此項。
Region.Name
數據位置。
Region.Data.Date
統計數據時間。
Region.Data.UploadBW
互聯網直接上行已用帶寬，單位是Byte/s。
Region.Data.DownloadBW
互聯網直接下行已用帶寬，單位是Byte/s。
Region.Data.RoamUploadBW
互聯網漫游上行已用帶寬，單位是Byte/s。
Region.Data.RoamDownloadBW
互聯網漫游下行已用帶寬，單位是Byte/s。
Region.Data.NonInternetUploadBW
非互聯網直接上行已用帶寬，單位是Byte/s。
Region.Data.NonInternetDownloadBW
非互聯網直接下行已用帶寬，單位是Byte/s。
Region.Data.NonInternetRoamUploadBW
非互聯網漫游上行已用帶寬，單位是Byte/s。
Region.Data.NonInternetRoamDownloadBW
非互聯網漫游下行已用帶寬，單位是Byte/s。

請求示例

查詢2018年12月26日16點45分到2018年12月26日16點50分example-bucket的已用帶寬。

GET?/?Action=GetBandwidth&BucketName=example-bucket&EndDate=2018-12-26-16-50&BeginDate=2018-12-26-16-45?HTTP/1.1
Host:?oos-cn-mg.ctyunapi.cn
x-amz-content-sha256:?e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Authorization: SignatureValue
Content-Type:?application/xml;?charset=utf-8

響應示例

HTTP/1.1?200?OK
Date:?Wed,?26?Dec?2018?09:01:30?GMT
x-amz-request-id:?cabf8789cbe74b2e
Content-Length:?1694
Content-Type:?application/xml;?charset=utf-8
Server:?CTYUN
?
<?xml?version="1.0"?encoding="UTF-8"?>
<GetBandwidthResult>
??<UserName>ctyuntest@daliqc.cn</UserName>
??<BucketName>example-bucket</BucketName>
??<Region>
????<Name>ShenZhen</Name>
????<Data>
??????<Date>2018-12-26?16:45</Date>
??????<UploadBW>1000</UploadBW>
??????<DownloadBW>2000</DownloadBW>
??????<RoamUploadBW>0</RoamUploadBW>
??????<RoamDownloadBW>0</RoamDownloadBW>
??????<NonInternetUploadBW>3000</NonInternetUploadBW>
??????<NonInternetDownloadBW>4000</NonInternetDownloadBW>
??????<NonInternetRoamUploadBW>0</NonInternetRoamUploadBW>
??????<NonInternetRoamDownloadBW>0</NonInternetRoamDownloadBW>
????</Data>
????<Data>
??????<Date>2018-12-26?16:50</Date>
??????<UploadBW>5000</UploadBW>
??????<DownloadBW>6000</DownloadBW>
??????<RoamUploadBW>0</RoamUploadBW>
??????<RoamDownloadBW>0</RoamDownloadBW>
??????<NonInternetUploadBW>7000</NonInternetUploadBW>
??????<NonInternetDownloadBW>8000</NonInternetDownloadBW>
??????<NonInternetRoamUploadBW>0</NonInternetRoamUploadBW>
??????<NonInternetRoamDownloadBW>0</NonInternetRoamDownloadBW>
????</Data>
??</Region>
??<Region>
????<Name>QingDao</Name>
????<Data><Date>2018-12-26?16:45</Date>
????<UploadBW>1000</UploadBW>
????<DownloadBW>2000</DownloadBW>
????<RoamUploadBW>0</RoamUploadBW>
????<RoamDownloadBW>0</RoamDownloadBW>
????<NonInternetUploadBW>3000</NonInternetUploadBW>
????<NonInternetDownloadBW>4000</NonInternetDownloadBW>
????<NonInternetRoamUploadBW>0</NonInternetRoamUploadBW>
????<NonInternetRoamDownloadBW>0</NonInternetRoamDownloadBW>
????</Data>
????<Data>
??????<Date>2018-12-26?16:50</Date>
??????<UploadBW>5000</UploadBW>
??????<DownloadBW>6000</DownloadBW>
??????<RoamUploadBW>0</RoamUploadBW>
??????<RoamDownloadBW>0</RoamDownloadBW>
??????<NonInternetUploadBW>7000</NonInternetUploadBW>
??????<NonInternetDownloadBW>8000</NonInternetDownloadBW>
??????<NonInternetRoamUploadBW>0</NonInternetRoamUploadBW>
??????<NonInternetRoamDownloadBW>0</NonInternetRoamDownloadBW>
????</Data>
??</Region>
</GetBandwidthResult>