Method: organizations.locations.postures.patch

• HTTP-Anfrage
• Pfadparameter
• Anfrageparameter
• Anfragetext
• Antworttext
• Autorisierungsbereiche
• IAM-Berechtigungen

Aktualisiert eine Version einer vorhandenen Buchung (Posture).

Wenn die von Ihnen aktualisierte Sicherheitsstatusversion derzeit bereitgestellt wird, wird eine neue Version des Sicherheitsstatus erstellt.

Damit verhindert wird, dass sich gleichzeitige Updates gegenseitig überschreiben, folgen Sie beim Aktualisieren einer Posture immer dem Muster „Lesen-Ändern-Schreiben“:

1. Rufen Sie postures.get auf, um die aktuelle Version der Haltung abzurufen.
2. Aktualisieren Sie die Felder in der Haltung nach Bedarf.
3. Rufen Sie postures.patch auf, um die Position zu aktualisieren. Die Anfrage muss den Wert etag aus der postures.get-Antwort enthalten.

Wichtig:Wenn Sie etag beim Aufruf von postures.patch weglassen, wird die vorhandene Position durch die aktualisierte Position bedingungslos überschrieben.

HTTP-Anfrage

PATCH https://securityposture.googleapis.com/v1/{posture.name=organizations/*/locations/*/postures/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
posture.name	string Erforderlich. Kennung. Der Name der Körperhaltung im Format organizations/{organization}/locations/global/postures/{postureId}.

Abfrageparameter

Parameter
updateMask	string (FieldMask format) Pflichtangabe. Die zu aktualisierenden Felder in der Posture. Sie können nur die folgenden Felder aktualisieren: Posture.description Posture.policy_sets Posture.state Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
revisionId	string Pflichtangabe. Die Revision-ID der zu aktualisierenden Posture. Wenn die von Ihnen aktualisierte Sicherheitsstatusversion derzeit bereitgestellt wird, wird eine neue Version des Sicherheitsstatus erstellt.

Anfragetext

Der Anfragetext enthält eine Instanz von Posture.

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:

• securityposture.postures.update

Weitere Informationen finden Sie in der IAM-Dokumentation.