调用DescribeDomainCcActivityLog查询频次控制规则拦截日志。
- 不指定StartTime和EndTime时,该接口默认读取过去24小时的数据,同时支持按指定的起止时间查询,两者需要同时指定。
- 支持批量查询域名,多个域名用半角逗号(,)分隔,一次最多支持20个域名查询。
- 最多可获取30天的数据。
- 单用户调用频率:50次/秒。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDomainCcActivityLog |
系统规定参数。取值:DescribeDomainCcActivityLog。 |
DomainName | String | 否 | example.com |
需要查询的加速域名。支持批量域名查询,多个域名用英文逗号(,)分隔。 若参数为空,默认返回所有加速域名合并后的数据。 |
StartTime | String | 否 | 2018-12-10T20:00:00Z |
获取数据起始时间。日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 最小数据粒度为5分钟。 若该参数为空,默认读取过去24小时数据。 |
EndTime | String | 否 | 2018-12-10T21:00:00Z |
获取数据结束时间。日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 结束时间需大于起始时间。 |
TriggerObject | String | 否 | IP |
触发对象。 若该参数为空,则查询所有拦截事件。 |
Value | String | 否 | 1.2.3.4 |
触发对象值 若该参数为空,则查询所有拦截事件。 |
RuleName | String | 否 | test2 |
自定义规则名。取值:
若该参数为空,则查询所有拦截事件。 |
PageSize | Long | 否 | 30 |
单页显示数量。默认值:30。 |
PageNumber | Long | 否 | 1 |
页码。默认值:1 。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
PageIndex | Long | 1 |
返回数据的页码。 |
RequestId | String | 3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F |
请求ID。 |
PageSize | Long | 30 |
单页显示数量。 |
Total | Long | 20 |
总条数。 |
ActivityLog | Array of LogInfo |
拦截事件数据。 |
|
Value | String | 1.2.3.4 |
触发对象值。 |
Ttl | Long | 300 |
生效时长,单位:秒。 |
Action | String | deny |
拦截动作。 |
TriggerObject | String | Ip |
触发对象。 |
TimeStamp | String | 2015-12-10T20:00:00Z |
时间片起始时刻。 |
DomainName | String | example.com |
加速域名。 |
RuleName | String | test |
拦截自定义规则名称。 |
示例
请求示例
http://cdn.aliyuncs.com?Action=DescribeDomainCcActivityLogData&DomainName=example.com
&StartTime=2015-12-10T20:00:00Z
&EndTime=2015-12-10T21:05:00Z
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeDomainCcActivityLogResponse>
<Total>20</Total>
<PageSize>30</PageSize>
<PageIndex>1</PageIndex>
<RequestId>3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F</RequestId>
<ActivityLog>
<TimeStamp>2015-12-10T20:00:00Z</TimeStamp>
<Value>1.2.3.4</Value>
<TriggerObject>Ip</TriggerObject>
<DomainName>example.com</DomainName>
<Ttl>300</Ttl>
<Action>deny</Action>
<RuleName>test2</RuleName>
</ActivityLog>
<ActivityLog>
<TimeStamp>2015-12-10T20:00:00Z</TimeStamp>
<Value>safari 5.1 – Windows</Value>
<TriggerObject>Header_UserAgent</TriggerObject>
<DomainName>example.com</DomainName>
<Ttl>300</Ttl>
<Action>deny</Action>
<RuleName>test2</RuleName>
</ActivityLog>
</DescribeDomainCcActivityLogResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Total" : 20,
"PageSize" : 30,
"PageIndex" : 1,
"RequestId" : "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
"ActivityLog" : [ {
"TimeStamp" : "2015-12-10T20:00:00Z",
"Value" : "1.2.3.4",
"TriggerObject" : "Ip",
"DomainName" : "example.com",
"Ttl" : 300,
"Action" : "deny",
"RuleName" : "test2"
}, {
"TimeStamp" : "2015-12-10T20:00:00Z",
"Value" : "safari 5.1 – Windows",
"TriggerObject" : "Header_UserAgent",
"DomainName" : "example.com",
"Ttl" : 300,
"Action" : "deny",
"RuleName" : "test2"
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | 起始时间格式错误。日期格式请参考所调用API的帮助文档说明。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 结束时间格式错误。日期格式请参考所调用API的帮助文档说明。 |
400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 开始时间设置错误,请检查更新后重试。 |
访问错误中心查看更多错误码。