Method: projects.locations.transferConfigs.create

Creates a new data transfer configuration.

HTTP request

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

The URL uses Google API HTTP annotation syntax.

Path parameters

Parameters
parent

string

The BigQuery project id where the transfer configuration should be created. Must be in the format /projects/{project_id}/locations/{locationId} or /projects/{project_id}/locations/- In case when '-' is specified as locationId, location is infered from the destination dataset region.

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

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

Query parameters

Parameters
authorizationCode

string

Optional OAuth2 authorization code to use with this transfer configuration. This is required if new credentials are needed, as indicated by dataSources.checkValidCreds. In order to obtain authorizationCode, please make a request to https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?clientId=&scope=&redirect_uri=

  • clientId should be OAuth clientId of BigQuery DTS API for the given data source returned by dataSources.list method.
  • data_source_scopes are the scopes returned by dataSources.list method.
  • redirect_uri is an optional parameter. If not specified, then authorization code is posted to the opener of authorization flow window. Otherwise it will be sent to the redirect uri. A special value of urn:ietf:wg:oauth:2.0:oob means that authorization code should be returned in the title bar of the browser, with the page text prompting the user to copy the code and paste it in the application.

Request body

The request body contains an instance of TransferConfig.

Response body

If successful, the response body contains a newly created instance of TransferConfig.

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...