疑難排解

本頁包含下列各版本 Service Infrastructure API 的疑難排解資訊:

  • Service Management API
  • Service Control API
  • Service Consumer Management API

Service Control API 錯誤通常該如何處理?

Service Control API 為代管服務提供控制層功能,例如記錄和監控服務。因此,Service Control API 的呼叫端通常為伺服器應用程式。以下是對於 REST/RPC API 層級錯誤的一般處理建議:

  • 您的伺服器應記錄 Service Control API 傳回的所有錯誤,您可以使用這項資料排解代管服務的問題。
  • 如果您的伺服器從 Service Control API 收到 429 錯誤,應向用戶端傳回 429 錯誤。
  • 如果您的伺服器無法存取 Service Control API,可以選擇失效開放 (忽略錯誤) 或失效關閉 (向用戶端傳回 503)。
  • 如果您的伺服器從 Service Control API 收到 500 錯誤,應向用戶端傳回 500 錯誤。這類錯誤一般表示 Service Control API 發生錯誤。
  • 如果您的伺服器從 Service Control API 收到其他錯誤,應向用戶端傳回 500 錯誤。這類錯誤一般表示代管服務發生錯誤。

「服務未啟用」錯誤是什麼意思?

如要使用任何 Google API 服務,您必須擁有 Google Cloud 專案、為該專案啟用服務,並為每個 API 要求傳送與專案相關聯的 API 金鑰或 OAuth 存取權杖。詳情請參閱驗證指南。如要修正這項錯誤,請使用 Google Cloud 控制台、Google Cloud CLI 或 Service Usage API,為專案啟用這項服務。如要瞭解如何啟用服務,請參閱「啟用及停用服務」。

如何修正「權限遭拒」錯誤?

一般來說,這類錯誤代表呼叫者沒有特定資源的合適 Identity and Access Management 權限。如需下列 Service Infrastructure API 所要求權限的相關資訊,請參閱相應的存取權管控頁面:

如何在發生 API 錯誤時進行重試?

建議您隨機以指數性間隔進行重試。429 配額錯誤的最小重試間隔應為 30 秒;500503 伺服器錯誤則為 1 秒。其他錯誤的重試間隔應以額外錯誤資訊為準。詳情請參閱 google.rpc.Code

如何要求更高的 API 配額?

如要瞭解如何針對下列 Service Infrastructure API 申請更高的配額,請造訪配額與限制頁面並參閱以下各節說明:

如何修正「無法驗證網域名稱的擁有權」錯誤?

這項錯誤表示針對服務設定中指定的代管服務名稱,呼叫端沒有其所用網域名稱的擁有權。請依照這份指南的指示使用有效的網域。