# REST Resource: organizations.eventThreatDetectionSettings.customModules

- [Resource: EventThreatDetectionCustomModule](https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/organizations.eventThreatDetectionSettings.customModules#EventThreatDetectionCustomModule)
  - [JSON representation](https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/organizations.eventThreatDetectionSettings.customModules#EventThreatDetectionCustomModule.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/organizations.eventThreatDetectionSettings.customModules#METHODS_SUMMARY)

## Resource: EventThreatDetectionCustomModule

Represents an instance of an Event Threat Detection custom module, including its full module name, display name, enablement state, and last updated time. You can create a custom module at the organization, folder, or project level. Custom modules that you create at the organization or folder level are inherited by child folders and projects.

| JSON representation |
|---|
| ``` { "name": string, "config": { object }, "ancestorModule": string, "enablementState": enum (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/folders.eventThreatDetectionSettings.customModules#EventThreatDetectionCustomModule.EnablementState`), "type": string, "displayName": string, "description": string, "updateTime": string, "lastEditor": string, "cloudProvider": enum (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/folders.eventThreatDetectionSettings.customModules#EventThreatDetectionCustomModule.CloudProvider`) } ``` |

| Fields ||
|---|---|
| `name` | `string` Immutable. The resource name of the Event Threat Detection custom module. Its format is: - `organizations/{organization}/eventThreatDetectionSettings/customModules/{module}`. - `folders/{folder}/eventThreatDetectionSettings/customModules/{module}`. - `projects/{project}/eventThreatDetectionSettings/customModules/{module}`. |
| `config` | ``object (`https://protobuf.dev/reference/protobuf/google.protobuf#struct` format)`` Config for the module. For the resident module, its config value is defined at this level. For the inherited module, its config value is inherited from the ancestor module. |
| `ancestorModule` | `string` Output only. The closest ancestor module that this module inherits the enablement state from. The format is the same as the EventThreatDetectionCustomModule resource name. |
| `enablementState` | ``enum (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/folders.eventThreatDetectionSettings.customModules#EventThreatDetectionCustomModule.EnablementState`)`` The state of enablement for the module at the given level of the hierarchy. |
| `type` | `string` Type for the module. e.g. CONFIGURABLE_BAD_IP. |
| `displayName` | `string` The human readable name to be displayed for the module. |
| `description` | `string` The description for the module. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time the module was last updated. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `lastEditor` | `string` Output only. The editor the module was last updated by. |
| `cloudProvider` | ``enum (`https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/folders.eventThreatDetectionSettings.customModules#EventThreatDetectionCustomModule.CloudProvider`)`` The cloud provider of the custom module. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/organizations.eventThreatDetectionSettings.customModules/create` | Creates a resident Event Threat Detection custom module at the scope of the given Resource Manager parent, and also creates inherited custom modules for all descendants of the given parent. |
| ### `https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/organizations.eventThreatDetectionSettings.customModules/delete` | Deletes the specified Event Threat Detection custom module and all of its descendants in the Resource Manager hierarchy. |
| ### `https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/organizations.eventThreatDetectionSettings.customModules/get` | Gets an Event Threat Detection custom module. |
| ### `https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/organizations.eventThreatDetectionSettings.customModules/list` | Lists all Event Threat Detection custom modules for the given Resource Manager parent. |
| ### `https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/organizations.eventThreatDetectionSettings.customModules/listDescendant` | Lists all resident Event Threat Detection custom modules under the given Resource Manager parent and its descendants. |
| ### `https://docs.cloud.google.com/security-command-center/docs/reference/rest/v1/organizations.eventThreatDetectionSettings.customModules/patch` | Updates the Event Threat Detection custom module with the given name based on the given update mask. |