Method: projects.locations.targets.patch

Aktualisiert die Parameter eines einzelnen Ziels.

HTTP-Anfrage

PATCH https://clouddeploy.googleapis.com/v1/{target.name=projects/*/locations/*/targets/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
target.name

string

Optional. Name von Target. Das Format ist projects/{project}/locations/{location}/targets/{target}. Die Komponente „target“ muss mit „[a-z]([a-z0-9-]{0,61}[a-z0-9])?“ übereinstimmen

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Erforderlich. Mit der Feldmaske werden die Felder angegeben, die durch das Update in der Zielressource überschrieben werden sollen. Die in updateMask angegebenen Felder beziehen sich auf die Ressource, nicht auf die vollständige Anfrage. Ein Feld wird überschrieben, wenn es in der Maske vorhanden ist. Wenn der Nutzer keine Maske angibt, werden alle Felder überschrieben.

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
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).
allowMissing

boolean

Optional. Wenn die Richtlinie auf „true“ gesetzt ist und eine nicht vorhandene Target aktualisiert wird, wird eine neue Target erstellt.
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.

Anfragetext

Der Anfragetext enthält eine Instanz von Target.

Antworttext

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

  • clouddeploy.targets.update

Weitere Informationen finden Sie in der IAM-Dokumentation.