Upload an external mapping file to Logz.io storage.

POST 
https://api.logz.io/v1/sawmill/external-mapping/upload

Uploads an external mapping file in .properties format to Logz.io storage. This file can be used later by Sawmill ExternalMappingSourceProcessor. This feature is not available by default. To enable it, contact Logz.io support. 10 files can be uploaded per account. The file size is limited to 50 MB. Please ensure to change the region in the URL to match your account's region.

Request

multipart/form-data

Body

file binary[]

Responses

201

successful operation

application/json

Schema

Schema

result string

Successfully updated external mapping

Example (from schema)

{
  "result": "Successfully updated external mapping"
}

400

bad request

application/json

Schema

Schema

errorCode string
message string
requestId string
parameters object
currentLimit integer

Example (from schema)

{
  "errorCode": "FILE_RESTRICTIONS/EXTERNAL_MAPPINGS_LIMIT_REACHED",
  "message": "Failed to upload external mapping. Exceeded allowed amount of mapping files per account - 10. Please Contact Support to delete old mappings.",
  "requestId": "string",
  "parameters": {
    "currentLimit": 10
  }
}

422

validation error

application/json

Schema

Schema

result string

Failed to update external mapping

Example (from schema)

{
  "result": "Failed to update external mapping"
}

Authorization: X-API-TOKEN

name: X-API-TOKENtype: apiKeydescription: You can manage your API tokens from the [Logz.io API tokens](https://app.logz.io/#/dashboard/settings/manage-tokens/api) page.

API tokens are account-specific. You will need to be logged into the relevant Log Management or SIEM account to view the API tokens associated with it.

To manage your API tokens, log into the relevant account in your Logz.io platform, click the gear in the top-right menu, and select [**Tools > Manage tokens > API tokens**](https://app.logz.io/#/dashboard/settings/manage-tokens/api).

It's important to keep your tokens secure. API tokens carry privileges to make changes to users and accounts, so if you believe an API token has been compromised, delete it, and replace it with a new token in your integrations.in: header

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X POST 'https://api.logz.io/v1/sawmill/external-mapping/upload' \
-H 'Content-Type: multipart/form-data' \
-H 'Accept: application/json' \
-H 'X-API-TOKEN: <API_KEY_VALUE>' \
--data-raw ''

Request Collapse all

Base URL

https://api.logz.io

Auth

X-API-TOKEN

Body