Method: projects.locations.investigations.create

Erstellt eine neue Untersuchung in einem bestimmten Projekt.

HTTP-Anfrage

POST https://geminicloudassist.googleapis.com/v1alpha/{parent=projects/*/locations/*}/investigations

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Wert für das übergeordnete Element. Der Standort muss auf „global“ festgelegt sein.

Abfrageparameter

Parameter
investigationId

string

Optional. Die für die Prüfung zu verwendende ID, die als letzte Komponente des Ressourcennamens der Untersuchung verwendet wird.

Dieser Wert sollte 4 bis 63 Zeichen umfassen. Gültige Zeichen sind /[az][0-9]-/.

Wenn nicht angegeben, generiert der Server eine eindeutige ID für die Prüfung.
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.

Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage senden 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 eingegangen ist. 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 Investigation.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine neu erstellte Instanz von Investigation.

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:

  • geminicloudassist.investigations.create

Weitere Informationen finden Sie in der IAM-Dokumentation.