Method: projects.locations.securityCenterServices.patch

Aggiorna un servizio Security Command Center utilizzando la maschera di aggiornamento specificata.

Richiesta HTTP

PATCH https://securitycentermanagement.googleapis.com/v1/{securityCenterService.name=projects/*/locations/*/securityCenterServices/*}

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
securityCenterService.name

string

Identificatore. Il nome del servizio, in uno dei seguenti formati:

  • organizations/{organization}/locations/{location}/securityCenterServices/{service}
  • folders/{folder}/locations/{location}/securityCenterServices/{service}
  • projects/{project}/locations/{location}/securityCenterServices/{service}

I seguenti valori sono validi per {service}:

  • container-threat-detection
  • event-threat-detection
  • security-health-analytics
  • vm-threat-detection
  • web-security-scanner

Parametri di query

Parametri
updateMask

string (FieldMask format)

Obbligatorio. I campi da aggiornare. Accetta i seguenti valori:

  • intendedEnablementState
  • modules

Se omesso, 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 servizio 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 servizio 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 l'aggiornamento del servizio

Il valore predefinito è false.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di SecurityCenterService.

Corpo della risposta

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

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.securityCenterServices.update

Per ulteriori informazioni, consulta la documentazione di IAM.