Google Cloud Storage è accessibile tramite la funzionalità UrlFetch di App Engine. Di conseguenza, esistono tre fonti di possibili errori:
- Errori temporanei di UrlFetch di App Engine.
- Errori temporanei di Google Cloud Storage.
- Errori di Google Cloud Storage relativi all'autorizzazione di bucket e oggetti.
La libreria client App Engine per Cloud Storage gestisce gli errori di timeout sia lato App Engine sia lato Google Cloud Storage ed esegue automaticamente i tentativi di nuovo accesso, quindi la tua app non deve aggiungere logica per gestire questo problema. La configurazione del meccanismo di timeout e di ripetizione viene esposta tramite la classe RetryParams, che puoi utilizzare per modificare una o tutte le impostazioni predefinite. Puoi
applicare le modifiche a tutte le chiamate di funzione oppure puoi specificare le modifiche per
una chiamata specifica utilizzando il parametro retry_params della funzione.
Errori
La libreria client App Engine per Cloud Storage ha definito le seguenti classi di eccezione di errore:
- cloudstorage.Error
-
La classe di base per tutte le eccezioni in questo pacchetto. Gli errori possono essere generati da App Engine o da Google Cloud Storage. Per informazioni dettagliate sui codici di errore HTTP di Google Cloud Storage, consulta Codici di stato e di errore HTTP nella documentazione di Google Cloud Storage.
- cloudstorage.AuthorizationError
- Google Cloud Storage ha ricevuto una richiesta non autorizzata. Questo errore può verificarsi se un'app autorizzata utilizza un token di accesso scaduto. In genere, questo errore viene gestito automaticamente nella libreria client App Engine per Cloud Storage, che recupera un nuovo token di accesso e riprova a effettuare la richiesta.
- cloudstorage.ForbiddenError
Questo errore (403) indica che l'utente non è stato autorizzato da Google Cloud Storage a effettuare la richiesta.
- Le varie cause possibili di questo errore sono elencate nella documentazione relativa agli errori di Google Cloud Storage per 403-Forbidden.
- Una causa comune di questo errore è che le autorizzazioni del bucket (ACL del bucket) non sono impostate correttamente per consentire all'app di accedere. Per informazioni sulla configurazione dell'accesso, consulta Autenticazione di Google Cloud Storage.
- cloudstorage.NotFoundError
-
Errore HTTP 404. Il bucket o l'oggetto specificato in una chiamata a
cloudstorage.delete(),cloudstorage.listbucket(),cloudstorage.open()ocloudstorage.stat()non esiste. - cloudstorage.TimeoutError
- Questo errore viene generato quando il tentativo di contattare i server Google Cloud Storage scade anche dopo i tentativi di ripetizione. Consulta RetryParams per informazioni su come modificare la gestione del timeout predefinito e i tentativi ripetuti.