Automation Runs

An AutomationRun is a record with information about a single execution of a given Automation.

Automation Runs can be retried upon failure or partial_failure by setting the retry_on_failure_interval_in_minutes and retry_on_failure_number_of_attempts settings on the associated Automation.

When retries occur, a new AutomationRun will be created for each retry. The property retry_at on the original run, if set, represents when that run will be retried next. The properties retried_at and retried_in_run_id will be set in the original run that failed, at the time of retry. The property retry_of_run_id will be set in the new run.

List Automation Runs

SDK Function

AutomationRun.list()

Return Object

ListIterator<AutomationRun>

Authorization Requirement

Available to all authenticated keys or sessions.

Function Arguments

ArgumentDescription
user_id
int64		User ID. Provide a value of 0 to operate the current session's user.
automation_id
int64
Required		ID of the associated Automation.

Additional Arguments

Example Request

import com.files.ListIterator;
import com.files.exceptions.*;
import com.files.exceptions.ApiErrorException.*;
import com.files.models.AutomationRun;

try {
  HashMap<String, Object> parameters = new HashMap<>();
  parameters.put("automation_id", 1);
  
  ListIterator<AutomationRun> automationRuns = AutomationRun.list(parameters);
  for (AutomationRun automationRun : automationRuns.listAutoPaging()) {
    // Operate on automationRun
  }
} catch (NotAuthenticatedException e) {
  System.out.println("Authentication Error Occurred (" + e.getClass().getName() + "): " + e.getMessage());
} catch (SdkException e) {
  System.out.println("Unknown Error Occurred (" + e.getClass().getName() + "): " + e.getMessage());
}

Show Automation Run

SDK Function

AutomationRun.find()

Return Object

AutomationRun

Authorization Requirement

Available to all authenticated keys or sessions.

Function Arguments

ArgumentDescription
id
int64
Required		Automation Run ID.

Example Request

import com.files.exceptions.*;
import com.files.exceptions.ApiErrorException.*;
import com.files.models.AutomationRun;

try {
  HashMap<String, Object> parameters = new HashMap<>();
  AutomationRun automationRun = AutomationRun.find(id, parameters);
  // Operate on automationRun
} catch (NotAuthenticatedException e) {
  System.out.println("Authentication Error Occurred (" + e.getClass().getName() + "): " + e.getMessage());
} catch (SdkException e) {
  System.out.println("Unknown Error Occurred (" + e.getClass().getName() + "): " + e.getMessage());
}

Cancel Automation Run

SDK Function

automationRun.cancel();

Return Object

AutomationRun

Authorization Requirement

Available to all authenticated keys or sessions.

Example Request

import com.files.exceptions.*;
import com.files.exceptions.ApiErrorException.*;
import com.files.models.AutomationRun;

try {
  // Find the automationRun object by its id.
  AutomationRun automationRun = AutomationRun.find(id, null);
  automationRun.cancel(null);
} catch (NotAuthenticatedException e) {
  System.out.println("Authentication Error Occurred (" + e.getClass().getName() + "): " + e.getMessage());
} catch (SdkException e) {
  System.out.println("Unknown Error Occurred (" + e.getClass().getName() + "): " + e.getMessage());
}

Re-run Automation from Node

SDK Function

automationRun.rerun();

Return Object

AutomationRun

Authorization Requirement

Available to all authenticated keys or sessions.

Attribute Setters

SetterDescription
setNodeId
string
Required		Node ID at which execution should resume.

Example Request

import com.files.exceptions.*;
import com.files.exceptions.ApiErrorException.*;
import com.files.models.AutomationRun;

try {
  // Find the automationRun object by its id.
  AutomationRun automationRun = AutomationRun.find(id, null);
  HashMap<String, Object> parameters = new HashMap<>();
  parameters.put("node_id", "node_id");
  automationRun.rerun(parameters);
} catch (NotAuthenticatedException e) {
  System.out.println("Authentication Error Occurred (" + e.getClass().getName() + "): " + e.getMessage());
} catch (SdkException e) {
  System.out.println("Unknown Error Occurred (" + e.getClass().getName() + "): " + e.getMessage());
}

The AutomationRun Object

Some of the functions above return a AutomationRun object. The attributes of this object are listed below.

AttributeDescription
id
int64		ID.
automation_id
int64		ID of the associated Automation.
automation_version_id
int64		ID of the immutable Automation version pinned by this run.
version
int64		Pinned Automation v2 definition version.
workspace_id
int64		Workspace ID.
cancel_requested_at
date-time		Date/time at which cancellation was requested.
completed_at
date-time		Automation run completion/failure date/time.
created_at
date-time		Automation run start date/time.
retry_at
date-time		If set, this automation will be retried at this date/time due to failure or partial_failure.
retried_at
date-time		If set, this Automation run was retried due to failure or partial_failure.
retried_in_run_id
int64		ID of the run that is or will be retrying this run.
retry_of_run_id
int64		ID of the original run that this run is retrying.
rerun_of_run_id
int64		ID of the run whose persisted node outputs this run reused.
rerun_from_node_id
string		Node at which this run resumed execution.
runtime
double		Automation run runtime.
status
string		The status of the AutomationRun. One of queued, running, success, partial_failure, failure, skipped, or canceled.
Possible values: running, success, partial_failure, failure, skipped, queued, canceled
successful_operations
int64		Count of successful operations.
failed_operations
int64		Count of failed operations.
definition
object		Automation definition snapshot pinned by this run. For performance reasons, this is not provided when listing Automation runs.
node_states
object		Status and execution stage for each node in this run. For performance reasons, this is not provided when listing Automation runs.
execution_nodes
array(object)		Execution status, timing, and bounded output summaries for each node. For performance reasons, this is not provided when listing Automation runs.
journal_url
string		Link to the run journal artifact.
status_messages_url
string		Link to status messages log file.