modulo smp_time

TIPCommon.smp_time.change_timezone

TIPCommon.smp_time.change_timezone(dtime: datetime, current_tz: str, new_tz: str)→ datetime

Modifica il fuso orario di un oggetto datetime.datetime.

Parametri

Parametri
dtime	datetime.datetime L'oggetto datetime il cui fuso orario viene modificato.
current_tz	str Il fuso orario attuale.
new_tz	str Il fuso orario in cui passare.

Restituisce

Un nuovo oggetto datetime con un nuovo fuso orario.

Tipo restituito

datetime.datetime

Rialzi

ValueError: quando uno dei fusi orari non è valido.

TIPCommon.smp_time.convert_string_to_timestamp

TIPCommon.smp_time.convert_string_to_timestamp(datetime_string: str)→ int

Converte una stringa data/ora in un timestamp.

Parametri

Parametri
datetime_string	str Una stringa data/ora.

Restituisce

Il timestamp.

Tipo restituito

int

TIPCommon.smp_time.datetime_to_rfc3339

TIPCommon.smp_time.datetime_to_rfc3339(datetime_obj: datetime)→ str

Converte un oggetto datetime nella rappresentazione RFC 3999.

Parametri

Parametri
datetime_obj	datetime.datetime L'oggetto datetime da convertire.

Restituisce

La rappresentazione RFC 3339 di data e ora.

Tipo restituito

str

TIPCommon.smp_time.get_last_success_time

TIPCommon.smp_time.get_last_success_time(siemplify, offset_with_metric, time_format=2, print_value=True, microtime=False)

Visualizza l'ultima data e ora di esecuzione riuscita.

Parametri
siemplify	obj Un'istanza della classe SiemplifyConnectorExecution dell'SDK.
offset_with_metric	dict La metrica e il valore. Esempio: {'hours': 1}
time_format	int Il formato dell'ora di output. Esempio: DATETIME, UNIX
print_value	Optional bool Indica se stampare il valore o meno. Il valore predefinito è True.
microtime	Optional bool Indica se restituire l'ora Unix, incluso il microsecondo. Il valore predefinito è False.

Restituisce

L'ora dell'ultima operazione riuscita.

Tipo restituito

Time

TIPCommon.smp_time.get_timestamps

TIPCommon.smp_time.get_timestamps(range_string: str, start_time_string: str, end_time_string: str, error_message: str = None, time_in_milliseconds: bool = False)→ tuple[int, int]

Recupera i timestamp dell'ora di inizio e di fine.

Parametri

Parametri
range_string	str La stringa dell'intervallo di tempo.
start_time_string	str L'ora di inizio.
end_time_string	str L'ora di fine.
error_message	str Un messaggio di errore per l'eccezione generata. Il valore predefinito è None.
time_in_milliseconds	bool Definisci se restituire l'ora di inizio e di fine in millisecondi. Il valore predefinito è False.

Restituisce

I timestamp dell'ora di inizio e dell'ora di fine.

Tipo restituito

tuple

TIPCommon.smp_time.get_timestamps_from_range

TIPCommon.smp_time.get_timestamps_from_range(range_string: str, include_timezone: bool = False)→ tuple[datetime, datetime]

Recupera i timestamp dell'ora di inizio e dell'ora di fine da un intervallo.

Parametri

Parametri
range_string	str La stringa dell'intervallo di tempo.
include_timezone	bool, optional Definisci se includere le informazioni sul fuso orario nei timestamp. Il valore predefinito è False.

Restituisce

I timestamp dell'ora di inizio e dell'ora di fine.

Tipo restituito

tuple

TIPCommon.smp_time.is_approaching_action_timeout

TIPCommon.smp_time.is_approaching_action_timeout(action_execution_deadline_in_unix, timeout_threshold_in_sec=10)

Controlla se lo script di azione si sta avvicinando alla scadenza dello script dedicato.

Ogni script di azione ha una scadenza specifica. Questa funzione controlla se l'ora attuale è inferiore alla scadenza di almeno timeout_threshold_in_sec secondi. Il valore predefinito è 10 secondi, il che significa che se l'azione è a 10 secondi o meno dalla scadenza dello script (al momento del controllo), la funzione restituisce True. Se la scadenza viene superata, la funzione restituisce False.

Parametri
action_execution_deadline_in_unix	int La scadenza per l'esecuzione dell'azione.
timeout_threshold_in_sec	int La soglia di timeout in secondi.

Restituisce

True se il timeout è imminente o False in qualsiasi altro caso.

TIPCommon.smp_time.is_approaching_timeout

TIPCommon.smp_time.is_approaching_timeout(connector_starting_time, python_process_timeout, timeout_threshold=0.9)

Controlla se un timeout è imminente.

Parametri
connector_starting_time	int L'ora di avvio del connettore.
python_process_timeout	int La quantità massima di tempo consentita per l'esecuzione del connettore.
timeout_threshold	float La soglia in corrispondenza della quale il connettore viene considerato in avvicinamento a un timeout. Il valore predefinito è TIMEOUT_THRESHOLD.

Restituisce

True se il connettore sta per scadere o False in qualsiasi altro caso.

TIPCommon.smp_time.save_timestamp

TIPCommon.smp_time.save_timestamp(siemplify, alerts, timestamp_key='timestamp', incrementation_value=0, log_timestamp=True, convert_timestamp_to_micro_time=False, convert_a_string_timestamp_to_unix=False)

Salva l'ultimo timestamp per gli avvisi specificati.

Parametri
siemplify	obj Un'istanza della classe SiemplifyConnectorExecution dell'SDK.
alerts	dict L'elenco degli avvisi per trovare l'ultimo timestamp.
timestamp_key	Optional str La chiave per ottenere il timestamp dall'avviso. Il valore predefinito è timestamp.
incrementation_value	Optional int Il valore di incremento dell'ultimo timestamp in millisecondi. Il valore predefinito è 0.
log_timestamp	Optional bool Indica se registrare il timestamp o meno. Il valore predefinito è True.
convert_timestamp_to_micro_time	Optional bool Indica se convertire il timestamp in microsecondi. Il valore predefinito è False.
convert_a_string_timestamp_to_unix	Optional bool Indica se convertire un timestamp stringa in Unix. Il valore predefinito è False.

Restituisce

Un valore booleano che indica se il timestamp è aggiornato.

TIPCommon.smp_time.siemplify_fetch_timestamp

TIPCommon.smp_time.siemplify_fetch_timestamp(siemplify, datetime_format=False, timezone=False)

Recupera il timestamp da Siemplify.

Parametri
siemplify	obj Un'istanza della classe SiemplifyConnectorExecution dell'SDK.
datetime_format	Optional bool Indica se restituire il timestamp nel formato datetime. Il valore predefinito è False.
timezone	Optional bool Indica se restituire il timestamp in un fuso orario UTC. Il valore predefinito è False.

Restituisce

Il timestamp.

TIPCommon.smp_time.siemplify_save_timestamp

TIPCommon.smp_time.siemplify_save_timestamp(siemplify, datetime_format=False, timezone=False, new_timestamp=1696256382032)

Salva il timestamp in Siemplify.

Parametri
siemplify	obj Un'istanza della classe SiemplifyConnectorExecution dell'SDK.
datetime_format	Optional bool Indica se salvare il timestamp in formato datetime. Il valore predefinito è False.
timezone	Optional bool Indica se salvare il timestamp in un fuso orario UTC. Il valore predefinito è False.
new_timestamp	Optional int Il nuovo timestamp da salvare.

Restituisce

Nessuno.

TIPCommon.smp_time.validate_timestamp

TIPCommon.smp_time.validate_timestamp(last_run_timestamp, offset_in_hours, offset_is_in_days=False)

Convalida il timestamp in un intervallo di tempo.

Parametri
last_run_timestamp	datetime Il timestamp dell'ultima esecuzione.
offset_in_hours	int Il limite di tempo in ore.
offset_is_in_days	Optional bool Indica se l'offset è in giorni. Il valore predefinito è False.

Rialzi

ValueError: quando il timestamp non è valido.

Restituisce

Il timestamp convalidato.

Tipo restituito

datetime

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