Cloud Storage 오류 및 오류 처리
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Google Cloud Storage는 App Engine UrlFetch
기능에 의해 액세스됩니다. 결과적으로 발생할 수 있는 오류에는 3가지 원인이 있습니다.
- App Engine UrlFetch 일시적인 오류
- Google Cloud Storage 일시적인 오류
- 버킷 및 객체 승인과 관련된 Google Cloud Storage 오류
Cloud Storage용 App Engine 클라이언트 라이브러리는 App Engine 측과 Google Cloud Storage 측 모두에서 시간 초과 오류를 처리하고 자동으로 재시도를 수행하므로, 이를 처리하기 위한 논리를 앱에 추가할 필요가 없습니다. 제한 시간 및 재시도 메커니즘의 구성은 기본 설정의 일부 또는 전부를 변경할 때 사용하는 RetryParams 클래스를 통해 노출됩니다. 모든 함수 호출에 적용하도록 변경하거나 함수의 retry_params
매개변수를 사용하여 특정 호출의 변경사항을 지정할 수 있습니다.
오류
Cloud Storage용 App Engine 클라이언트 라이브러리에는 다음과 같은 오류 예외 클래스가 정의되어 있습니다.
- cloudstorage.Error
-
이 패키지에 있는 모든 예외의 기본 클래스입니다. App Engine 또는 Google Cloud Storage에서 오류가 생성될 수 있습니다. Google Cloud Storage의 HTTP 오류 코드에 대한 자세한 내용은 Google Cloud Storage 문서의 HTTP 상태 및 오류 코드를 참조하세요.
- cloudstorage.AuthorizationError
- Google Cloud Storage에서 승인되지 않은 요청을 받았습니다. 이 오류는 승인된 앱이 만료된 액세스 토큰을 사용하는 경우 발생할 수 있습니다. 일반적으로 이 오류는 자동으로 처리됩니다. Cloud Storage용 App Engine 클라이언트 라이브러리는 이를 위해 새로운 액세스 토큰을 가져오고 요청을 재시도합니다.
- cloudstorage.ForbiddenError
이 오류(403)는 사용자가 Google Cloud Storage에서 요청할 권한을 승인받지 않았음을 나타냅니다.
- cloudstorage.NotFoundError
- HTTP 오류 404.
cloudstorage.delete()
, cloudstorage.listbucket()
, cloudstorage.open()
또는 cloudstorage.stat()
으로의 호출에 지정한 버킷 또는 객체가 없습니다.
- cloudstorage.TimeoutError
-
이 오류는 재시도를 시도했지만 Google Cloud Storage 서버에 연결하려는 시도가 타임아웃되면 발생합니다. 기본 제한 시간 처리 및 재시도 변경에 대한 자세한 내용은 RetryParams를 참조하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-19(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-19(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,[]]