Statistics

更新时间:2022-05-24 18:28:16

功能描述
1)获取分钟级时间间隔内请求成功的put/post请求数;
2)获取分钟级时间间隔内成功上传的带宽。
3)获取每小时的存储量和对象数
4)请求参数通过URL传递。

请求语法

GET /bucketname?statistics&type=requests&method=PUT&startTime=201707200244 HTTP/1.1
Host: Bucket.Endpoint
Date: Date
Authorization: Authorization

请求参数

该接口请求消息参数如下:

参数名

描述

是否必填

type

定义查询的统计数据项

可选值:requests(请求数),bandwidth(带宽),ObjectNum(对象数)

startTime

定义查询的开始时间,精确到分钟。

如果endTime没有定义,则响应的是starttime当前这个周期的,否则响应的是startTimeendTime这段时间的统计数据,时间间隔不能超过一周

类型:YYYYMMDDhhmmss

endTime

定义查询的结束时间。如果没有定义,则响应starttime当前这个周期的.

类型:YYYYMMDDhhmmss

method

定义监控数据的请求方法,查询对象数时,该参数不生效。

可选值:PUT/POST

请求头部

使用公共请求头部

请求主体

此接口请求消息中不使用请求消息元素。

响应语法

HTTP/1 status_code
x-amz-request-id: request id
Date: date
Content-Type: type
Content-Length: length

<?xml version=”0” encoding=”UTF-8” standalone=”yes”?>
<StatisticsResult xmlns=” http://wcs.chinanetcenter.com/document”>
	<Owner>Owner<Owner>
	<Bucket>Bucket</Bucket>
		<Type>Type</Type>
		<Operation >Operation </Operation >
		<StartTime>StartTime</StartTime>
		<EndTime>EndTime</EndTime>
		<Results time="2017-07-23 02:44">2472</Results>
		<Results time="2017-07-23 02:45">2546</Results>
……
</StatisticsResult>

响应头部

使用公共响应头部

响应主体

此请求的响应通过消息元素返回结果,元素的具体意义如下表所示。

字段名称

描述

StatisticsResult

查询接口响应信息根节点

子节点:Owner,Bucket,Type,StartTime,EndTime,Results

类型:XML

父节点:空

Owner

空间所有者

子节点:空

父节点:StatisticsResult

类型:字符串

Bucket

空间名

子节点:空

父节点:StatisticsResult

类型:字符串

Type

查询数据类型

子节点:空

父节点:StatisticsResult

类型:字符串(requests/bandwidth/ObjectNum

Operation

查询数据操作类型

子节点:空

父节点:StatisticsResult

类型:字符串(PUT/POST查询对象数时,该字段为空

StartTime

查询监控数据开始时间

子节点:空

父节点:StatisticsResult

类型:字符串(格式是YYYYMMDDhhmm(年月日时分)

EndTime

查询监控数据结束时间

子节点:空

父节点:StatisticsResult

类型:字符串(格式是YYYYMMDDhhmm(年月日时分)

Results

查询监控数据结果

子节点:空

父节点:StatisticsResult

类型:字符串

特殊响应码

场景

http status code

Error code

message

请求时缺少必填参数

400 Bad Request

InvalidArgument

Please provide parameter {parameter name}

 

请求时子资源拼写错误或者没带

405 Method Not Allowed

MethodNotAllowed

MethodNotAllowed

请求中的Method不属于这些方法中的一种GET,HEAD,POST,PATCH,DELETE,OPTIONS,TRACE        

400 Bad Request

InvalidArgument

Method is invalid

请求时startTime/endTime参数格式非法

400 Bad Request

InvalidArgument

{parameter name} is Invalid

请求中开始时间比当前时间晚

400 Bad Request

InvalidArgument

{parameter name} is invalid

请求中的

开始时间比结束时间晚       

400 Bad Request

InvalidArgument

The startTIme must be less than endTime

请求中结束时间比当前时间晚

400 Bad Request

InvalidArgument

{parameter name} is invalid

URL过期

403 Forbidden

 

RequestTimeTooSkewed

The difference between the request time and the current time is too large.

请求查询的实际间隔大于一周

400 Bad Request

InvalidArgument

The difference between the startTime and endTime must be less than one week.

请求中type定义不在支持范围(无论单词拼写错误还是带了不支持的查询类型)

400 Bad Request

InvalidArgument

Parameter Type only support requests and bandwidth

同样的请求在一分钟内请求次数大于2

429 Too Many Requests

 

TooManyRequests

You has sent too many requests in a given amount of time.

本篇文档内容对您是否有帮助?
有帮助
没帮助
提交成功!非常感谢您的反馈,我们会继续努力做到更好!