Erros e tratamento de erros no Cloud Storage
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Google Cloud Storage é acessado pelo recurso UrlFetch do App Engine. Dessa maneira, existem três origens de erros possíveis:
- Erros temporários UrlFetch do App Engine
- Erros temporários do Google Cloud Storage
- Erros do Google Cloud Storage relacionados a buckets e autorização de objetos
A biblioteca de cliente do App Engine para Cloud Storage lida com erros de tempo limite tanto no App Engine quanto no Google Cloud Storage e realiza novas tentativas automaticamente. Assim, você não precisa adicionar uma lógica ao seu aplicativo para lidar com isso. A configuração do mecanismo de tempo limite e repetição é exposta por meio da classe RetryParams, que você usa para alterar qualquer uma ou todas as configurações padrão. É possível
fazer alterações para aplicar a todas as chamadas de função ou especificar alterações para
uma chamada específica usando o parâmetro retry_params da função.
Erros
A biblioteca de cliente do App Engine para o Cloud Storage conta com as seguintes classes de exceção de erro definidas:
- cloudstorage.Error
-
A classe base de todas as exceções neste pacote. Os erros podem ser gerados pelo App Engine ou pelo Google Cloud Storage. Para detalhes sobre códigos de erro HTTP do Google Cloud Storage, consulte Status HTTP e códigos de erro na documentação do Google Cloud Storage.
- cloudstorage.AuthorizationError
- Uma solicitação não autorizada foi recebida pelo Google Cloud Storage. Esse erro poderá ocorrer se um app autorizado estiver usando um token de acesso expirado. Normalmente, esse erro é tratado automaticamente na biblioteca de cliente do App Engine para o Cloud Storage. Um novo token de acesso é conseguido e a solicitação é executada novamente.
- cloudstorage.ForbiddenError
Esse erro (403) indica que o usuário não foi autorizado pelo Google Cloud Storage a fazer a solicitação.
- cloudstorage.NotFoundError
-
HTTP error 404. O bucket ou objeto especificado em uma chamada para
cloudstorage.delete(), cloudstorage.listbucket(),
cloudstorage.open()
ou cloudstorage.stat() não existe.
- cloudstorage.TimeoutError
-
Esse erro é gerado quando a tentativa de entrar em contato com servidores do Google Cloud Storage atinge o tempo limite, mesmo
após novas tentativas. Consulte
RetryParams
para informações sobre como alterar o processamento e as tentativas de tempo limite padrão.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-04 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
