文档简介：
GetBandwidth
此操作用来查询用户的已用带宽。
说明：不建议使用此API，建议根据要查询的项，使用下列API：GetCapacity、GetDeleteCapcity、GetRequests、GetReturnCode、GetConcurrentConnection。
l 请求参数
|
名称 |
描述 |
是否必填 |
|
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位字符串，只能由小写字母、数字、短横线（-）和点（.）组成。 |
否 |
l 响应结果
|
名称 |
描述 |
|
UserName |
发出请求的账户名。 |
|
BucketName |
Bucket名称。 |
|
Region.Name |
数据位置。 |
|
Region.Date.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。 |
l 请求示例
查询2018年12月26日16点45分到2018年12月26日16点50分my-bucket-test的已用带宽。
|
GET /?Action=GetBandwidth&BucketName=my-bucket-test&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: AWS4-HMAC-SHA256 Credential=fe49633483061d5b93e3/20181226/cn-mg/s3/aws4_request, SignedHeaders=content-type;host;x-amz-content-sha256;x-amz-date, Signature=40051b7b2fce14cd6025c8935019166814883696d017040cfd9334836fd40533 x-amz-date: 20181226T090108Z Content-Type: application/xml; charset=utf-8 |
l 返回示例
|
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 Connection: close Server: CTYUN
<?xml version="1.0" encoding="UTF-8"?> <GetBandwidthResult> <UserName>ctyuntest@oos.cn</UserName> <BucketName>my-bucket-test</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> |
