GetRequests
更新时间 2025-10-10 15:40:15
最近更新时间: 2025-10-10 15:40:15
本节主要介绍GetRequests。
此操作用来查询用户的请求次数。
请求参数
| 名称 | 描述 | 是否必须 |
|---|---|---|
| Action | GetRequests。 | 是 |
| BeginDate | 指定查询请求次数的起始时间，统计数据的起始时间（时区为：UTC+8）为开始日期的00:00。 类型：Time 取值：格式为yyyy-MM-dd。 | 是 |
| EndDate | EndDate 指定查询请求的结束时间，返回数据的时间为当天日期（时区为：UTC+8）的最后一个数据。 类型：Time 取值：格式为yyyy-MM-dd。EndDate不能早于BeginDate。 说明
| 是 |
| StorageClass | 指定查询的存储类型。 类型：Enum 取值:
默认值为STANDARD。 | 否 |
| Bucket | 指定查询请求次数的Bucket名称。如果不指定Bucket名称，则表示查询账户下所有的Bucket的请求次数之和。 类型：字符串 取值：3~63个字符，只能由小写字母、数字、短横线（-）和点（.）组成。 | 否 |
| Region | 指定查询请求次数的数据位置。如果不指定数据位置，则查询账户名下所有数据位置的请求次数之和。 类型：字符串 取值：
| 否 |
| InternetType | 指定返回的请求次数网络类型-互联网/非互联网。 类型：字符串 取值：
默认值为all。 | 否 |
| RequestsType | 指定返回的请求类型。 类型：字符串 取值：
默认值为all。 | 否 |
| Freq | 指定返回统计数据的采样粒度。 类型：Enum 取值：
默认值为byHour。 | 否 |
响应结果
| 名称 | 描述 |
|---|---|
| Account | 发出请求的账户名。 |
| UserName | 发出请求的用户名。如果根用户发送的该请求，则UserName为root。 |
| StorageClass | 存储类型：
|
| TimeZone | 返回数据的时区，统一为UTC +0800。 |
| InternetType | 返回的请求次数网络类型-互联网/非互联网：
|
| RequestsType | 请求类型：
|
| Freq | 返回数据的频率：
|
| BucketName | Bucket名字。如果用户在请求中没有携带Bucket参数，BucketName为空。 |
| RegionName | 数据位置，如果用户在请求中没有携带Region参数，RegionName为空。 |
| Statistics.Date | 返回结果对应的时间：
|
| Statistics.Requests | 请求次数。 |
| Statistics.Data.Internet.GetRequest | 标准存储数据的互联网的Get请求次数。 |
| Statistics.Data.Internet.HeadRequest | 标准存储数据的互联网的Head请求次数。 |
| Statistics.Data.Internet.PutRequest | 标准存储数据的互联网的Put请求次数。 |
| Statistics.Data.Internet.PostRequest | 标准存储数据的互联网的Post请求次数。 |
| Statistics.Data.Internet.DeleteRequest | 标准存储数据的互联网的Delete请求次数。 |
| Statistics.Data.Internet.OthersRequest | 标准存储数据的互联网的Others请求次数。 |
| Statistics.Data.NonInternet.GetRequest | 标准存储数据的非互联网的Get请求次数。 |
| Statistics.Data.NonInternet.HeadRequest | 标准存储数据的非互联网的Head请求次数。 |
| Statistics.Data.NonInternet.PutRequest | 标准存储数据的非互联网的Put请求次数。 |
| Statistics.Data.NonInternet.PostRequest | 标准存储数据的非互联网的Post请求次数。 |
| Statistics.Data.NonInternet.DeleteRequest | 标准存储数据的非互联网的Delete请求次数。 |
| Statistics.Data.NonInternet.OthersRequest | 标准存储数据的非互联网的Others请求次数。 |
| Statistics.Standard_ia.Internet.GetRequest | 低频访问存储数据的互联网的Get请求次数。 |
| Statistics.Standard_ia.Internet.HeadRequest | 低频访问存储数据的互联网的Head请求次数。 |
| Statistics.Standard_ia.Internet.PutRequest | 低频访问存储数据的互联网的Put请求次数。 |
| Statistics.Standard_ia.Internet.PostRequest | 低频访问存储数据的互联网的Post请求次数。 |
| Statistics.Standard_ia.Internet.DeleteRequest | 低频访问存储数据的互联网的Delete请求次数。 |
| Statistics.Standard_ia.Internet.OthersRequest | 低频访问存储数据的互联网的Others请求次数。 |
| Statistics.Standard_ia.NonInternet.GetRequest | 低频访问存储数据的非互联网的Get请求次数。 |
| Statistics.Standard_ia.NonInternet.HeadRequest | 低频访问存储数据的非互联网的Head请求次数。 |
| Statistics.Standard_ia.NonInternet.PutRequest | 低频访问存储数据的非互联网的Put请求次数。 |
| Statistics.Standard_ia.NonInternet.PostRequest | 低频访问存储数据的非互联网的Post请求次数。 |
| Statistics.Standard_ia.NonInternet.DeleteRequest | 低频访问存储数据的非互联网的Delete请求次数。 |
| Statistics.Standard_ia.NonInternet.OthersRequest | 低频访问存储数据的非互联网的Others请求次数。 |
请求示例
按天（byDay）查询Bucket为example-bucket、数据位置为ZhengZhou、2019-10-15至2019-10-16的所有标准存储数据请求次数。
GET /?Action=GetRequests&BeginDate=2019-10-15&EndDate=2019-10-16&Bucket=example-bucket&Freq=byDay&Region=ZhengZhou HTTP/1.1
Date: Wed, 16 Oct 2019 06:51:49 GMT
Authorization: SignatureValue
Host: oos-cn-mg.ctyunapi.cn响应示例
HTTP/1.1 200 OK
Date: Wed, 16 Oct 2019 06:51:50 GMT
x-amz-request-id: 60d2744539e84af5
Content-Length: 1244
Content-Type: application/xml; charset=utf-8
Server: CTYUN
<?xml version="1.0" encoding="UTF-8"?>
<GetRequestsResponse>
<Account>test@ctyun.cn</Account>
<UserName>user_test1</UserName>
<TimeZone>UTC +0800</TimeZone>
<InternetType>all</InternetType>
<RequestsType>all</RequestsType>
<Freq>byDay</Freq>
<BucketName>example-bucket</BucketName>
<RegionName>ZhengZhou</RegionName>
<Statistics>
<Date>2019-10-15</Date>
<Data>
<Internet>
<GetRequest>101</GetRequest>
<HeadRequest>102</HeadRequest>
<PutRequest>103</PutRequest>
<PostRequest>104</PostRequest>
<DeleteRequest>105</DeleteRequest>
<OthersRequest>106</OthersRequest>
</Internet>
<NonInternet>
<GetRequest>107</GetRequest>
<HeadRequest>108</HeadRequest>
<PutRequest>109</PutRequest>
<PostRequest>110</PostRequest>
<DeleteRequest>111</DeleteRequest>
<OthersRequest>112</OthersRequest>
</NonInternet>
</Data>
</Statistics>
<Statistics>
...
</Statistics>
</GetRequestsResponse>
