younifyd
Menu

Update Logpush Job

Update Logpush job.

PUT/organizations/{organizationId}/zones/{zoneId}/logpush/jobs/{jobId}

Use it in a workflow

  1. Add a step and choose the Salesforce Commerce Cloud connector.
  2. Pick the Update Logpush Job action (under Zones (Data API)).
  3. Fill in the fields below, then reference the result from later steps as {{updateLogpushJob.response.data}}.

Request

Path parameters

jobIdstringrequired
zoneIdstringrequired
organizationIdstringrequired

An identifier for the organization the request is being made by

Request body

Enter the body as JSON in the step's Body field.

destinationPathstring

Uniquely identifies the destination path for log storage. This string can include additional configuration parameters, such as the AWS region. Use the {DATE} placeholder in the URL path to automatically organize logs into daily subdirectories; for example, `s3://customer-bucket/logs/{DATE}?region=us-east-1&sse=AES256`. At runtime, the {DATE} variable is replaced with the current date in YYYYMMDD format, for example, 20260127, to ensure logs are stored in the appropriate daily folder.

enabledboolean

Flag that indicates if the job is enabled or disabled.

filterstring

Provides customized selection for logs you want to receive. Filters are added as escaped, formatted JSON strings. By default, all logs are included.

logFieldsarray<string>

List of log fields. Depending on the log type, the list of fields that you can specify to be displayed in the log might vary.

json
{
  "destinationPath": "s3://customer-bucket/site-name/{DATE}?region=us-east-1&sse=AES256",
  "enabled": true,
  "filter": "{\"where\":{\"key\":\"ClientRequestPath\",\"operator\":\"contains\",\"value\":\"/example-path\"}}",
  "logFields": [
    "ClientRequestBytes",
    "ClientRequestHost",
    "ClientRequestMethod"
  ]
}

Response

Returns 200 with an object. Read it in later steps with {{updateLogpushJob.response.data.<field>}}.

dataobject

Logpush job response

jobIdinteger

Unique ID of the job.

namestring

Logpush job name; the name cannot be changed after the job is created.

logTypestring

Type of logs; available log types are `http_requests`, `firewall_events`, and `page_shield_events`.

One ofhttp_requestsfirewall_eventspage_shield_events

filterstring

Filter provides a way to customize which logs you want to receive. Filters are added as escaped JSON strings formatted. If the filter is not displayed, it indicates that all logs should be included.

logFieldsarray<string>

List of log fields. Depending on the type of log, the list of fields that you would like to see in the logs may vary.

destinationPathstring

Uniquely identifies s3 bucket for logs.

enabledboolean

Flag that indicates if the job is enabled or disabled.

lastCompletestring (date-time)

The last time that the log has been successfully transmitted to the destination.

lastErrorstring (date-time)

The last time the job failed. If empty, the job has either never failed or has run successfully at least once since the last failure.

errorMessagestring

Provide details for the last failure message. If this field is empty, it indicates that the job successfully transmitted logs to the destination.

createdOnstring (date-time)

Job creation time.

json
{
  "data": {
    "jobId": 123456,
    "name": "my-logpush-job",
    "logType": "http_requests",
    "filter": "{\"where\":{\"key\":\"ClientRequestPath\",\"operator\":\"contains\",\"value\":\"/example-path\"}}",
    "logFields": [
      "ClientRequestBytes",
      "ClientRequestHost",
      "ClientRequestMethod"
    ],
    "destinationPath": "s3://customer-bucket/site-name/{DATE}?region=us-east-1&sse=AES256",
    "enabled": false,
    "lastComplete": "2023-01-02T00:00:00Z",
    "lastError": "2023-01-01T10:00:00Z",
    "errorMessage": "No permissions to write to destination bucket",
    "createdOn": "2023-01-01T00:00:27Z"
  }
}

Need more? See the Salesforce Commerce Cloud guide for connection setup and behaviour shared by every action.