本頁包含下列各版本 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 秒;500
和 503
伺服器錯誤則為 1 秒。其他錯誤的重試間隔應以額外錯誤資訊為準。詳情請參閱 google.rpc.Code
。
如何要求更高的 API 配額?
如要瞭解如何針對下列 Service Infrastructure API 申請更高的配額,請造訪配額與限制頁面並參閱以下各節說明:
如何修正「無法驗證網域名稱的擁有權」錯誤?
這項錯誤表示針對服務設定中指定的代管服務名稱,呼叫端沒有其所用網域名稱的擁有權。請依照這份指南的指示使用有效的網域。