PUT Log

GET Logs

Request used to update a specific Log for an 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

PUT

Authentication

Owner, Read Write or Read Only key is required.

URL Params

logid='113933b0-6b0c-4b96-830f-777071ccf470'

Data Params

json
1
{
2
    "log": {
3
        "logsets_info": [
4
            {
5
                "id": "4e6dadf9-961e-48f4-82cf-452de78eb217", 
6
                "links": [
7
                    {
8
                        "href": "https://us.rest.logs.insight.rapid7.com/management/logsets/4e6dadf9-961e-48f4-82cf-452de78eb217", 
9
                        "rel": "Self"
10
                    }
11
                ], 
12
                "name": "ibtest"
13
            }
14
        ], 
15
        "name": "MyUpdatedLogName", 
16
        "user_data": {
17
            "le_agent_filename": "", 
18
            "le_agent_follow": "false"
19
        }, 
20
        "tokens": [
21
            "856bd7f8-07b4-4cf2-889d-3ce0793ff76f"
22
        ], 
23
        "token_seed": null, 
24
        "structures": []
25
    }
26
}

Success Response

Code 200Content:

json
1
{
2
    "log": {
3
        "logsets_info": [
4
            {
5
                "id": "4e6dadf9-961e-48f4-82cf-452de78eb217", 
6
                "links": [
7
                    {
8
                        "href": "https://us.rest.logs.insight.rapid7.com/management/logsets/4e6dadf9-961e-48f4-82cf-452de78eb217", 
9
                        "rel": "Self"
10
                    }
11
                ], 
12
                "name": "ibtest"
13
            }
14
        ], 
15
        "name": "MyUpdatedLogName", 
16
        "user_data": {
17
            "le_agent_filename": "", 
18
            "le_agent_follow": "false"
19
        }, 
20
        "tokens": [
21
            "856bd7f8-07b4-4cf2-889d-3ce0793ff76f"
22
        ], 
23
        "source_type": "token", 
24
        "token_seed": null, 
25
        "structures": [],
26
        "id": "0f5e4d20-fef3-4b91-b4c2-c2573466bbdd"
27
    }
28
}

Sample Call

python
1
import base64
2
import datetime
3
import hashlib
4
import hmac
5
import json
6
import requests
7

8
rw_key ='00112233-4455-6677-8899-aabbccddeeff'
9
uri = 'management/logs/ecca4c14-338d-4452-b842-5fca8c86b9cb'
10
body = {"log":{"logsets_info":[{"id":"4e6dadf9-961e-48f4-82cf-452de78eb217","links":[{"href":"https://us.rest.logs.insight.rapid7.com/management/logsets/4e6dadf9-961e-48f4-82cf-452de78eb217","rel":"Self"}],"name":"ibtest"}],"name":"MyUpdatedLogName","user_data":{"le_agent_filename":"","le_agent_follow":"false"},"tokens":["113933b0-6b0c-4b96-830f-777071ccf470"],"token_seed":null,"structures":[],"id":"0f5e4d20-fef3-4b91-b4c2-c2573466bbdd"}}
11

12
def put_log():
13
    url = "https://us.rest.logs.insight.rapid7.com/" + uri
14
    headers = {
15
        'x-api-key': rw_key,
16
        "Content-Type": "application/json"
17
    }
18
    r = requests.put(url, data=json.dumps(body, separators=(',', ':')), headers=headers)
19
    print r.status_code, r.content
20

21

22
def start():
23
    put_log()
24

25
if __name__ == '__main__':
26
    start()

Notes