received
Creates, updates, deletes, gets or lists a received resource.
Overview
| Name | received |
| Type | Resource |
| Id | cloudflare.logs.received |
Fields
The following fields are returned by SELECT queries:
- list
Get logs received response
| Name | Datatype | Description |
|---|
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list | select | zone_id | start, end, fields, sample, count, timestamps | The /received api route allows customers to retrieve their edge HTTP logs. The basic access pattern is "give me all the logs for zone Z for minute M", where the minute M refers to the time records were received at Cloudflare's central data center. start is inclusive, and end is exclusive. Because of that, to get all data, at minutely cadence, starting at 10AM, the proper values are: start=2018-05-20T10:00:00Z&end=2018-05-20T10:01:00Z, then start=2018-05-20T10:01:00Z&end=2018-05-20T10:02:00Z and so on; the overlap will be handled properly. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
zone_id | string | The Cloudflare zone ID. |
count | integer | |
end | string | |
fields | string | |
sample | number | |
start | string | |
timestamps | string |
SELECT examples
- list
The /received api route allows customers to retrieve their edge HTTP logs. The basic access pattern is "give me all the logs for zone Z for minute M", where the minute M refers to the time records were received at Cloudflare's central data center. start is inclusive, and end is exclusive. Because of that, to get all data, at minutely cadence, starting at 10AM, the proper values are: start=2018-05-20T10:00:00Z&end=2018-05-20T10:01:00Z, then start=2018-05-20T10:01:00Z&end=2018-05-20T10:02:00Z and so on; the overlap will be handled properly.
SELECT
*
FROM cloudflare.logs.received
WHERE zone_id = '{{ zone_id }}' -- required
AND start = '{{ start }}'
AND end = '{{ end }}'
AND fields = '{{ fields }}'
AND sample = '{{ sample }}'
AND count = '{{ count }}'
AND timestamps = '{{ timestamps }}'
;