Erreurs Google Cloud Storage et traitement

L'accès à Google Cloud Storage s'effectue via la fonctionnalité UrlFetch d'App Engine. Par conséquent, il existe trois sources d'erreurs possibles :

  • Erreurs transitoires du service de récupération d'URL d'App Engine
  • Erreurs transitoires Google Cloud Storage
  • Erreurs Google Cloud Storage liées aux buckets et aux autorisations relatives aux objets

La bibliothèque cliente Google Cloud Storage traite les erreurs d'expiration de délai du côté d'App Engine et de Cloud Storage, et effectue automatiquement de nouvelles tentatives. Ainsi, votre application n'a pas besoin d'ajouter une logique pour gérer cet aspect. La configuration du délai d'expiration et du système de tentatives est exposée via la classe RetryParams, qui permet de modifier une partie ou l'ensemble des paramètres par défaut. Vous pouvez apporter des modifications à tous les appels de fonctions ou définir des modifications pour un appel spécifique à l'aide du paramètre retry_params de la fonction.

Erreurs

La bibliothèque cliente Google Cloud Storage définit les classes d'exception d'erreur suivantes :

cloudstorage.Error

Classe de base destinée à toutes les exceptions de ce package. Les erreurs peuvent être générées à partir d'App Engine ou de Google Cloud Storage. Pour en savoir plus sur les codes d'erreur HTTP de Google Cloud Storage, consultez la section État HTTP et codes d'erreur dans la documentation de Google Cloud Storage.

cloudstorage.AuthorizationError
Google Cloud Storage a reçu une requête non autorisée. Cette erreur peut se produire si une application autorisée utilise un jeton d'accès expiré. Normalement, cette erreur est automatiquement traitée dans la bibliothèque cliente Google Cloud Storage, qui génère un nouveau jeton d'accès et réessaie d'exécuter la requête.
cloudstorage.ForbiddenError

Cette erreur (403) indique que Google Cloud Storage n'a pas autorisé l'utilisateur à effectuer la requête.

  • Les causes possibles de cette erreur sont répertoriées dans la section 403-Forbidden de la documentation sur les erreurs Google Cloud Storage.
  • Cette erreur survient généralement lorsque les autorisations relatives au bucket (LCA du bucket) ne sont pas correctement définies pour accorder l'accès à votre application. Consultez la page Authentification Cloud Storage pour en savoir plus sur la configuration des accès.

cloudstorage.NotFoundError
Erreur HTTP 404. Le bucket ou l'objet que vous avez spécifié dans un appel à cloudstorage.delete(), cloudstorage.listbucket(), cloudstorage.open() ou cloudstorage.stat() n'existe pas.
cloudstorage.TimeoutError
Cette erreur se produit lorsque la tentative de contact des serveurs Google Cloud Storage expire, même après de nouvelles tentatives. Consultez la documentation relative à RetryParams pour découvrir comment modifier le traitement du délai d'expiration par défaut et des nouvelles tentatives.
Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Environnement standard App Engine pour Python