方法: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

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

试试看!