Le librerie client di Cloud per Rust possono riprovare automaticamente le operazioni che non vanno a buon fine a causa di errori temporanei. Questo documento mostra come configurare una policy di ripetizione dei tentativi predefinita su un client, impostare i limiti di tempo e di tentativi ed eseguire l'override della policy di ripetizione dei tentativi per le singole richieste.
Prima di iniziare
Gli esempi in questo documento utilizzano Secret Manager, anche se gli stessi concetti si applicano ad altri servizi Google Cloud .
Prima di eseguire il codice in questo documento, segui Crea e accedi a un secret utilizzando Secret Manager per abilitare l'API Secret Manager e configurare l'autenticazione.
Dipendenze
Aggiungi i crate richiesti al file Cargo.toml:
cargo add google-cloud-secretmanager-v1 google-cloud-gax anyhow
Configura una policy di ripetizione dei tentativi predefinita
Questo esempio utilizza la policy Aip194Strict, che implementa le linee guida in AIP-194 per i nuovi tentativi di richieste API di Google.
Per configurare Aip194Strict come policy di ripetizione predefinita per un client, completa i seguenti passaggi:
Imposta la policy di ripetizione durante l'inizializzazione del client:
Invia richieste utilizzando il client configurato:
Codice completo per una policy di ripetizione predefinita
L'esempio seguente applica Aip194Strict a un client Secret Manager:
Configura una policy di ripetizione predefinita con limiti
Per impostazione predefinita, Aip194Strict non limita il numero di tentativi o il tempo totale impiegato per i nuovi tentativi. Per configurare i limiti di tentativi e di tempo su un client, porta il tratto RetryPolicyExt nell'ambito e completa i seguenti passaggi:
Configura la policy di ripetizione con
with_attempt_limitewith_time_limitsul generatore di client:Invia richieste utilizzando il client configurato:
Codice completo per una policy di ripetizione con limiti
L'esempio seguente applica Aip194Strict con limiti di tempo e tentativi personalizzati:
Esegui l'override della policy di ripetizione per una singola richiesta
Puoi eseguire l'override della policy di ripetizione su una singola richiesta quando sai che la ripetizione di un'operazione specifica è sicura per la tua applicazione. Ad esempio, l'eliminazione di un secret può riuscire al massimo una volta, anche se la libreria client tratta le operazioni di eliminazione come non idempotenti per impostazione predefinita.
Inserisci RequestOptionsBuilder, RetryPolicyExt e AlwaysRetry nell'ambito,
quindi chiama with_retry_policy sul generatore di richieste:
Codice completo per una policy di ripetizione per richiesta
L'esempio seguente esegue l'override della policy per i nuovi tentativi, del limite di tentativi e del limite di tempo per una singola richiesta delete_secret: