メソッド: transferConfigs.create

• HTTP リクエスト
• パスパラメータ
• クエリ パラメータ
• リクエストの本文
• レスポンスの本文
• 認証スコープ
• 試してみる

完全名: projects.locations.transferConfigs.create

新しいデータ転送の構成を作成します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
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

詳細については、認証の概要をご覧ください。

試してみる