v1

latestOpenAPI 3.0.0Apache 2.02026-07-17392074.2 KB
monitoring

Gets the available log files for the environment

get/monitoring/{owner}/environments/{environment}/logs/{log}

Path parameters

ownerstring required

The username of the user whose resources that you wish to access

environmentstring required

The environment that you wish to access

logstring required

The log file that you wish to access

Headers

If-Modified-Sincestring

Makes the request conditional on the resource having been modified since the given date. If the resource is unmodified a 304 Not Modified is returned.

If-Unmodified-Sincestring

Makes the request conditional on the resource having not been modified since the given date. If the resource has been modified a 412 Precondition Failed is returned.

Rangestring

Specifies a range of the resource to return instead of the full resource.

Byte based ranges per RFC 7233 are supported, additionally line based ranges are also permitted. These support the same range syntax as byte ranges except using lines instead of bytes as the unit. The main difference between byte and line ranges is that byte ranges use zero based indexing whereas line ranges use 1 based indexing. So a range of 1-5 would be the 2nd through 6th bytes but the 1st through 5th lines. Note that per the specification range boundaries are always inclusive.

If a range is statisfiable you will receive a 206 Partial Content response with a Content-Range header indicating the portion of the resource returned. If the range is unsatisfiable then you will receive a 416 Range Unsatisfiable response. If the range matches the full size of the content then you will just receive a 200 OK response with the full resource.

Range specifications that are invalid are silently discarded and will just result in the server returning a normal 200 OK response.

Ranges can be specified relative to the start/end of the content per RFC 7233. Note that when line ranges are used in this way the returned Content-Range header may not match the lines returned because the server does not know in advance how many lines are in the resource. However the starting line will always be correct and thus can be used by clients to display line numbers if they so wish.

Note that ONLY a single range may be requested. If multiple ranges are requested the server will just return the full resource.

If-Rangestring

Make a Range request conditional on the resource having not been modified since the given date. If the resource has been modified since the given date then the Range request will not be honoured and the full resource will be returned instead.

Response

Full log file contents (at time of the request)