Binary Logs

FetchBinaryLogsUrl

Fetches the URL to a zip file containing one or more binary log files for the requested device and time range. The returned URL can be used to download the zip file.

For more information, see the nRF Cloud documentation on binary logs.

get/binary-logs/url

Query parameters

deviceIdstring required

This is the canonical device id used in the device certificate, and as the MQTT client id.

Example:nrf-1234567890123456789000
startstring date-time

HTML-encoded ISO-8601 date-time string denoting the start or end of a date range. If the string includes only a date, the time is the beginning of the day (00:00:00).

Example:2020-06-25T21:05:12.830Z

By default, the start time for the range is 24 hours before the current time. The range between start and end cannot be greater than 24 hours.

endstring date-time

HTML-encoded ISO-8601 date-time string denoting the start or end of a date range. If the string includes only a date, the time is the beginning of the day (00:00:00).

Example:2020-06-25T21:05:12.830Z

By default, the end time for the range is the current time. The range between start and end cannot be greater than 24 hours.

Response

Ok

urlstring url required

The URL to download the file from.

contentLengthnumber double required

Content length of the file in bytes.

Example response

{
  "url": "https://binarylogsbucket2142-1xw7gxky91xt5.s3.us-east-1.amazonaws.com/798978d6-ed41-4d5d-ba03-59bea8da378d",
  "contentLength": 128
}

Changes