Method: projects.locations.eventThreatDetectionCustomModules.patch

Aktualisiert das benutzerdefinierte Event Threat Detection-Modul mit dem angegebenen Namen anhand der angegebenen Aktualisierungsmaske. Das Aktualisieren des Aktivierungsstatus wird sowohl für residente als auch für übernommene Module unterstützt. Residente Module können jedoch nicht den Aktivierungsstatus „übernommen“ haben. Das Aktualisieren des Anzeigenamens oder der Konfiguration eines Moduls wird nur für residente Module unterstützt. Der Typ eines Moduls kann nicht geändert werden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
eventThreatDetectionCustomModule.name

string

Kennung. Der Ressourcenname des benutzerdefinierten Moduls für Event Threat Detection in einem der folgenden Formate:

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

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Pflichtangabe. Die zu aktualisierenden Felder. Wenn sie weggelassen wird, werden alle 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 Modul 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 Moduls 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 Erstellen des Moduls ist ein Fehler aufgetreten

Die Standardeinstellung ist false.

Anfragetext

Der Anfragetext enthält eine Instanz von EventThreatDetectionCustomModule.

Antworttext

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

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

Weitere Informationen finden Sie in der IAM-Dokumentation.