获取日志使用率

您可以使用“获取日志使用”请求方法来检索特定日志的数据使用情况。请注意,此API调用以字节为单位返回日志使用的值。

验证

在开始之前,请确保使用具有读/写权限的API密钥。

URL.

使用以下URL格式为API调用:

         
1
https://region.rest.logs.Insight.Rapid7.com/usage/Organizations/Logs/log_key& Freom=yyyy-mm-dd&to=yyyy-mm-dd.

使用log_key.作为要查询的日志的唯一标识符。

改变地区匹配您帐户的数据中心,例如我们欧洲联盟加利福尼亚州或者Au.

URL参数

改变匹配要使用的日期范围。日期值必须在ISO 8601表单中,例如以下内容:

  • 来自= yyyy-mm-dd
  • to = yyyy-mm-dd

如果要在过去10天内检索日志使用情况,您也可以将这些参数留空。您可以将数据检索到最后24小时。

成功响应

此API调用的成功响应代码是HTTP 200.成功响应的内容类似于以下内容:

         
1
{
2
“用法”: {
3.
“daily_usage”:[
4.
{
5.
“用法”:“290349”,
6.
“天”:“2018-12-16”
7.
},
8.
{
9.
“用法”:“285438”,
10.
“日”:“2018-12-17”
11.
},
12.
{
13.
“用法”:“279626”,
14.
“日”:“2018-12-18”
15.
}
16.
],
17.
“ID”:“”,
18.
“时期”: {
19.
“到”:“2018-12-18”,
20.
“来自”:“2018-12-16”
21.
}
22.
}
23.
}

样本呼叫

以下是获取日志使用的示例API调用:

         
1
导入请求
2
进口json.
3.
进口时间
4.
5.
6.
api_key ='read / write api键'
7.
log_key ='log键'
8.
9.
def handle_response(RESP):
10.
响应= resp.
11.
Time.Leep(1)
12.
如果response.status_code == 200:
13.
打印json.dumps(resp.json(),indent = 4)
14.
别的:
15.
打印response.status_code.
16.
17.
def make_request(提供_url = none):
18.
标题= {'X-API-key':API_KEY}
19.
URL =“https://us.rest.logs.insight.rapid7.com/usage/organizations/logs/”+ log_key +“?来自= 2018-12-10&to = 2018-12-12”
20.
req =请求。重点(URL,标题=标题)
21.
返回req.
22.
23.
24.
def get_usage():
25.
req = make_request()
26.
handle_response(req)
27.
28.
def start():
29.
get_usage()
30.
31.
32.
如果__name__ =='__main__':
33.
开始()