Method: organizations.locations.securityHealthAnalyticsCustomModules.delete

Löscht das angegebene SecurityHealthAnalyticsCustomModule und alle untergeordneten Elemente in der Ressourcenhierarchie. Diese Methode wird nur für benutzerdefinierte Module unterstützt, die im Arbeitsspeicher vorhanden sind.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Pflichtangabe. Der Ressourcenname des benutzerdefinierten SHA-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
validateOnly

boolean

Optional. Wenn dieser Wert auf true festgelegt ist, wird die Anfrage validiert (einschließlich IAM-Prüfungen), aber kein Modul wird gelöscht. 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 ein nachfolgender Antrag auf Löschen 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 Löschen des Moduls ist ein Fehler aufgetreten

Die Standardeinstellung ist false.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

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.delete

Weitere Informationen finden Sie in der IAM-Dokumentation.