Method: projects.locations.deliveryPipelines.releases.rollouts.create

Erstellt ein neues Roll-out in einem bestimmten Projekt und an einem Standort.

HTTP-Anfrage

POST https://clouddeploy.googleapis.com/v1/{parent=projects/*/locations/*/deliveryPipelines/*/releases/*}/rollouts

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Die übergeordnete Sammlung, in der das Rollout erstellt werden soll. Verwenden Sie das Format projects/{projectId}/locations/{location_name}/deliveryPipelines/{pipeline_name}/releases/{release_name}.

Abfrageparameter

Parameter
rolloutId

string

Erforderlich. ID von Rollout.
requestId

string

Optional. Eine Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, wenn sie noch einmal ausgeführt wurde. Der Server garantiert dies für mindestens 60 Minuten nach der ersten Anfrage.

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 null UUID nicht unterstützt wird (00000000-0000-0000-0000-000000000000).
validateOnly

boolean

Optional. Ist die Richtlinie auf „true“ gesetzt, wird die Anfrage validiert und der Nutzer erhält ein erwartetes Ergebnis. Es wird jedoch keine Änderung vorgenommen.
startingPhaseId

string

Optional. Die Startphasen-ID für den Rollout. Wenn das Feld leer ist, beginnt Rollout mit der ersten Phase.

Anfragetext

Der Anfragetext enthält eine Instanz von Rollout.

Antworttext

Bei Erfolg 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 in der Authentifizierungsübersicht.

IAM-Berechtigungen

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

  • clouddeploy.rollouts.create

Weitere Informationen finden Sie in der IAM-Dokumentation.