POST Log

POST Log

Request used to add a log to a given account.

URL

https://REGION.rest.logs.insight.rapid7.com/management/logs

REGION is the data center for your account - e.g. "us" or "eu"

Method

POST

Authentication

Read/Write Key is required.

URL Params

None

Data Params

json
1
{
2
  "log": {
3
    "name": "My New Awesome Log",
4
    "structures": [],
5
    "user_data": {
6
      "le_agent_filename": "",
7
      "le_agent_follow": "false"
8
    },
9
    "source_type": "token",
10
    "token_seed": null,
11
    "logsets_info": [
12
      {
13
        "id": "d25737e8-7135-4b48-b0f8-4b4b5b60b358"
14
      }
15
    ]
16
  }
17
}

Success Response

When a new Log is created the response will be 201. Code 201Content:

json
1
{
2
  "log": {
3
    "id": "214fc1e5-d66a-48ef-bffd-8d30c4f6359c",
4
    "name": "My New Awesome Log",
5
    "tokens": [
6
      "daf42867-a82f-487e-95b7-8d10dba6c4f5"
7
    ],
8
    "structures": [],
9
    "user_data": {
10
      "le_agent_filename": "",
11
      "le_agent_follow": "false"
12
    },
13
    "logsets_info": [
14
      {
15
        "id": "00b75d7a-9820-4ce8-8d70-82ed58dc7f53"
16
      }
17
    ]
18
  }
19
}

Sample Code

json
1
import json
2
import requests
3

4
rw_key ='00112233-4455-6677-8899-aabbccddeeff'
5
uri = 'management/logs'
6
body = {"log":{"name":"My New Awesome Log","structures":[],"user_data":{"le_agent_filename":"","le_agent_follow":"false"},"source_type":"token","token_seed":None,"logsets_info":[{"id":"00b75d7a-9820-4ce8-8d70-82ed58dc7f53"}]}}
7

8
def create_log():
9
    url = "https://us.rest.logs.insight.rapid7.com/" + uri
10
    headers = {
11
        'x-api-key': rw_key,
12
        "Content-Type": "application/json"
13
    }
14
    r = requests.post(url, data=json.dumps(body, separators=(',', ':')), headers=headers)
15
    print r.status_code, r.content
16

17
def start():
18
    create_log()
19

20
if __name__ == '__main__':
21
    start()