Method: projects.locations.integrations.executions.list

Lists the results of all the integration executions. The response includes the same information as the execution log in the Integration UI.

HTTP request

GET https://integrations.googleapis.com/v2/{parent=projects/*/locations/*/integrations/*}/executions

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. parent resource name of integration execution.

Query parameters

Parameters
filter

string

Optional. Standard filter field, we support filtering on following fields: integrationName: the name of the integration. createTime: the execution created time. updateTime: the execution last update time. state: the state of the executions. executionId: the id of the execution. triggerId: the id of the trigger.

All fields support for EQUALS, in additional: createTime and updateTime support for LESS_THAN, GREATER_THAN

Also supports operators like AND, OR, NOT For example: triggerId="id1" AND integrationName="testIntegration"
pageSize

integer

Optional. The size of entries in the response.
pageToken

string

Optional. The token returned in the previous response.
readMask

string (FieldMask format)

Optional. View mask for the response data. If set, only the field specified will be returned as part of the result. If not set, all fields in execution info will be filled and returned.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Request body

The request body must be empty.

Response body

Response for listing the Integration executions.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "executions": [
    {
      object (Execution)
    }
  ],
  "nextPageToken": string
}
Fields
executions[]

object (Execution)

Required. The list of executions.
nextPageToken

string

The token for retrieving the next page of results.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • integrations.executions.list

For more information, see the IAM documentation.

Execution

The Execution contains detailed information of an individual integration execution.

JSON representation 
{
  "name": string,
  "triggerId": string,
  "state": enum (State),
  "requestVariables": {
    object
  },
  "responseVariables": {
    object
  },
  "taskExecutions": [
    {
      object (TaskExecution)
    }
  ],
  "integrationVersionNumber": string,
  "createTime": string,
  "updateTime": string,
  "containTaskVariables": boolean,
  "executionAttemptStats": [
    {
      object (AttemptStats)
    }
  ],
  "replayInfo": {
    object (ReplayInfo)
  },
  "cloudLoggingDetails": {
    object (CloudLoggingDetails)
  },
  "integrationVersionUserLabel": string
}
Fields
name

string

Identifier. Execution resource name.
triggerId

string

The ID of the trigger invoked at the start of the execution.
state

enum (State)

Output only. Status of the execution.
requestVariables

object (Struct format)

Optional. Variables provided in the request.
responseVariables

object (Struct format)

Optional. Variables returned as part of the response.
taskExecutions[]

object (TaskExecution)

Optional. List of task executions.
integrationVersionNumber

string (int64 format)

Indicates which snapshot of integration is used for this execution.
createTime

string (Timestamp format)

Output only. Time the execution is created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Output only. Time the execution is recently updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
containTaskVariables

boolean

Indicates if the task execution contains variables.
executionAttemptStats[]

object (AttemptStats)

Start and end time of each execution attempt.
replayInfo

object (ReplayInfo)

Output only. Replay info for the execution
cloudLoggingDetails

object (CloudLoggingDetails)

Cloud Logging details for the integration version
integrationVersionUserLabel

string

Optional. User-defined label that annotates the executed integration version.

State

State of execution.

Enums
STATE_UNSPECIFIED Default.
ON_HOLD Execution is scheduled and awaiting to be triggered.
IN_PROCESS Execution is processing.
SUCCEEDED Execution successfully finished. There are no more changes after this state.
FAILED Execution failed. There's no more change after this state.
CANCELLED Execution is cancelled. There's no more change after this state.
RETRY_ON_HOLD Execution failed and is waiting for retry.
SUSPENDED Execution suspended and waiting for manual intervention.

ReplayInfo

Contains the details of the execution info: this includes the replay reason and replay tree connecting executions in a parent-child relationship

JSON representation 
{
  "originalExecutionId": string,
  "replayedExecutionIds": [
    string
  ],
  "replayReason": string
}
Fields
originalExecutionId

string

If this execution is a replay of another execution, then this field contains the original execution id.
replayedExecutionIds[]

string

If this execution has been replayed, then this field contains the execution ids of the replayed executions.
replayReason

string

reason for replay

CloudLoggingDetails

Cloud Logging details for execution info

JSON representation 
{
  "cloudLoggingSeverity": enum (CloudLoggingSeverity),
  "enableCloudLogging": boolean
}
Fields
cloudLoggingSeverity

enum (CloudLoggingSeverity)

Optional. Severity selected by the customer for the logs to be sent to Cloud Logging, for the integration version getting executed.
enableCloudLogging

boolean

Optional. Status of whether Cloud Logging is enabled or not for the integration version getting executed.

CloudLoggingSeverity

The severity will be mapped to the Integration Execution State.

Enums
CLOUD_LOGGING_SEVERITY_UNSPECIFIED Unspecified
INFO If Severity selected is INFO, then all the Integration Execution States (IN_PROCESS, ON_HOLD, SUCCEEDED, SUSPENDED, ERROR, CANCELLED) will be sent to Cloud Logging.
ERROR If Severity selected is ERROR, then only the following Integration Execution States (ERROR, CANCELLED) will be sent to Cloud Logging.
WARNING If Severity selected is WARNING, then only the following Integration Execution States (ERROR, CANCELLED) will be sent to Cloud Logging.