方法：transferConfigs.create

全名：projects.locations.transferConfigs.create

创建新的数据转移作业配置。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。应在其中创建转移作业配置的 BigQuery 项目的 ID。必须采用此格式：projects/{projectId}/locations/{locationId} 或 projects/{projectId}。如果指定的位置与目标 bigquery 数据集的位置不相符，则请求将会失败。

必须对指定的资源 parent 具有以下 IAM 权限才能进行授权：

  • bigquery.transfers.update

查询参数

参数
authorizationCode

string

与此转移作业配置结合使用的可选 OAuth2 授权代码。如果需要新凭据（由 dataSources.checkValidCreds 指示），则必须提供此参数。要获取 authorizationCode，请向以下链接所指向的网页发出请求：https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?clientId=&scope=&redirect_uri=

  • clientId 应是适用于指定数据源（由 dataSources.list 方法返回）的 BigQuery DTS API 的 OAuth clientId。
  • data_source_scopes 是 dataSources.list 方法返回的范围。
  • redirect_uri 是可选参数。如果未指定该参数，则授权代码会发布至授权流窗口的开启者。否则，它将发送到重定向 URI。urn:ietf:wg:oauth:2.0:oob 这个特殊值表示应在浏览器的标题栏中返回授权代码，同时在页面上显示文字，提示用户复制该代码并将其粘贴到应用中。
versionInfo

string

可选的版本信息。如果用户希望查找最新的访问令牌（即紧随批准访问权限之后），则必须在令牌请求中设置 versionInfo 声明。为了获取 versionInfo，用户必须使用“none+gsession”响应类型，该类型会在授权响应中返回 versionInfo，后者将置于令牌请求的 JWT 声明中。
serviceAccountName

string

可选的服务帐号名称。如果设置了此字段，则系统将使用此服务帐号凭据创建转移作业配置。调用此 API 的请求用户必须拥有以此服务帐号的身份执行操作的权限。

请求正文

请求正文包含一个 TransferConfig 实例。

响应正文

如果成功，响应正文将包含一个新创建的 TransferConfig 实例。

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅身份验证概览。

试试看！