获取日志使用

您可以使用“GET Logs Usage”请求方法检索指定时间段内所有日志的数据使用情况。结果将按接收数据的升序排序。注意,这个API调用返回所有日志使用值(以字节为单位)。

身份验证

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

URL

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

         
1
https://REGION.rest.logs.insight.rapid7.com/usage/organizations/logs?time_range=Last7Days&interval=day

改变地区为您的帐户匹配数据中心,例如我们欧盟ca非盟

URL参数

改变以匹配要使用的日期范围。日期值必须采用ISO 8601格式,例如:

  • 从= YYYY-MM-DD
  • = YYYY-MM-DD

聚合的使用数据在过去7天内可用。或者,您可以使用time_range = Last7Days.此时,只有一天可作为支持的间隔使用。

但是,如果日志没有接收到数据,那么它将不会出现在当天的结果中。

成功响应

这个API调用的成功响应代码是HTTP 200。成功回应的内容如下所示:

         
1
2
" per_day_usage ": {
3.
“使用”:(
4
5
“间隔”:“2018-12-16”,
6
“log_usage”:(
7
8
“使用”:8267539,
9
“id”:“b2f37a6f——“
10
},
11
12
“使用”:9289532,
13
“id”:“cec3450b——“
14
},
15
16
“使用”:12627779,
17
“id”:“adc221c6——“
18
19
...
20.
21
},
22
23
“间隔”:“2018-12-17”,
24
“log_usage”:(
25
26
“使用”:7648949,
27
“id”:“50499 f85——“
28
},
29
30.
“使用”:7764258,
31
“id”:“b2f37a6f——“
32
33
...
34
35
},
36
37
“间隔”:“2018-12-18”,
38
“log_usage”:(
39
40
“使用”:8388395,
41
“id”:“50499 f85——“
42
},
43
44
“使用”:8596388,
45
“id”:“cec3450b——“
46
},
47
48
“使用”:12257438,
49
“id”:“adc221c6——“
50
51
...
52
53
54
],
55
“期”:{
56
“”:“2018-12-18”,
57
“从”:“2018-12-16”
58
},
59
“usage_units”:“字节”,
60
“report_interval”:“一天”
61
62

示例调用

下面是GET日志用法的API调用示例:

         
1
进口的要求
2
进口json
3.
导入的时间
4
5
6
API_KEY = '读写API键'
7
8
def handle_response(职责):
9
响应=职责
10
time . sleep (1)
11
如果响应。status_code = = 200:
12
打印json.dumps (resp.json(),缩进= 4)
13
其他:
14
打印response.status_code
15
16
def make_request (provided_url = None):
17
headers = {'x-api-key': API_KEY}
18
url = " https://us.rest.logs.insight.rapid7.com/usage/organizations/logs?time_range=Last3Days&interval=day "
19
要求=请求。get (url,标题=标题)
20.
返回请求
21
22
23
def get_usage ():
24
要求= make_request ()
25
handle_response(要求)
26
27
def开始():
28
get_usage ()
29
30.
31
如果__name__ == '__main__':
32
start ()