Method: organizations.locations.securityHealthAnalyticsCustomModules.patch

Aktualisiert die SecurityHealthAnalyticsCustomModule unter 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 und der benutzerdefinierten Konfiguration eines Moduls wird nur für residente Module unterstützt.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
securityHealthAnalyticsCustomModule.name

string

Kennung. Der vollständige Ressourcenname des benutzerdefinierten Moduls in einem der folgenden Formate:

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

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Pflichtangabe. Die zu aktualisierenden Felder. Die folgenden Werte sind zulässig:

  • customConfig
  • enablementState

Wenn Sie dieses Feld weglassen oder auf den Platzhalterwert * setzen, werden alle infrage kommenden 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 SecurityHealthAnalyticsCustomModule.

Antworttext

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

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

Weitere Informationen finden Sie in der IAM-Dokumentation.