Workflows Service, gRPC: ExecutionService.List

Field

Description

workflowId

string

Required field. ID of the Workflow.

pageSize

int64

The maximum number of results per page that should be returned. If the number of available
results is larger than pageSize, the service returns a ListExecutionsResponse.nextPageToken
that can be used to get the next page of results in subsequent list requests.

Default value: 100.

pageToken

string

Page token. To get the next page of results, set pageToken to the
ListExecutionsResponse.nextPageToken returned by a previous list request.

filter

string

A filter expression that filters resources listed in the response.

The expression must specify:

1. The field name. Currently filtering can be applied to the following fields: status, started_at, finished_at.
2. Operator: =, < or >.
3. The value. Must be sting and match the regular expression [+:\.-a-z0-9].
   Examples of a filter: status=ERROR, created_by=John.Doe.

Field

Description

executions[]

ExecutionPreview

List of Workflow executions.

nextPageToken

string

Token for getting the next page of the list. If the number of results is greater than
the specified ListExecutionsRequest.pageSize, use next_page_token as the value
for the ListExecutionsRequest.pageToken parameter in the next list request.

Each subsequent page will have its own next_page_token to continue paging through the results.

Field

Description

id

string

ID of the Workflow execution. Generated at creation time.

workflowId

string

ID of the Workflow.

status

enum Status

Status of the Workflow execution

• STATUS_UNSPECIFIED
• QUEUED: Workflow execution is being queued.
• RUNNING: Workflow execution is running.
• PAUSED: Workflow execution is being paused.
• STOPPED: Workflow execution is stopped.
• FAILED: Workflow execution is failed.
• FINISHED: Workflow execution is finished.

startedAt

google.protobuf.Timestamp

Start timestamp for the Workflow execution.

duration

google.protobuf.Duration

Duration of the Workflow execution.