Method: folders.locations.securityHealthAnalyticsCustomModules.patch

Aggiorna SecurityHealthAnalyticsCustomModule con il nome specificato in base alla maschera di aggiornamento specificata. L'aggiornamento dello stato di attivazione è supportato sia per i moduli residenti che per quelli ereditati (anche se i moduli residenti non possono avere uno stato di attivazione "ereditato"). L'aggiornamento del nome visualizzato e della configurazione personalizzata di un modulo è supportato solo per i moduli residenti.

Richiesta HTTP

PATCH https://securitycentermanagement.googleapis.com/v1/{securityHealthAnalyticsCustomModule.name=folders/*/locations/*/securityHealthAnalyticsCustomModules/*}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
securityHealthAnalyticsCustomModule.name

string

Identificatore. Il nome completo della risorsa del modulo personalizzato, in uno dei seguenti formati:

  • organizations/{organization}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}
  • folders/{folder}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}
  • projects/{project}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}

Parametri di query

Parametri
updateMask

string (FieldMask format)

Obbligatorio. I campi da aggiornare. Sono validi i seguenti valori:

  • customConfig
  • enablementState

Se ometti questo campo o lo imposti sul valore jolly *, vengono aggiornati tutti i campi idonei.

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

boolean

Facoltativo. Se impostato su true, la richiesta verrà convalidata (inclusi i controlli IAM), ma nessun modulo verrà aggiornato. Una risposta OK indica che la richiesta è valida, mentre una risposta di errore indica che la richiesta non è valida.

Se la richiesta è valida, una richiesta successiva di aggiornamento del modulo potrebbe comunque non andare a buon fine per uno dei seguenti motivi:

  • Lo stato delle risorse cloud è cambiato; ad esempio, hai perso un'autorizzazione IAM richiesta
  • Si è verificato un errore durante la creazione del modulo

Il valore predefinito è false.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di SecurityHealthAnalyticsCustomModule.

Corpo della risposta

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

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:

  • securitycentermanagement.securityHealthAnalyticsCustomModules.update

Per ulteriori informazioni, consulta la documentazione di IAM.