Method: projects.locations.dataAgents.updateSync

Aktualisiert die Parameter eines einzelnen DataAgent synchron.

HTTP-Anfrage


PATCH https://geminidataanalytics.googleapis.com/v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync

Für die URLs wird die Syntax der gRPC-Transcodierung verwendet.

Pfadparameter

Parameter
dataAgent.name

string

Optional. ID. Der eindeutige Ressourcenname eines DataAgents. Format: projects/{project}/locations/{location}/dataAgents/{dataAgentId}. {dataAgent} ist die Ressourcen-ID. Sie darf maximal 63 Zeichen lang sein und muss dem Format entsprechen, das unter https://google.aip.dev/122#resource-id-segments beschrieben wird.

Beispiel: projects/1234567890/locations/global/dataAgents/my-agent.

Es wird empfohlen, dieses Feld bei der Agentenerstellung nicht festzulegen, da es automatisch abgeleitet und mit {parent}/dataAgents/{dataAgentId} überschrieben wird.

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Optional. Mit der Feldmaske werden die Felder angegeben, die in der DataAgent-Ressource durch die Aktualisierung überschrieben werden sollen. Die in „updateMask“ angegebenen Felder beziehen sich auf die Ressource und nicht auf die vollständige Anfrage. Ein Feld wird überschrieben, wenn es in der Maske enthalten ist. Wenn der Nutzer keine Maske angibt, werden alle Felder mit anderen Werten als Standardwerten in der Anfrage überschrieben. Wenn eine Platzhaltermaske angegeben wird, werden alle Felder überschrieben.

Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
requestId

string

Optional. Eine optionale Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignoriert, falls sie bereits abgeschlossen wurde und wiederholt wird. Der Server gewährleistet dies für mindestens 60 Minuten nach der ersten Anfrage.

Nehmen wir an, Sie senden eine erste Anfrage, deren Zeitlimit überschritten wird. Wenn Sie die Anfrage mit derselben Anfrage-ID erneut senden, kann der Server prüfen, ob der ursprüngliche Vorgang mit derselben Anfrage-ID empfangen wurde. Ist dies der Fall, wird die zweite Anfrage ignoriert. So wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, es sei denn, UUIDs mit Nullen werden nicht unterstützt (00000000-0000-0000-0000-000000000000).

Anfragetext

Der Anfragetext enthält eine Instanz von DataAgent.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von DataAgent.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • geminidataanalytics.dataAgents.update

Weitere Informationen finden Sie in der IAM-Dokumentation.