Methode: transferConfigs.patch

Vollständiger Name: projects.transferConfigs.patch

Aktualisiert eine Konfiguration der Datenübertragung. Alle Felder müssen festgelegt werden, auch wenn sie nicht aktualisiert werden.

HTTP-Anfrage

PATCH https://bigquerydatatransfer.googleapis.com/v1/{transferConfig.name=projects/*/transferConfigs/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
transferConfig.name

string

Der Ressourcenname der Übertragungskonfiguration. Namen von Übertragungskonfigurationen haben das Format projects/{projectId}/locations/{region}/transferConfigs/{configId}. Der Name wird automatisch anhand der in „CreateTransferConfigRequest“ für „config_id“ angegebenen ID zusammen mit der ID für „project_id“ und der Region generiert. Ist „config_id“ nicht angegeben, wird normalerweise eine UUID für „config_id“ generiert. Dies ist aber weder garantiert noch immer erforderlich.

Abfrageparameter

Parameter
authorizationCode

string

Ein optionaler OAuth2-Autorisierungscode zur Verwendung mit dieser Übertragungskonfiguration; Wenn angegeben, wird die Übertragungskonfiguration dem autorisierenden Nutzer zugeordnet. Zum Abrufen eines Autorisierungscodes senden Sie eine Anfrage an https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?clientId=&scope=&redirect_uri=.

  • Dabei muss „client_id“ 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ückgegeben werden soll. Dabei wird der Nutzer im Text der Seite aufgefordert, den Code zu kopieren und in die Anwendung einzufügen.
updateMask

string (FieldMask format)

Erforderlich. Erforderliche Liste der Felder, die in dieser Anfrage aktualisiert werden sollen.

Eine kommagetrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
versionInfo

string

Optionale Versionsinformation. Wenn Nutzer ein gerade festgelegtes 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. Dieser Wert wird in eine JWT-Anforderung in der Tokenanfrage eingefügt.
serviceAccountName

string

Optionaler Dienstkontoname. Wenn dieses Feld festgelegt und „serviceAccountName“ in „updateMask“ angegeben ist, wird die Übertragungskonfiguration aktualisiert, damit diese Anmeldedaten für dieses Dienstkonto verwendet werden. 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

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine 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!