- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- IAM-Berechtigungen
Erstellt einen neuen DataAgent in einem bestimmten Projekt und an einem bestimmten Ort.
HTTP-Anfrage
POST https://geminidataanalytics.googleapis.com/v1alpha/{parent=projects/*/locations/*}/dataAgents
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter | |
|---|---|
parent |
Pflichtangabe. Wert für das übergeordnete Element. |
Anfrageparameter
| Parameter | |
|---|---|
dataAgentId |
Optional. ID des anfragenden Objekts. Muss innerhalb des übergeordneten Elements eindeutig sein. Das zulässige Format ist: |
requestId |
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 Sie sie noch einmal wiederholen müssen. Der Server stellt dies mindestens 60 Minuten lang nach der ersten Anfrage sicher. Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage stellen und diese das Zeitlimit überschreitet. Wenn Sie die Anfrage mit derselben Anfrage-ID noch einmal 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. Dadurch wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen. Die Anfrage-ID muss eine gültige UUID sein, mit der Ausnahme, dass UUIDs mit Nullen nicht unterstützt werden (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 neu erstellte Instanz von Operation.
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 parent:
geminidataanalytics.dataAgents.create
Weitere Informationen finden Sie in der IAM-Dokumentation.