此操作用来查询用户的已用带宽。
请求参数
名称 描述 是否必须 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@ctyun.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>