modulo smp_io

TIPCommon.smp_io.read_and_repair_existing_ids

TIPCommon.smp_io.read_and_repair_existing_ids(siemplify: SiemplifyAction | SiemplifyConnectorExecution | SiemplifyJob, default_value_to_return: dict = None, identifier: str = None, ids_file_name: str = 'ids.json', db_key: str = 'ids')→ list

Legge gli ID avviso esistenti e li converte in un elenco se sono un dizionario. Questo è necessario per evitare regressioni.

Parametri

Parametri
siemplify SiemplifyAction | SiemplifyConnectorExecution | SiemplifyJob

Un'istanza dell'SDK Google Security Operations SOAR.

default_value_to_return dict | list | string

Il valore predefinito da impostare quando viene creato un nuovo file o una nuova chiave. Se non viene fornito alcun valore, verrà impostato un valore predefinito interno di [] (list) come nuovo valore predefinito.

identifier str

L'attributo identificatore del connettore.

ids_file_name str

Il nome del file in cui devono essere salvati gli ID quando è stato creato un oggetto FileStream.

db_key str

Il nome della chiave in cui devono essere salvati gli ID quando è stato creato un oggetto FileStream.

Restituisce

Un elenco di ID all'interno dell'oggetto DataStream.

Tipo restituito

list

TIPCommon.smp_io.read_content

TIPCommon.smp_io.read_content(siemplify, file_name, db_key, default_value_to_return=None, identifier=None)

Legge il contenuto di un oggetto ConnectorStream. Se l'oggetto non contiene dati o non esiste, restituisci un valore predefinito.

Parametri
siemplify obj

Un'istanza della classe SiemplifyConnectorExecution dell'SDK.

file_name str

Il nome del file da convalidare (quando la piattaforma utilizza i file).

db_key str

Il nome della chiave da convalidare (quando la piattaforma utilizza un database).

default_value_to_return dict/list/str

Il valore predefinito impostato quando vengono creati nuovi file e chiavi. Se non viene fornito alcun valore, viene impostato un valore predefinito interno di {} (dict) come nuovo valore predefinito.

identifier str

L'attributo identificatore del connettore.

Restituisce

(dict) I contenuti all'interno dell'oggetto DataStream. I contenuti passano attraverso json.loads prima di essere restituiti.

TIPCommon.smp_io.read_ids

TIPCommon.smp_io.read_ids(siemplify, default_value_to_return=None, identifier=None, ids_file_name='ids.json', db_key='ids')

Legge gli ID da un oggetto ConnectorStream. Se l'oggetto non contiene dati o non esiste, restituisci un valore predefinito.

Parametri
siemplify obj

Un'istanza della classe SiemplifyConnectorExecution dell'SDK.

ids_file_name sttr

Il nome del file in cui salvare gli ID quando è stato creato un oggetto FileStream.

db_key str

Il nome della chiave in cui devono essere salvati gli ID quando è stato creato un oggetto FileStream.

default_value_to_return dict/list/str

Il valore predefinito da impostare nel caso in cui vengano creati nuovi file e chiavi. Se non viene fornito alcun valore, viene impostato un valore predefinito interno [] (list) come nuovo valore predefinito.

identifier str

L'attributo identificatore del connettore.

Restituisce

(list) Un elenco di ID all'interno dell'oggetto DataStream. I contenuti passano attraverso json.loads prima di essere restituiti.

TIPCommon.smp_io.read_ids_by_timestamp

TIPCommon.smp_io.read_ids_by_timestamp(siemplify, offset_in_hours=72, default_value_to_return=None, convert_to_milliseconds=False, cast_keys_to_integers=False, offset_is_in_days=False, identifier=None, ids_file_name='ids.json', db_key='ids')

Legge gli ID da un oggetto ConnectorStream. Se l'oggetto non contiene dati o non esiste, restituisci un valore predefinito.

Parametri
siemplify obj

Un'istanza della classe SiemplifyConnectorExecution dell'SDK.

offset_in_hours int

Il limite di tempo (valore di offset) dell'ID in ore.

convert_to_milliseconds bool

Trasforma il timestamp (Unix) di ogni ID da secondi a millisecondi.

cast_keys_to_integers bool

Esegui il cast delle chiavi in numeri interi.

offset_is_in_days bool

Se l'offset fornito a questo metodo è in giorni, imposta il parametro su True per convertire i giorni di offset in ore.

ids_file_name str

Il nome del file in cui salvare gli ID quando è stato creato un oggetto FileStream.

db_key str

Il nome della chiave in cui devono essere salvati gli ID quando è stato creato un oggetto FileStream.

default_value_to_return dict/list/str

Il valore predefinito da impostare nel caso in cui vengano creati nuovi file e chiavi.

identifier str

L'attributo identificatore del connettore.

Restituisce

(list) Un elenco di ID all'interno dell'oggetto DataStream. I contenuti passano attraverso json.loads prima di essere restituiti.

TIPCommon.smp_io.write_content

TIPCommon.smp_io.write_content(siemplify, content_to_write, file_name, db_key, default_value_to_set=None, identifier=None)

Scrive i contenuti in un oggetto ConnectorStream.

Parametri
siemplify obj

Un'istanza della classe SiemplifyConnectorExecution dell'SDK.

content_to_write dict/list/str

I contenuti da scrivere nel stream di dati dedicato.

file_name str

Il nome del file.

db_key str

Il nome della chiave.

default_value_to_set dict/list/str

Il valore predefinito impostato quando vengono creati nuovi file e chiavi.

identifier str

L'attributo identificatore del connettore.

Restituisce

Nessuno.

TIPCommon.smp_io.write_ids

TIPCommon.smp_io.write_ids(siemplify, ids, default_value_to_set=None, stored_ids_limit=1000, identifier=None, ids_file_name='ids.json', db_key='ids')

Scrive gli ultimi 1000 ID in un oggetto ConnectorStream.

Parametri
siemplify obj

Un'istanza della classe SiemplifyConnectorExecution dell'SDK.

ids list/str

Gli ID da scrivere nello stream di dati dedicato.

stored_ids_limit int

Il numero di ID recenti tra gli ID esistenti che verranno scritti.

ids_file_name str

Il nome del file in cui salvare gli ID quando è stato creato un oggetto FileStream.

db_key str

Il nome della chiave in cui devono essere salvati gli ID quando è stato creato un oggetto FileStream.

default_value_to_set dict/list/str

Il valore predefinito impostato quando vengono creati nuovi file e chiavi.

identifier str

L'attributo identificatore del connettore.

Restituisce

Nessuno.

TIPCommon.smp_io.write_ids_with_timestamp

TIPCommon.smp_io.write_ids_with_timestamp(siemplify, ids, default_value_to_set=None, identifier=None, ids_file_name='ids.json', db_key='ids')

Scrive gli ID in un oggetto ConnectorStream con un timestamp.

Parametri
siemplify obj

Un'istanza della classe SiemplifyConnectorExecution dell'SDK.

ids list/str

Gli ID da scrivere nello stream di dati dedicato.

ids_file_name str

Il nome del file in cui salvare gli ID quando è stato creato un oggetto FileStream.

db_key str

Il nome della chiave in cui devono essere salvati gli ID quando è stato creato un oggetto FileStream.

default_value_to_set dict/list/str

Il valore predefinito da impostare nel caso in cui vengano creati nuovi file e chiavi.

identifier str

L'attributo identificatore del connettore.

Restituisce

Nessuno.

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.