Method: organizations.locations.postureDeployments.patch

Aggiorna un PostureDeployment esistente.

Per evitare che gli aggiornamenti simultanei si sovrascrivano a vicenda, segui sempre il pattern di lettura, modifica e scrittura quando aggiorni un deployment di posture:

  1. Chiama postureDeployments.get per ottenere la versione corrente del deployment.
  2. Aggiorna i campi nel deployment in base alle necessità.
  3. Chiama postureDeployments.patch per aggiornare il deployment. Assicurati che la richiesta includa il valore etag della risposta postureDeployments.get.

Importante:se ometti etag quando chiami postureDeployments.patch, il deployment aggiornato sovrascrive incondizionatamente quello esistente.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
postureDeployment.name

string

Obbligatorio. Identificatore. Il nome del deployment della configurazione di sicurezza, nel formato organizations/{organization}/locations/global/postureDeployments/{deployment_id}.

Parametri di query

Parametri
updateMask

string (FieldMask format)

Obbligatorio. I campi in PostureDeployment da aggiornare.

Puoi aggiornare solo i seguenti campi:

Si tratta di un elenco separato da virgole di nomi completi dei campi. Esempio: "user.displayName,photo".

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di PostureDeployment.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa name:

  • securityposture.postureDeployments.update

Per ulteriori informazioni, consulta la documentazione di IAM.