RetryParams
è fornito dalla libreria client di App Engine per Cloud Storage contenuta in src/cloudstorage
. Questa classe consente di modificare le impostazioni predefinite utilizzate per gestire i timeout e i nuovi tentativi.
Introduzione
La libreria client di App Engine per Cloud Storage utilizza le impostazioni predefinite per la gestione dei timeout e dei nuovi tentativi durante i tentativi di contattare i server di Google Cloud Storage.
Questa classe ti consente di modificare queste impostazioni a livello di applicazione o per una chiamata specifica a una funzione di libreria (copy2
, delete
, listbucket
, open
, stat
). Devi modificare solo l'impostazione specifica che ti interessa, poiché tutte le altre impostazioni vengono conservate, a meno che non vengano sovrascritte esplicitamente. Ogni istanza RetryParams
è univoca per thread e per richiesta.
Per modificare un'impostazione predefinita a livello di applicazione, puoi creare un oggetto RetryParams
, specificare le impostazioni che vuoi modificare e fornire questo oggetto alla funzione cloudstorage.set_default_retry_params()
nel seguente modo:
my_default_retry_params = cloudstorage.RetryParams(initial_delay=0.2,
max_delay=5.0,
backoff_factor=2,
max_retry_period=15)
cloudstorage.set_default_retry_params(my_default_retry_params)
Per modificare le impostazioni predefinite solo per la chiamata di una funzione specifica, crea un oggetto RetryParams
e forniscilo direttamente alla funzione nel relativo parametro retry_params
, come segue:
write_retry_params = cloudstorage.RetryParams(backoff_factor=1.1)
gcs_file = cloudstorage.open(filename,
'w',
content_type='text/plain',
options={'x-goog-meta-foo': 'foo',
'x-goog-meta-bar': 'bar'},
retry_params=write_retry_params)
Ciò non ha effetto sulle impostazioni predefinite utilizzate dall'app o da altre chiamate di funzioni.
Proprietà istanza
Un'istanza RetryParams
ha le seguenti proprietà:
- initial_delay
- Il numero di secondi di ritardo prima di un nuovo tentativo. Il valore predefinito è
0.1
. Il ritardo consente di distribuire il carico sul server di Google Cloud Storage. - backoff_factor
- Il moltiplicatore di backoff esponenziale, utilizzato per determinare la velocità di elaborazione ottimale. Il valore predefinito è
2.0
. Per una descrizione e i suggerimenti per l'impostazione di questo valore, consulta la documentazione di Google Cloud Storage sul backoff. - max_delay
- Il numero massimo di secondi di attesa tra un nuovo tentativo e l'altro. Il valore predefinito è
10.0
. - min_retries
- Il numero minimo di tentativi consentiti. Il valore predefinito è
3
. - max_retries
- Il numero massimo di tentativi consentiti. Imposta questo valore su 0 se
non vuoi riprovare. Il valore predefinito è
6
. - max_retry_period
- Il numero massimo di secondi che può essere speso per tutti i nuovi tentativi di una determinata richiesta. Il valore predefinito è
30.0
. Riprova una volta trascorso questo periodo E è stato effettuato un tentativo dimin_retries
. - urlfetch_timeout
- Il numero di secondi di attesa prima che UrlFetch contatti i server di Google Cloud Storage prima di restituire un errore di timeout. Il valore predefinito è
None
, il che significa che viene utilizzata la scadenza predefinita di UrlFetch, che è di cinque secondi. Puoi impostarlo su qualsiasi valore fino a un massimo di 60 secondi.