Erreurs Cloud Storage et leur traitement
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThe App Engine client library for Cloud Storage handles timeout errors and retries automatically, eliminating the need for manual handling in your app.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eRetryParams\u003c/code\u003e class allows customization of timeout and retry settings, which can be applied globally or to specific function calls.\u003c/p\u003e\n"],["\u003cp\u003eErrors related to Google Cloud Storage access can stem from transient issues, or from bucket and object authorization, in addition to transient errors coming from App Engine \u003ccode\u003eUrlFetch\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecloudstorage\u003c/code\u003e library defines exception classes like \u003ccode\u003eError\u003c/code\u003e, \u003ccode\u003eAuthorizationError\u003c/code\u003e, \u003ccode\u003eForbiddenError\u003c/code\u003e, \u003ccode\u003eNotFoundError\u003c/code\u003e, and \u003ccode\u003eTimeoutError\u003c/code\u003e to handle various error scenarios.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eForbiddenError\u003c/code\u003e (403) is common when the bucket permissions (bucket ACL) are not configured properly to allow access from the application.\u003c/p\u003e\n"]]],[],null,["# Cloud Storage Errors and Error Handling\n\nGoogle Cloud Storage is accessed by the App Engine ` UrlFetch ` feature. As a result,\nthere are three sources of possible errors:\n\n- App Engine UrlFetch transient errors.\n- Google Cloud Storage transient errors.\n- Google Cloud Storage errors related to buckets and object authorization.\n\nThe App Engine client library for Cloud Storage handles timeout errors on both the App Engine side and\nthe Google Cloud Storage side and performs retries automatically, so your app does not need to\nadd logic to handle this. The configuration of the timeout and retry mechanism\nis exposed through the [RetryParams](/appengine/docs/legacy/standard/python/googlecloudstorageclient/retryparams_class)\nclass, which you can use to change any or all of the default settings. You can\nmake your changes to apply to all function calls or you can specify changes for\na specific call using the function's `retry_params` parameter.\n\nErrors\n------\n\nThe App Engine client library for Cloud Storage has the following error exception classes defined:\n\ncloudstorage.Error\n\n: The base class for all exceptions in this package. Errors can be\n generated from App Engine or from Google Cloud Storage. For details on HTTP\n error codes from Google Cloud Storage, see\n [HTTP Status and Error\n Codes](/storage/docs/reference-status#standardcodes) in the Google Cloud Storage documentation.\n\ncloudstorage.AuthorizationError\n: An unauthorized request was received by Google Cloud Storage. This error can occur if an\n authorized app is using an access token that has expired. Normally, this error\n is handled automatically in the App Engine client library for Cloud Storage, which gets a new access token\n and retries the request.\n\ncloudstorage.ForbiddenError\n\n: This error (403) indicates that the user was not authorized by Google Cloud Storage to\n make the request.\n\n - The various possible causes for this error are listed in the [Google Cloud Storage error\n documentation](/storage/docs/reference-status#standardcodes) for **403-Forbidden**.\n - A common source of this error is that the bucket permissions (bucket ACL) are not set properly to allow your app access. See [Google Cloud Storage Authentication](/storage/docs/authentication) for information on setting up access.\n\n \u003cbr /\u003e\n\ncloudstorage.NotFoundError\n:\n HTTP error 404. The bucket or object you specified in a call to\n `cloudstorage.delete()`, `cloudstorage.listbucket()`,\n `cloudstorage.open()`,\n or `cloudstorage.stat()` does not exist.\n\ncloudstorage.TimeoutError\n:\n This error is raised when the attempt to contact Google Cloud Storage servers times out even\n after retry attempts. (See\n [RetryParams](/appengine/docs/legacy/standard/python/googlecloudstorageclient/retryparams_class)\n for information on changing the default timeout handling and retries."]]
