Errores de Cloud Storage y manejo de errores
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
A Google Cloud Storage se accede mediante la característica UrlFetch de App Engine. Como consecuencia, hay tres fuentes de errores posibles:
- Errores transitorios de UrlFetch de App Engine.
- Errores transitorios de Google Cloud Storage.
- Errores de Google Cloud Storage relacionados con los depósitos y la autorización de objetos.
La biblioteca cliente de App Engine para Cloud Storage maneja los errores de tiempo de espera en el lado de App Engine y en el de Google Cloud Storage, y realiza reintentos de forma automática, por lo que tu app no necesita agregar lógica para manejar estos errores. La configuración del tiempo de espera y el mecanismo de reintento se exponen a través de la clase RetryParams, que puedes usar para cambiar alguna o todas las configuraciones predeterminadas. Puedes hacer que tus cambios se apliquen a todas las llamadas de funciones o puedes especificar cambios para una llamada específica con el parámetro retry_params de la función.
Errores
La biblioteca cliente de App Engine para Cloud Storage tiene las siguientes clases de excepciones de error definidas:
- cloudstorage.Error
-
La clase básica para todas las excepciones de este paquete. Los errores se pueden generar desde App Engine o desde Google Cloud Storage. Para obtener más detalles sobre códigos de error de HTTP desde Google Cloud Storage, consulta Códigos de error y de estados de HTTP en la documentación de Google Cloud Storage.
- cloudstorage.AuthorizationError
- Google Cloud Storage recibió una solicitud no autorizada. Este error puede suceder si una aplicación sin autorización usa un token de acceso que expiró. Por lo general, este error se maneja de forma automática en la biblioteca cliente de App Engine para Cloud Storage, que obtiene un nuevo token de acceso y realiza un reintento de la solicitud.
- cloudstorage.ForbiddenError
Este error (403) indica que Google Cloud Storage no autorizó al usuario a realizar la solicitud.
- cloudstorage.NotFoundError
- Error de HTTP 404 El bucket o el objeto que especificaste en una llamada a
cloudstorage.delete(), cloudstorage.listbucket(), cloudstorage.open() o cloudstorage.stat() no existe.
- cloudstorage.TimeoutError
- Este error se genera cuando se agota el tiempo de espera del intento de contactar a los servidores de Google Cloud Storage, incluso después de los reintentos. (Consulta RetryParams para obtener información sobre cómo cambiar el tiempo de espera predeterminado de los controladores y reintentos.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-04 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
