---
title: Logpush
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api/terraform)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Logpush
#### LogpushDatasetsFields
#### data cloudflare\_logpush\_dataset\_field
##### optional Expand Collapse
account\_id?: String
The Account ID to use for this endpoint. Mutually exclusive with the Zone ID.
[Link to this property](<#(resource)%20logpush.datasets.fields%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20account_id>)
zone\_id?: String
The Zone ID to use for this endpoint. Mutually exclusive with the Account ID.
[Link to this property](<#(resource)%20logpush.datasets.fields%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20zone_id>)
dataset\_id?: String
Name of the dataset. A list of supported datasets can be found on the [Developer Docs](https://developers.cloudflare.com/logs/reference/log-fields/).
[Link to this property](<#(resource)%20logpush.datasets.fields%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20dataset_id>)
##### computed Expand Collapse
fields: Map\[String]
[Link to this property](<#(resource)%20logpush.datasets.fields%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20fields>)
### cloudflare\_logpush\_dataset\_field
Terraform
HTTPTypeScriptPythonGoTerraform
```
data "cloudflare_logpush_dataset_field" "example_logpush_dataset_field" {
dataset_id = "gateway_dns"
account_id = "account_id"
zone_id = "zone_id"
}
```
#### LogpushDatasetsJobs
#### data cloudflare\_logpush\_dataset\_job
##### optional Expand Collapse
account\_id?: String
The Account ID to use for this endpoint. Mutually exclusive with the Zone ID.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20account_id>)
zone\_id?: String
The Zone ID to use for this endpoint. Mutually exclusive with the Account ID.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20zone_id>)
dataset\_id?: String
Name of the dataset. A list of supported datasets can be found on the [Developer Docs](https://developers.cloudflare.com/logs/reference/log-fields/).
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20dataset_id>)
##### computed Expand Collapse
dataset: String
Name of the dataset. A list of supported datasets can be found on the [Developer Docs](https://developers.cloudflare.com/logs/reference/log-fields/).
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20dataset>)
destination\_conf: String
Uniquely identifies a resource (such as an s3 bucket) where data. will be pushed. Additional configuration parameters supported by the destination may be included.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20destination_conf>)
enabled: Bool
Flag that indicates if the job is enabled.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20enabled>)
error\_message: String
If not null, the job is currently failing. Failures are usually. repetitive (example: no permissions to write to destination bucket). Only the last failure is recorded. On successful execution of a job the error\_message and last\_error are set to null.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20error_message>)
filter\_attack\_traffic: Bool
When true, excludes DDoS attack traffic from logs. This option is supported for the `http_requests`, `firewall_events`, and `network_analytics_logs` datasets.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20filter_attack_traffic>)
Deprecatedfrequency: String
This field is deprecated. Please use `max_upload_*` parameters instead. . The frequency at which Cloudflare sends batches of logs to your destination. Setting frequency to high sends your logs in larger quantities of smaller files. Setting frequency to low sends logs in smaller quantities of larger files.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20frequency>)
id: Int64
Unique id of the job.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20id>)
kind: String
The kind parameter (optional) is used to differentiate between Logpush and Edge Log Delivery jobs (when supported by the dataset).
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20kind>)
last\_complete: Time
Records the last time for which logs have been successfully pushed. If the last successful push was for logs range 2018-07-23T10:00:00Z to 2018-07-23T10:01:00Z then the value of this field will be 2018-07-23T10:01:00Z. If the job has never run or has just been enabled and hasn’t run yet then the field will be empty.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20last_complete>)
last\_error: Time
Records the last time the job failed. If not null, the job is currently. failing. If null, the job has either never failed or has run successfully at least once since last failure. See also the error\_message field.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20last_error>)
Deprecatedlogpull\_options: String
This field is deprecated. Use `output_options` instead. Configuration string. It specifies things like requested fields and timestamp formats. If migrating from the logpull api, copy the url (full url or just the query string) of your call here, and logpush will keep on making this call for you, setting start and end times appropriately.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20logpull_options>)
max\_upload\_bytes: Int64
The maximum uncompressed file size of a batch of logs. This setting value must be between `5 MB` and `1 GB`, or `0` to disable it. Note that you cannot set a minimum file size; this means that log files may be much smaller than this batch size.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20max_upload_bytes>)
max\_upload\_interval\_seconds: Int64
The maximum interval in seconds for log batches. This setting must be between 30 and 300 seconds (5 minutes), or `0` to disable it. Note that you cannot specify a minimum interval for log batches; this means that log files may be sent in shorter intervals than this.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20max_upload_interval_seconds>)
max\_upload\_records: Int64
The maximum number of log lines per batch. This setting must be between 1000 and 1,000,000 lines, or `0` to disable it. Note that you cannot specify a minimum number of log lines per batch; this means that log files may contain many fewer lines than this.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20max_upload_records>)
name: String
Optional human readable job name. Not unique. Cloudflare suggests. that you set this to a meaningful string, like the domain name, to make it easier to identify your job.
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20name>)
output\_options: Attributes
The structured replacement for logpull_options. When including this field, the logpull_option field will be ignored.
batch\_prefix: String
String to be prepended before each batch.
Link to this property
batch\_suffix: String
String to be appended after each batch.
Link to this property
cve\_2021\_44228: Bool
If set to true, will cause all occurrences of ${ in the generated files to be replaced with x{.
Link to this property
field\_delimiter: String
String to join fields. This field be ignored when record_template is set.
Link to this property
field\_names: List\[String]
List of field names to be included in the Logpush output. For the moment, there is no option to add all fields at once, so you must specify all the fields names you are interested in.
Link to this property
merge\_subrequests: Bool
If set to true, subrequests will be merged into the parent request. Only supported for the http_requests dataset. Not supported for account-scoped jobs.
Link to this property
output\_type: String
Specifies the output type, such as ndjson or csv. This sets default values for the rest of the settings, depending on the chosen output type. Some formatting rules, like string quoting, are different between output types.
Link to this property
record\_delimiter: String
String to be inserted in-between the records as separator.
Link to this property
record\_prefix: String
String to be prepended before each record.
Link to this property
record\_suffix: String
String to be appended after each record.
Link to this property
record\_template: String
String to use as template for each record instead of the default json key value mapping. All fields used in the template must be present in field_names as well, otherwise they will end up as null. Format as a Go text/template without any standard functions, like conditionals, loops, sub-templates, etc.
Link to this property
sample\_rate: Float64
Specifies the sampling rate as a floating number greater than 0 and at most 1. Sampling is applied on top of filtering, and regardless of the current sample_interval of the data.
Link to this property
timestamp\_format: String
String to specify the format for timestamps, such as unixnano, unix, rfc3339, rfc3339ms or rfc3339ns.
Link to this property
[Link to this property](<#(resource)%20logpush.datasets.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20output_options>)
### cloudflare\_logpush\_dataset\_job
Terraform
HTTPTypeScriptPythonGoTerraform
```
data "cloudflare_logpush_dataset_job" "example_logpush_dataset_job" {
dataset_id = "gateway_dns"
account_id = "account_id"
zone_id = "zone_id"
}
```
#### LogpushJobs
#### resource cloudflare\_logpush\_job
##### required Expand Collapse
destination\_conf: String
Uniquely identifies a resource (such as an s3 bucket) where data. will be pushed. Additional configuration parameters supported by the destination may be included.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20destination_conf>)
##### optional Expand Collapse
account\_id?: String
The Account ID to use for this endpoint. Mutually exclusive with the Zone ID.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20account_id>)
zone\_id?: String
The Zone ID to use for this endpoint. Mutually exclusive with the Account ID.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20zone_id>)
dataset?: String
Name of the dataset. A list of supported datasets can be found on the [Developer Docs](https://developers.cloudflare.com/logs/reference/log-fields/).
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20dataset>)
filter?: String
The filters to select the events to include and/or remove from your logs. For more information, refer to [Filters](https://developers.cloudflare.com/logs/reference/filters/).
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20filter>)
Deprecatedlogpull\_options?: String
This field is deprecated. Use `output_options` instead. Configuration string. It specifies things like requested fields and timestamp formats. If migrating from the logpull api, copy the url (full url or just the query string) of your call here, and logpush will keep on making this call for you, setting start and end times appropriately.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20logpull_options>)
max\_upload\_bytes?: Int64
The maximum uncompressed file size of a batch of logs. This setting value must be between `5 MB` and `1 GB`, or `0` to disable it. Note that you cannot set a minimum file size; this means that log files may be much smaller than this batch size.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20max_upload_bytes>)
max\_upload\_interval\_seconds?: Int64
The maximum interval in seconds for log batches. This setting must be between 30 and 300 seconds (5 minutes), or `0` to disable it. Note that you cannot specify a minimum interval for log batches; this means that log files may be sent in shorter intervals than this.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20max_upload_interval_seconds>)
max\_upload\_records?: Int64
The maximum number of log lines per batch. This setting must be between 1000 and 1,000,000 lines, or `0` to disable it. Note that you cannot specify a minimum number of log lines per batch; this means that log files may contain many fewer lines than this.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20max_upload_records>)
name?: String
Optional human readable job name. Not unique. Cloudflare suggests. that you set this to a meaningful string, like the domain name, to make it easier to identify your job.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20name>)
ownership\_challenge?: String
Ownership challenge token to prove destination ownership.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20ownership_challenge>)
output\_options?: Attributes
The structured replacement for logpull_options. When including this field, the logpull_option field will be ignored.
batch\_prefix?: String
String to be prepended before each batch.
Link to this property
batch\_suffix?: String
String to be appended after each batch.
Link to this property
cve\_2021\_44228?: Bool
If set to true, will cause all occurrences of ${ in the generated files to be replaced with x{.
Link to this property
field\_delimiter?: String
String to join fields. This field be ignored when record_template is set.
Link to this property
field\_names?: List\[String]
List of field names to be included in the Logpush output. For the moment, there is no option to add all fields at once, so you must specify all the fields names you are interested in.
Link to this property
merge\_subrequests?: Bool
If set to true, subrequests will be merged into the parent request. Only supported for the http_requests dataset. Not supported for account-scoped jobs.
Link to this property
output\_type?: String
Specifies the output type, such as ndjson or csv. This sets default values for the rest of the settings, depending on the chosen output type. Some formatting rules, like string quoting, are different between output types.
Link to this property
record\_delimiter?: String
String to be inserted in-between the records as separator.
Link to this property
record\_prefix?: String
String to be prepended before each record.
Link to this property
record\_suffix?: String
String to be appended after each record.
Link to this property
record\_template?: String
String to use as template for each record instead of the default json key value mapping. All fields used in the template must be present in field_names as well, otherwise they will end up as null. Format as a Go text/template without any standard functions, like conditionals, loops, sub-templates, etc.
Link to this property
sample\_rate?: Float64
Specifies the sampling rate as a floating number greater than 0 and at most 1. Sampling is applied on top of filtering, and regardless of the current sample_interval of the data.
Link to this property
timestamp\_format?: String
String to specify the format for timestamps, such as unixnano, unix, rfc3339, rfc3339ms or rfc3339ns.
Link to this property
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20output_options>)
enabled?: Bool
Flag that indicates if the job is enabled.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20enabled>)
filter\_attack\_traffic?: Bool
When true, excludes DDoS attack traffic from logs. This option is supported for the `http_requests`, `firewall_events`, and `network_analytics_logs` datasets.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20filter_attack_traffic>)
Deprecatedfrequency?: String
This field is deprecated. Please use `max_upload_*` parameters instead. . The frequency at which Cloudflare sends batches of logs to your destination. Setting frequency to high sends your logs in larger quantities of smaller files. Setting frequency to low sends logs in smaller quantities of larger files.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20frequency>)
kind?: String
The kind parameter (optional) is used to differentiate between Logpush and Edge Log Delivery jobs (when supported by the dataset).
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20kind>)
##### computed Expand Collapse
id: Int64
Unique id of the job.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20id>)
error\_message: String
If not null, the job is currently failing. Failures are usually. repetitive (example: no permissions to write to destination bucket). Only the last failure is recorded. On successful execution of a job the error\_message and last\_error are set to null.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20error_message>)
last\_complete: Time
Records the last time for which logs have been successfully pushed. If the last successful push was for logs range 2018-07-23T10:00:00Z to 2018-07-23T10:01:00Z then the value of this field will be 2018-07-23T10:01:00Z. If the job has never run or has just been enabled and hasn’t run yet then the field will be empty.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20last_complete>)
last\_error: Time
Records the last time the job failed. If not null, the job is currently. failing. If null, the job has either never failed or has run successfully at least once since last failure. See also the error\_message field.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20last_error>)
### cloudflare\_logpush\_job
Terraform
HTTPTypeScriptPythonGoTerraform
```
resource "cloudflare_logpush_job" "example_logpush_job" {
destination_conf = "s3://mybucket/logs?region=us-west-2"
zone_id = "zone_id"
dataset = "http_requests"
enabled = false
filter = "{\"where\":{\"and\":[{\"key\":\"ClientRequestPath\",\"operator\":\"contains\",\"value\":\"/static\"},{\"key\":\"ClientRequestHost\",\"operator\":\"eq\",\"value\":\"example.com\"}]}}"
filter_attack_traffic = true
frequency = "high"
kind = ""
logpull_options = "fields=RayID,ClientIP,EdgeStartTimestamp×tamps=rfc3339"
max_upload_bytes = 5000000
max_upload_interval_seconds = 30
max_upload_records = 1000
name = "example.com"
output_options = {
batch_prefix = "batch_prefix"
batch_suffix = "batch_suffix"
cve_2021_44228 = true
field_delimiter = "field_delimiter"
field_names = ["ClientIP", "EdgeStartTimestamp", "RayID"]
merge_subrequests = true
output_type = "ndjson"
record_delimiter = "record_delimiter"
record_prefix = "record_prefix"
record_suffix = "record_suffix"
record_template = "record_template"
sample_rate = 1
timestamp_format = "unixnano"
}
ownership_challenge = "00000000000000000000"
}
```
#### data cloudflare\_logpush\_job
##### required Expand Collapse
job\_id: Int64
Unique id of the job.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20job_id>)
##### optional Expand Collapse
account\_id?: String
The Account ID to use for this endpoint. Mutually exclusive with the Zone ID.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20account_id>)
zone\_id?: String
The Zone ID to use for this endpoint. Mutually exclusive with the Account ID.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20zone_id>)
##### computed Expand Collapse
id: Int64
Unique id of the job.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20id>)
dataset: String
Name of the dataset. A list of supported datasets can be found on the [Developer Docs](https://developers.cloudflare.com/logs/reference/log-fields/).
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20dataset>)
destination\_conf: String
Uniquely identifies a resource (such as an s3 bucket) where data. will be pushed. Additional configuration parameters supported by the destination may be included.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20destination_conf>)
enabled: Bool
Flag that indicates if the job is enabled.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20enabled>)
error\_message: String
If not null, the job is currently failing. Failures are usually. repetitive (example: no permissions to write to destination bucket). Only the last failure is recorded. On successful execution of a job the error\_message and last\_error are set to null.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20error_message>)
filter\_attack\_traffic: Bool
When true, excludes DDoS attack traffic from logs. This option is supported for the `http_requests`, `firewall_events`, and `network_analytics_logs` datasets.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20filter_attack_traffic>)
Deprecatedfrequency: String
This field is deprecated. Please use `max_upload_*` parameters instead. . The frequency at which Cloudflare sends batches of logs to your destination. Setting frequency to high sends your logs in larger quantities of smaller files. Setting frequency to low sends logs in smaller quantities of larger files.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20frequency>)
kind: String
The kind parameter (optional) is used to differentiate between Logpush and Edge Log Delivery jobs (when supported by the dataset).
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20kind>)
last\_complete: Time
Records the last time for which logs have been successfully pushed. If the last successful push was for logs range 2018-07-23T10:00:00Z to 2018-07-23T10:01:00Z then the value of this field will be 2018-07-23T10:01:00Z. If the job has never run or has just been enabled and hasn’t run yet then the field will be empty.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20last_complete>)
last\_error: Time
Records the last time the job failed. If not null, the job is currently. failing. If null, the job has either never failed or has run successfully at least once since last failure. See also the error\_message field.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20last_error>)
Deprecatedlogpull\_options: String
This field is deprecated. Use `output_options` instead. Configuration string. It specifies things like requested fields and timestamp formats. If migrating from the logpull api, copy the url (full url or just the query string) of your call here, and logpush will keep on making this call for you, setting start and end times appropriately.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20logpull_options>)
max\_upload\_bytes: Int64
The maximum uncompressed file size of a batch of logs. This setting value must be between `5 MB` and `1 GB`, or `0` to disable it. Note that you cannot set a minimum file size; this means that log files may be much smaller than this batch size.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20max_upload_bytes>)
max\_upload\_interval\_seconds: Int64
The maximum interval in seconds for log batches. This setting must be between 30 and 300 seconds (5 minutes), or `0` to disable it. Note that you cannot specify a minimum interval for log batches; this means that log files may be sent in shorter intervals than this.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20max_upload_interval_seconds>)
max\_upload\_records: Int64
The maximum number of log lines per batch. This setting must be between 1000 and 1,000,000 lines, or `0` to disable it. Note that you cannot specify a minimum number of log lines per batch; this means that log files may contain many fewer lines than this.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20max_upload_records>)
name: String
Optional human readable job name. Not unique. Cloudflare suggests. that you set this to a meaningful string, like the domain name, to make it easier to identify your job.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20name>)
output\_options: Attributes
The structured replacement for logpull_options. When including this field, the logpull_option field will be ignored.
batch\_prefix: String
String to be prepended before each batch.
Link to this property
batch\_suffix: String
String to be appended after each batch.
Link to this property
cve\_2021\_44228: Bool
If set to true, will cause all occurrences of ${ in the generated files to be replaced with x{.
Link to this property
field\_delimiter: String
String to join fields. This field be ignored when record_template is set.
Link to this property
field\_names: List\[String]
List of field names to be included in the Logpush output. For the moment, there is no option to add all fields at once, so you must specify all the fields names you are interested in.
Link to this property
merge\_subrequests: Bool
If set to true, subrequests will be merged into the parent request. Only supported for the http_requests dataset. Not supported for account-scoped jobs.
Link to this property
output\_type: String
Specifies the output type, such as ndjson or csv. This sets default values for the rest of the settings, depending on the chosen output type. Some formatting rules, like string quoting, are different between output types.
Link to this property
record\_delimiter: String
String to be inserted in-between the records as separator.
Link to this property
record\_prefix: String
String to be prepended before each record.
Link to this property
record\_suffix: String
String to be appended after each record.
Link to this property
record\_template: String
String to use as template for each record instead of the default json key value mapping. All fields used in the template must be present in field_names as well, otherwise they will end up as null. Format as a Go text/template without any standard functions, like conditionals, loops, sub-templates, etc.
Link to this property
sample\_rate: Float64
Specifies the sampling rate as a floating number greater than 0 and at most 1. Sampling is applied on top of filtering, and regardless of the current sample_interval of the data.
Link to this property
timestamp\_format: String
String to specify the format for timestamps, such as unixnano, unix, rfc3339, rfc3339ms or rfc3339ns.
Link to this property
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-single)%20%3E%20(attribute)%20output_options>)
### cloudflare\_logpush\_job
Terraform
HTTPTypeScriptPythonGoTerraform
```
data "cloudflare_logpush_job" "example_logpush_job" {
job_id = 1
account_id = "account_id"
zone_id = "zone_id"
}
```
#### data cloudflare\_logpush\_jobs
##### optional Expand Collapse
account\_id?: String
The Account ID to use for this endpoint. Mutually exclusive with the Zone ID.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20account_id>)
zone\_id?: String
The Zone ID to use for this endpoint. Mutually exclusive with the Account ID.
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20zone_id>)
max\_items?: Int64
Max items to fetch, default: 1000
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20max_items>)
##### computed Expand Collapse
result: List\[Attributes]
The items returned by the data source
id: Int64
Unique id of the job.
Link to this property
dataset: String
Name of the dataset. A list of supported datasets can be found on the Developer Docs.
Link to this property
destination\_conf: String
Uniquely identifies a resource (such as an s3 bucket) where data. will be pushed. Additional configuration parameters supported by the destination may be included.
Link to this property
enabled: Bool
Flag that indicates if the job is enabled.
Link to this property
error\_message: String
If not null, the job is currently failing. Failures are usually. repetitive (example: no permissions to write to destination bucket). Only the last failure is recorded. On successful execution of a job the error\_message and last\_error are set to null.
Link to this property
filter\_attack\_traffic: Bool
When true, excludes DDoS attack traffic from logs. This option is supported for the http_requests, firewall_events, and network_analytics_logs datasets.
Link to this property
Deprecatedfrequency: String
This field is deprecated. Please use max_upload_* parameters instead. . The frequency at which Cloudflare sends batches of logs to your destination. Setting frequency to high sends your logs in larger quantities of smaller files. Setting frequency to low sends logs in smaller quantities of larger files.
Link to this property
kind: String
The kind parameter (optional) is used to differentiate between Logpush and Edge Log Delivery jobs (when supported by the dataset).
Link to this property
last\_complete: Time
Records the last time for which logs have been successfully pushed. If the last successful push was for logs range 2018-07-23T10:00:00Z to 2018-07-23T10:01:00Z then the value of this field will be 2018-07-23T10:01:00Z. If the job has never run or has just been enabled and hasn’t run yet then the field will be empty.
Link to this property
last\_error: Time
Records the last time the job failed. If not null, the job is currently. failing. If null, the job has either never failed or has run successfully at least once since last failure. See also the error\_message field.
Link to this property
Deprecatedlogpull\_options: String
This field is deprecated. Use output_options instead. Configuration string. It specifies things like requested fields and timestamp formats. If migrating from the logpull api, copy the url (full url or just the query string) of your call here, and logpush will keep on making this call for you, setting start and end times appropriately.
Link to this property
max\_upload\_bytes: Int64
The maximum uncompressed file size of a batch of logs. This setting value must be between 5 MB and 1 GB, or 0 to disable it. Note that you cannot set a minimum file size; this means that log files may be much smaller than this batch size.
Link to this property
max\_upload\_interval\_seconds: Int64
The maximum interval in seconds for log batches. This setting must be between 30 and 300 seconds (5 minutes), or 0 to disable it. Note that you cannot specify a minimum interval for log batches; this means that log files may be sent in shorter intervals than this.
Link to this property
max\_upload\_records: Int64
The maximum number of log lines per batch. This setting must be between 1000 and 1,000,000 lines, or 0 to disable it. Note that you cannot specify a minimum number of log lines per batch; this means that log files may contain many fewer lines than this.
Link to this property
name: String
Optional human readable job name. Not unique. Cloudflare suggests. that you set this to a meaningful string, like the domain name, to make it easier to identify your job.
Link to this property
output\_options: Attributes
The structured replacement for logpull_options. When including this field, the logpull_option field will be ignored.
batch\_prefix: String
String to be prepended before each batch.
Link to this property
batch\_suffix: String
String to be appended after each batch.
Link to this property
cve\_2021\_44228: Bool
If set to true, will cause all occurrences of ${ in the generated files to be replaced with x{.
Link to this property
field\_delimiter: String
String to join fields. This field be ignored when record_template is set.
Link to this property
field\_names: List\[String]
List of field names to be included in the Logpush output. For the moment, there is no option to add all fields at once, so you must specify all the fields names you are interested in.
Link to this property
merge\_subrequests: Bool
If set to true, subrequests will be merged into the parent request. Only supported for the http_requests dataset. Not supported for account-scoped jobs.
Link to this property
output\_type: String
Specifies the output type, such as ndjson or csv. This sets default values for the rest of the settings, depending on the chosen output type. Some formatting rules, like string quoting, are different between output types.
Link to this property
record\_delimiter: String
String to be inserted in-between the records as separator.
Link to this property
record\_prefix: String
String to be prepended before each record.
Link to this property
record\_suffix: String
String to be appended after each record.
Link to this property
record\_template: String
String to use as template for each record instead of the default json key value mapping. All fields used in the template must be present in field_names as well, otherwise they will end up as null. Format as a Go text/template without any standard functions, like conditionals, loops, sub-templates, etc.
Link to this property
sample\_rate: Float64
Specifies the sampling rate as a floating number greater than 0 and at most 1. Sampling is applied on top of filtering, and regardless of the current sample_interval of the data.
Link to this property
timestamp\_format: String
String to specify the format for timestamps, such as unixnano, unix, rfc3339, rfc3339ms or rfc3339ns.
Link to this property
Link to this property
[Link to this property](<#(resource)%20logpush.jobs%20%3E%20(terraform%20datasource-plural)%20%3E%20(attribute)%20result>)
### cloudflare\_logpush\_jobs
Terraform
HTTPTypeScriptPythonGoTerraform
```
data "cloudflare_logpush_jobs" "example_logpush_jobs" {
account_id = "account_id"
zone_id = "zone_id"
}
```
#### LogpushOwnership
#### resource cloudflare\_logpush\_ownership\_challenge
##### required Expand Collapse
destination\_conf: String
Uniquely identifies a resource (such as an s3 bucket) where data. will be pushed. Additional configuration parameters supported by the destination may be included.
[Link to this property](<#(resource)%20logpush.ownership%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20destination_conf>)
##### optional Expand Collapse
account\_id?: String
The Account ID to use for this endpoint. Mutually exclusive with the Zone ID.
[Link to this property](<#(resource)%20logpush.ownership%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20account_id>)
zone\_id?: String
The Zone ID to use for this endpoint. Mutually exclusive with the Account ID.
[Link to this property](<#(resource)%20logpush.ownership%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20zone_id>)
##### computed Expand Collapse
filename: String
[Link to this property](<#(resource)%20logpush.ownership%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20filename>)
message: String
[Link to this property](<#(resource)%20logpush.ownership%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20message>)
valid: Bool
[Link to this property](<#(resource)%20logpush.ownership%20%3E%20(terraform%20resource)%20%3E%20(attribute)%20valid>)
### cloudflare\_logpush\_ownership\_challenge
Terraform
HTTPTypeScriptPythonGoTerraform
```
resource "cloudflare_logpush_ownership_challenge" "example_logpush_ownership_challenge" {
destination_conf = "s3://mybucket/logs?region=us-west-2"
zone_id = "zone_id"
}
```