Method: projects.locations.transferConfigs.runs.list

Returns information about running and completed jobs.

HTTP request

GET https://bigquerydatatransfer.googleapis.com/v1/{parent=projects/*/locations/*/transferConfigs/*}/runs

The URL uses Google API HTTP annotation syntax.

Path parameters

Parameters
parent

string

Name of transfer configuration for which transfer runs should be retrieved. Format of transfer configuration resource name is: projects/{project_id}/transferConfigs/{config_id}.

Authorization requires one or more of the following Google IAM permissions on the specified resource parent:

  • resourcemanager.projects.own
  • resourcemanager.projects.update
  • resourcemanager.projects.get
  • bigquery.transfers.get
  • bigquery.transfers.update

Query parameters

Parameters
states

enum(TransferState)

When specified, only transfer runs with requested states are returned.

pageToken

string

Pagination token, which can be used to request a specific page of ListTransferRunsRequest list results. For multiple-page results, ListTransferRunsResponse outputs a next_page token, which can be used as the pageToken value to request the next page of list results.

pageSize

number

Page size. The default page size is the maximum value of 1000 results.

runAttempt

enum(RunAttempt)

Indicates how run attempts are to be pulled.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of ListTransferRunsResponse.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the Auth Guide.

Try it!

Monitor your resources on the go

Get the Google Cloud Console app to help you manage your projects.

Send feedback about...