如果您在使用對話式數據分析 API 時遇到問題,請參閱下表,瞭解可能的解決方案。
| 錯誤 | 錯誤原因 | HTTP 狀態碼 | gRPC 狀態碼 | 解析度 |
AlreadyExistsException
|
ALREADY_EXISTS
|
409 Conflict
|
6 | 資源已存在 (例如您正在建立重複的項目)。請使用其他 ID,或確認資源不存在後再建立。 |
BadRequestException
|
INVALID_ARGUMENT
|
400 Bad Request
|
3 | 輸入內容無效或格式錯誤。請先驗證輸入內容或酬載,再傳送要求。 |
BadRequestException (搜尋範圍) |
INVALID_ARGUMENT |
400 Bad Request |
3 |
要求中的 BigQuery 搜尋範圍無效。如要修正錯誤,請按照收到的錯誤訊息指示操作:
|
ForbiddenException
|
PERMISSION_DENIED
|
403 Forbidden
|
7 | 您已通過驗證,但無法存取資源。請檢查使用者角色和權限。如有需要,請與管理員聯絡。 |
PermissionDenied (組織政策) |
PERMISSION_DENIED |
403 Forbidden |
7 | 要求違反組織政策限制,例如位置限制或 CMEK 規定。查看回應主體中的錯誤訊息,找出違反的限制。詳情請參閱「排解違反政策的問題」。 |
FailedPreconditionException
|
FAILED_PRECONDITION
|
400 Bad Request
|
9 | 要求違反系統狀態 (例如嘗試刪除非空白資料夾)。檢查前置條件並修正邏輯。 |
NotFoundException
|
NOT_FOUND
|
404 Not Found
|
5 | 找不到資源。驗證資源 ID 或網址。嘗試存取資源前,請先確認資源存在。 如需更多疑難排解資訊,請參閱對話式數據分析 API 常見問題。 |
ServiceUnavailableException
|
UNAVAILABLE
|
503 Service Unavailable
|
14 | 伺服器發生暫時性問題,請稍後再試,並在每次嘗試之間採用指數輪詢。如果錯誤仍未解決,請提交錯誤報告。 |
Connection reset by peer (串流期間)
|
UNAVAILABLE
|
503 Service Unavailable
|
14 |
如果您使用標準 HTTP 或 REST 用戶端呼叫串流 建議您使用官方 Google Cloud gRPC 用戶端程式庫 (例如 Python SDK) 呼叫串流端點。這些程式庫會剖析結尾標頭,並顯示真正的錯誤原因。 |
Internal error encountered (串流期間)
|
INTERNAL
|
500 Internal Server Error
|
13 |
如果您使用標準 HTTP 或 REST 用戶端呼叫串流 建議您使用官方 Google Cloud gRPC 用戶端程式庫 (例如 Python SDK) 呼叫串流端點。這些程式庫會剖析結尾標頭,並顯示真正的錯誤原因。 |
UnauthenticatedException
|
UNAUTHENTICATED
|
401 Unauthorized
|
16 | 需要驗證,或驗證失敗。確認您使用的是正確的登入憑證、API 金鑰或權杖。 |
UnimplementedException
|
UNIMPLEMENTED
|
501 Not Implemented
|
12 | 要求的功能無法使用或不支援。請避免呼叫這個 API,或等待實作。 |
其他資源
如需其他疑難排解提示和常見問題解答,請參閱「對話式數據分析 API 常見問題」頁面。
如需有效向 對話式數據分析 API 提問的指引,請參閱「提出有效問題」說明文件頁面。