Method: projects.locations.processes.runs.list

Lists runs in the given project and location. List order is descending by startTime.

HTTP request

GET https://datalineage.googleapis.com/v1/{parent}/runs

Path parameters

Parameters
parent

string

Required. The name of process that owns this collection of runs. It takes the form projects/{project}/locations/{location}/processes/{processes}.

Query parameters

Parameters
pageSize

integer

The maximum number of runs to return. The service may return fewer than this value. If unspecified, at most 50 runs are returned. The maximum value is 100; values greater than 100 are cut to 100.

pageToken

string

The page token received from a previous runs.list call. Specify it to get the next page.

When paginating, all other parameters specified in this call must match the parameters of the call that provided the page token.

Request body

The request body must be empty.

Response body

Response message for runs.list.

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

JSON representation
{
  "runs": [
    {
      object (Run)
    }
  ],
  "nextPageToken": string
}
Fields
runs[]

object (Run)

The runs from the specified project and location.

nextPageToken

string

The token to specify as pageToken in the next call to get the next page. If this field is omitted, there are no subsequent pages.

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:

  • datalineage.runs.list

For more information, see the IAM documentation.