Método: transferConfigs.create

Nome completo: projects.transferConfigs.create

Cria uma nova configuração de transferência de dados.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O ID do projeto do BigQuery em que a configuração de transferência precisa ser criada. Precisa estar no formato projects/{projectId}/locations/{locationId} ou projects/{projectId}. Se o local especificado e o local de destino do conjunto de dados do BigQuery não corresponderem, a solicitação falhará.

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • bigquery.transfers.update

Parâmetros de consulta

Parâmetros
authorizationCode

string

Código de autorização OAuth2 opcional para usar com essa configuração de transferência. É obrigatório caso sejam necessárias novas credenciais, conforme indicado por dataSources.checkValidCreds. Para receber o authorizationCode, faça uma solicitação para https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?clientId=&scope=&redirect_uri=

  • clientId precisa ser o OAuth clientId da API DTS do BigQuery para a fonte de dados fornecida retornada pelo método dataSources.list.
  • data_source_scopes são os escopos retornados pelo método dataSources.list.
  • redirect_uri é um parâmetro opcional. Se não for especificado, o código de autorização será postado na janela de abertura do fluxo de autorização. Caso contrário, será enviado para o URI de redirecionamento. Um valor especial de urn:ietf:wg:oauth:2.0:oob significa que o código de autorização precisa ser retornado na barra de título do navegador, com o texto da página solicitando que o usuário copie o código e cole-o no aplicativo.
versionInfo

string

Informações opcionais de versão. Se os usuários quiserem encontrar um token de acesso muito recente, ou seja, logo após aprovar o acesso, será necessário definir a declaração versionInfo na solicitação do token. Para encontrar o versionInfo, os usuários precisam usar o tipo de resposta "none+gsession", que retorna um versionInfo na resposta de autorização que será colocada em uma declaração JWT na solicitação do token.

serviceAccountName

string

Nome opcional da conta de serviço. Se esse campo estiver definido, a configuração de transferência será criada usando as credenciais da conta de serviço. Para isso, o usuário que chama a API precisa ter permissões para realizar ações com essa conta de serviço.

Corpo da solicitação

O corpo da solicitação contém uma instância de TransferConfig.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de TransferConfig.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral da autenticação.

Testar