錯誤

以下部分分別描述 v2 和 v1 資源方法的錯誤模型。

v2資源錯誤模型

預設情況下，資源方法會回應以 200 狀態 OK。當請求失敗時，Open Cloud 返回標準錯誤代碼。所有錯誤回應的格式相同，包括：

• code - 代表 HTTP 狀態碼。
• message - 一個解釋錯誤的訊息。
• details - 包含更多與錯誤相關的資訊的對象。

範例錯誤
{
  "code": "INVALID_ARGUMENT",
  "message": "The provided filter is invalid.",
  "details": [
    {
      ...
    }
  ]
}

代碼

下表描述了 code 的可能值。

v1資源錯誤模型

所有錯誤回應都擁有相同、標準格式，包括：

• 一個 error 欄位，這是一個適用於所有開放雲端端點的高級原因。
• 一個說明錯誤 message , 進一步解釋錯誤。
• 一個 errorDetails 物件，涵蓋每個 API 特定的錯誤的更多信息。

要分析錯誤的根本原因，請參考 error 欄位的值和 errorDetails 欄位的值。使用 message 字段作為錯誤處理的補充，因為有時它可能不會覆蓋與 errorDetails 字段相同的細節水平。

範例標準資料儲存錯誤回應
{
  "error": "INVALID_ARGUMENT",
  "message": "Invalid cursor.",
  "errorDetails": [
    {
      "errorDetailType": "DatastoreErrorInfo",
      "datastoreErrorCode": "InvalidCursor"
    }
  ]
}

示例錯誤回應顯示高級Open Cloud 為 、錯誤 為 、以及 專門用於 數據存儲 的 。從回應的 error 和 datastoreErrorCode 欄位中，您可以理解到您傳送了一個無效的鼠標參數，導致發生錯誤。您可以然後修正鼠標參數來解決問題。

所有命令的數據儲存錯誤回應的格式相同，包括：

範例命名數據儲存錯誤回應
{
  "code": "INVALID_ARGUMENT",
  "message": "Invalid cursor."
}

code 將包含高級錯誤的字串，而 message 將包含與錯誤相關的特定細節

代碼

參考下表的所有高級開放雲錯誤的摘要。