REST Resource: folders.locations.securityHealthAnalyticsCustomModules

Risorsa: SecurityHealthAnalyticsCustomModule

Rappresenta un'istanza di un modulo personalizzato di Security Health Analytics, incluso il nome completo del modulo, il nome visualizzato, lo stato di attivazione e la data dell'ultima modifica. Puoi creare un modulo personalizzato a livello di organizzazione, cartella o progetto. I moduli personalizzati creati a livello di organizzazione o cartella vengono ereditati dalle cartelle e dai progetti discendenti.

Rappresentazione JSON
{
  "name": string,
  "displayName": string,
  "enablementState": enum (EnablementState),
  "updateTime": string,
  "lastEditor": string,
  "ancestorModule": string,
  "customConfig": {
    object (CustomConfig)
  }
}
Campi
name

string

Identificatore. Il nome completo della risorsa del modulo personalizzato, in uno dei seguenti formati:

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

string

Facoltativo. Il nome visualizzato del modulo personalizzato di Security Health Analytics. Questo nome visualizzato diventa la categoria di risultati per tutti i risultati restituiti da questo modulo personalizzato. Il nome visualizzato deve essere compreso tra 1 e 128 caratteri, iniziare con una lettera minuscola e contenere solo caratteri alfanumerici o trattini bassi.

enablementState

enum (EnablementState)

Facoltativo. Lo stato di attivazione del modulo personalizzato.

updateTime

string (Timestamp format)

Solo output. L'ora dell'ultimo aggiornamento del modulo personalizzato.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

lastEditor

string

Solo output. L'editor che ha aggiornato per ultimo il modulo personalizzato.

ancestorModule

string

Solo output. Specifica l'organizzazione o la cartella da cui viene ereditato il modulo personalizzato. Se vuoto, indica che il modulo personalizzato è stato creato nell'organizzazione, nella cartella o nel progetto in cui lo stai visualizzando.

customConfig

object (CustomConfig)

Facoltativo. La configurazione personalizzata specificata dall'utente per il modulo.

EnablementState

Possibili stati di abilitazione di un modulo personalizzato.

Enum
ENABLEMENT_STATE_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
ENABLED Il modulo è abilitato nell'organizzazione, nella cartella o nel progetto specificati.
DISABLED Il modulo è disattivato nell'organizzazione, nella cartella o nel progetto specificato.
INHERITED Lo stato viene ereditato da un modulo precedente. Il modulo sarà effettivamente ENABLED o DISABLED in base al modulo principale non ereditato più vicino nella gerarchia delle risorse. Se provi a impostare un modulo di primo livello (un modulo senza elemento principale) sullo stato INHERITED, viene visualizzato un errore INVALID_ARGUMENT.

Metodi

create

Crea un SecurityHealthAnalyticsCustomModule residente nell'ambito dell'organizzazione, della cartella o del progetto specificati e crea anche risorse SecurityHealthAnalyticsCustomModule ereditate per tutte le cartelle e i progetti discendenti dell'elemento principale specificato.

delete

Consente di eliminare SecurityHealthAnalyticsCustomModule specificato e tutti i suoi discendenti nella gerarchia delle risorse.

get

Recupera un SecurityHealthAnalyticsCustomModule.

list

Restituisce un elenco di tutte le risorse SecurityHealthAnalyticsCustomModule per l'elemento principale specificato.

listDescendant

Restituisce un elenco di tutte le risorse SecurityHealthAnalyticsCustomModule residenti nella determinata organizzazione, cartella o progetto e in tutti i relativi discendenti.

patch

Aggiorna SecurityHealthAnalyticsCustomModule con il nome specificato in base alla maschera di aggiornamento specificata.

simulate

Simula il risultato dell'utilizzo di un SecurityHealthAnalyticsCustomModule per controllare una risorsa.