Methode: transferConfigs.create

Vollständiger Name: projects.locations.transferConfigs.create

Erstellt eine neue Datenübertragungskonfiguration.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Die BigQuery-Projekt-ID, in der die Übertragungskonfiguration erstellt werden soll. Muss das Format „projects/{projectId}/locations/{locationId}“ oder „projects/{projectId}“ haben. Wenn der angegebene Speicherort und der Speicherort des Ziel-Datasets in BigQuery nicht übereinstimmen, schlägt die Anfrage fehl.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • bigquery.transfers.update

Suchparameter

Parameter
authorizationCode

string

Ein optionaler OAuth2-Autorisierungscode zur Verwendung mit dieser Übertragungskonfiguration. Dies ist erforderlich, wenn neue Anmeldedaten benötigt werden, wie von dataSources.checkValidCreds angegeben. Senden Sie zum Abrufen des Authorisierungscodes eine Anfrage an https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?clientId=&scope=&redirect_uri=.

  • „client_id“ muss die OAuth-clientId der BigQuery DTS API für die angegebene Datenquelle sein, die von der Methode „dataSources.list“ zurückgegeben wird.
  • "data_source_scopes" sind die Bereiche, die von der Methode "dataSources.list" zurückgegeben werden.
  • "redirect_uri" ist ein optionaler Parameter. Wenn er nicht angegeben ist, wird der Autorisierungscode an den Öffner des Autorisierungsfensters gesendet. Andernfalls wird er an den Weiterleitungs-URI gesendet. Der spezielle Wert „urn:ietf:wg:oauth:2.0:oob“ bedeutet, dass der Autorisierungscode in die Titelleiste des Browsers zurückzugeben ist. Dabei wird der Nutzer im Text der Seite aufgefordert, den Code zu kopieren und in die Anwendung einzufügen.
versionInfo

string

Optionale Versionsinformation. Wenn Nutzer ein sehr aktuelles Zugriffstoken suchen, also unmittelbar nach der Genehmigung des Zugriffs, müssen sie die versionInfo-Anforderung in der Tokenanfrage festlegen. Zum Abrufen von „versionInfo“ müssen Nutzer den Antworttyp „none+gsession“ verwenden, der den Wert von „versionInfo“ in der Autorisierungsantwort zurückgibt. Diese wird in eine JWT-Anforderung in der Tokenanfrage eingefügt.
serviceAccountName

string

Optionaler Dienstkontoname. Wenn dieses Feld festgelegt wurde, wird die Übertragungskonfiguration mit den Anmeldedaten dieses Dienstkontos erstellt. Dies setzt voraus, dass Nutzer, die diese API aufrufen, Berechtigungen zum Arbeiten in diesem Dienstkonto haben.

Anfragetext

Der Anfragetext enthält eine Instanz von TransferConfig.

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von TransferConfig.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

Testen!