获取日志使用
您可以使用“GET Logs Usage”请求方法检索指定时间段内所有日志的数据使用情况。结果将按接收数据的升序排序。注意,这个API调用返回所有日志使用值(以字节为单位)。
身份验证
在开始之前,请确保您有一个具有读/写权限的API密钥。
URL
为你的API调用使用以下URL格式:
1https://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进口json3.导入的时间456API_KEY = '读写API键'78def handle_response(职责):9响应=职责10time . sleep (1)11如果响应。status_code = = 200:12打印json.dumps (resp.json(),缩进= 4)13其他:14打印response.status_code1516def make_request (provided_url = None):17headers = {'x-api-key': API_KEY}18url = " https://us.rest.logs.insight.rapid7.com/usage/organizations/logs?time_range=Last3Days&interval=day "19要求=请求。get (url,标题=标题)20.返回请求212223def get_usage ():24要求= make_request ()25handle_response(要求)2627def开始():28get_usage ()2930.31如果__name__ == '__main__':32start ()
这个页面对你有帮助吗?