Método: transferConfigs.create

Nombre completo: projects.locations.transferConfigs.create

Crea una configuración de transferencia de datos nueva.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el ID del proyecto de BigQuery en el que se debe crear la configuración de transferencia. Debe tener el formato projects/{projectId}/locations/{locationId} o projects/{projectId}. Si la ubicación especificada y la ubicación del conjunto de datos de destino de BigQuery no coinciden, la solicitud fallará.

La autorización requiere el siguiente permiso de IAM en el recurso parent especificado:

  • bigquery.transfers.update

Parámetros de consulta

Parámetros
authorizationCode

string

Es un código de autorización de OAuth2 opcional para usar con esta configuración de transferencia. Es obligatorio si se necesitan credenciales nuevas, como lo indica dataSources.checkValidCreds. Para obtener authorizationCode, realiza una solicitud a https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?clientId=&scope=&redirect_uri=

  • clientId debe ser clientId de OAuth de la API de DTS de BigQuery para la fuente de datos determinada que muestra el método dataSources.list.
  • data_source_scopes son los permisos que muestra el método dataSources.list.
  • redirect_uri es un parámetro opcional. Si no se especifica, se publica el código de autorización en la ventana de apertura del flujo de autorización. De lo contrario, se enviará al URI de redireccionamiento. Un valor especial de urn:ietf:wg:oauth:2.0:oob significa que el código de autorización debe mostrarse en la barra de título del navegador, con el texto de la página que solicita al usuario copiar el código y pegarlo en la aplicación.
versionInfo

string

Información opcional de la versión. Si los usuarios desean encontrar un token de acceso muy reciente, es decir, justo después de aprobar el acceso, tendrán que establecer la reclamación de versionInfo en la solicitud de token. Para obtener versionInfo, los usuarios deben usar el tipo de respuesta “none+gsession”, que muestra una respuesta versionInfo en la respuesta de autorización que se incluirá en una reclamación JWT en la solicitud de token.

serviceAccountName

string

Es el nombre opcional de la cuenta de servicio. Si se configura este campo, se creará la configuración de transferencia con las credenciales de esta cuenta de servicio. Se requiere que el usuario que realiza la solicitud y llama a esta API tenga permisos para actuar como esta cuenta de servicio.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de TransferConfig.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de TransferConfig.

Permisos de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

Pruébalo