获取日志使用情况
您可以使用“GET Logs Usage”请求方法检索指定时间范围内所有日志的数据使用情况。结果将按接收到的数据的升序排序。请注意,此API调用以字节为单位返回所有日志使用情况的值。
身份验证
在开始之前,请确保您有一个具有读/写权限的API密钥。
统一资源定位地址
为你的API调用使用以下URL格式:
1.
https://REGION.rest.logs.insight.rapid7.com/usage/organizations/logs?time_range=Last7Days&interval=day
改变区域要匹配您帐户的数据中心,请执行以下操作:我们,欧盟,ca或金.
URL参数
改变从和到以匹配要使用的日期范围。日期值必须采用ISO 8601格式,例如:
- from=YYYY-MM-DD
- = YYYY-MM-DD
过去七天的累计使用率数据可用。或者,可以使用指定相对时间范围时间范围=最近7天.只有在这个时候一天作为支持的时间间隔提供。
但是,如果日志未收到数据,则不会显示在当天的结果中。
成功响应
此API调用的成功响应代码为HTTP 200。成功响应的内容类似于以下内容:
1.
{
2.
" per_day_usage ": {
3.
“用法”:[
4.
{
5.
“时间间隔”:“2018-12-16”,
6.
“日志使用”:[
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
“日志使用”:[
25
{
26
“用法”:7648949,
27
“id”:“50499f85-”
28
},
29
{
30
“使用”:7764258,
31
“id”:“b2f37a6f-
32
}
33
...
34
]
35
},
36
{
37
“时间间隔”:“2018-12-18”,
38
“日志使用”:[
39
{
40
“用法”:8388395,
41
“id”:“50499f85-”
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
“使用单位”:“字节”,
60
“report_interval”:“一天”
61
}
62
}
示例调用
下面是GET日志用法的API调用示例:
1.
进口的要求
2.
导入json
3.
导入时间
4.
5.
6.
API_键='读/写API键'
7.
8.
def句柄_响应(resp):
9
响应=响应
10
time . sleep (1)
11
如果response.status_code==200:
12
打印json.dumps (resp.json(),缩进= 4)
13
其他:
14
打印response.status_code
15
16
def发出请求(提供的url=无):
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_用法():
24
req=发出请求()
25
句柄\u响应(req)
26
27
def start():
28
get_用法()
29
30
31
如果uuuu name uuuuuu='\uuuuuuu main\uuuuuuu':
32
开始()
这个页面对你有帮助吗?