Skip to main content

runs

Overview

Nameruns
TypeResource
Idgoogle.bigquerydatatransfer.runs

Fields

NameDatatypeDescription
namestringThe resource name of the transfer run. Transfer run names have the form projects/{project_id}/locations/{location}/transferConfigs/{config_id}/runs/{run_id}. The name is ignored when creating a transfer run.
dataSourceIdstringOutput only. Data source id.
destinationDatasetIdstringOutput only. The BigQuery target dataset id.
emailPreferencesobjectRepresents preferences for sending email notifications for transfer run events.
endTimestringOutput only. Time when transfer run ended. Parameter ignored by server for input requests.
errorStatusobjectThe Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the API Design Guide.
notificationPubsubTopicstringOutput only. Pub/Sub topic where a notification will be sent after this transfer run finishes. The format for specifying a pubsub topic is: projects/{project}/topics/{topic}
paramsobjectOutput only. Parameters specific to each data source. For more information see the bq tab in the 'Setting up a data transfer' section for each data source. For example the parameters for Cloud Storage transfers are listed here: https://cloud.google.com/bigquery-transfer/docs/cloud-storage-transfer#bq
runTimestringFor batch transfer runs, specifies the date and time of the data should be ingested.
schedulestringOutput only. Describes the schedule of this transfer run if it was created as part of a regular schedule. For batch transfer runs that are scheduled manually, this is empty. NOTE: the system might choose to delay the schedule depending on the current load, so schedule_time doesn't always match this.
scheduleTimestringMinimum time after which a transfer run can be started.
startTimestringOutput only. Time when transfer run was started. Parameter ignored by server for input requests.
statestringData transfer run state. Ignored for input requests.
updateTimestringOutput only. Last time the data transfer run state was updated.
userIdstringDeprecated. Unique ID of the user on whose behalf transfer is done.

Methods

NameAccessible byRequired ParamsDescription
projects_locations_transfer_configs_runs_getSELECTlocationsId, projectsId, runsId, transferConfigsIdReturns information about the particular transfer run.
projects_locations_transfer_configs_runs_listSELECTlocationsId, projectsId, transferConfigsIdReturns information about running and completed transfer runs.
projects_transfer_configs_runs_getSELECTprojectsId, runsId, transferConfigsIdReturns information about the particular transfer run.
projects_transfer_configs_runs_listSELECTprojectsId, transferConfigsIdReturns information about running and completed transfer runs.
projects_locations_transfer_configs_runs_deleteDELETElocationsId, projectsId, runsId, transferConfigsIdDeletes the specified transfer run.
projects_transfer_configs_runs_deleteDELETEprojectsId, runsId, transferConfigsIdDeletes the specified transfer run.
_projects_locations_transfer_configs_runs_listEXEClocationsId, projectsId, transferConfigsIdReturns information about running and completed transfer runs.
_projects_transfer_configs_runs_listEXECprojectsId, transferConfigsIdReturns information about running and completed transfer runs.