Method: folders.locations.securityCenterServices.patch

Aktualisiert einen Security Command Center-Dienst mit der angegebenen Aktualisierungsmaske.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
securityCenterService.name

string

Kennung. Der Name des Dienstes in einem der folgenden Formate:

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

Die folgenden Werte sind für {service} zulässig:

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

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Pflichtangabe. Die zu aktualisierenden Felder. Akzeptiert die folgenden Werte als Eingabe:

  • intendedEnablementState
  • modules

Wenn Sie das Feld weglassen, werden alle entsprechenden Felder aktualisiert.

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
validateOnly

boolean

Optional. Wenn dieser Wert auf true festgelegt ist, wird die Anfrage validiert (einschließlich IAM-Prüfungen), aber kein Dienst wird aktualisiert. Eine OK-Antwort gibt an, dass die Anfrage gültig ist, während eine Fehlerantwort darauf hinweist, dass die Anfrage ungültig ist.

Auch wenn die Anfrage gültig ist, kann eine nachfolgende Anfrage zum Aktualisieren des Dienstes aus einem der folgenden Gründe fehlschlagen:

  • Der Status Ihrer Cloud-Ressourcen hat sich geändert, z. B. wenn eine erforderliche IAM-Berechtigung verloren gegangen ist.
  • Beim Aktualisieren des Dienstes ist ein Fehler aufgetreten

Die Standardeinstellung ist false.

Anfragetext

Der Anfragetext enthält eine Instanz von SecurityCenterService.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von SecurityCenterService.

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:

  • securitycentermanagement.securityCenterServices.update

Weitere Informationen finden Sie in der IAM-Dokumentation.