Erreurs Cloud Storage et leur traitement

Google Cloud Storage est accessible via la fonctionnalité App Engine UrlFetch . 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 App Engine pour Cloud Storage gère les erreurs d'expiration de délai côté App Engine et côté Google Cloud Storage et effectue automatiquement de nouvelles tentatives. Votre application n'a donc pas besoin d'ajouter de logique. 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 appliquer les modifications à tous les appels de fonction ou spécifier les modifications pour un appel spécifique à l'aide du paramètre retry_params de la fonction.

Erreurs

Les classes d'exceptions d'erreur suivantes sont définies pour la bibliothèque cliente App Engine pour Cloud Storage :

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 gérée automatiquement dans la bibliothèque cliente App Engine pour Cloud Storage, qui obtient un nouveau jeton d'accès et tente à nouveau la demande.
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 consacrée à RetryParams pour découvrir comment modifier le traitement du délai d'expiration par défaut et des nouvelles tentatives.