エラー

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

次のセクションでは、v2 と v1 のリソースメソッドのエラーモデルを説明しています。

v2 リソースエラーモデル

デフォルトで、リソースメソッ状況は 200 オーケーステータスで応答します。リクエストが失敗した場合、Open Cloud は標準のエラーコードを返します。すべてのエラーの応答は、次の形式を含みます:

  • code - HTTP ステータスコードを表示します。
  • message - エラーを説明するメッセージ。
  • details - エラーに関する情報の詳細を含むオブジェクト。
エラーの例

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

コード

次の表では、code の可能な値について説明しています。

コードHTTPステータス説明
INVALID_ARGUMENT400無効な引数、例えば無効な universeId をパスしました。あなたはまた、 Content-Length および Content-Type などの欠落したまたは無効なヘッダーを持つ可能性があります。
PERMISSION_DENIED403あなたのリクエストには、オペレーションを実行するのに十分な権限またはスコープがありません。
NOT_FOUND404データストアのエントリなど、指定されたリソースが見つかりません。
ABORTED409オペレーションは中止されました。
RESOURCE_EXHAUSTED429オペレーションを実行するのに十分なクエートがない場合は、通常、リクエストを送信するためにすぎるようになっています。
CANCELLED499システムは通常、クライアント側の時間切れによりリクエストを終了します。
INTERNAL500サーバーエラーは、通常はサーバーバグによるものです。
NOT_IMPLEMENTED501エラーサーバーは API メソッドを実装していません。
UNAVAILABLE503サービスは利用できません。通常、サーバーがダウンすると返されます。

v1 リソースエラーモデル

すべてのエラーの返信には、同じ、標準的な形式が含まれています。これには以下が含まれます:

  • すべてのオープンクラウドエンドポイントに適用できる高度な原因の error フィールド。
  • 説明的なエラー message 、これはエラーをさらに説明します。
  • errorDetails オブジェクト、各 API に対応するエラーの詳細をカバーします。

エラーのルート原因を分析するには、error フィールドの値と errorDetails フィールドを参照してください。message フィールドをエラー処理の補助として使用することを、2>1> ErrorDetails1> フィールド2> としての4>エラー処理4>、

データストアエラーの例

{
"error": "INVALID_ARGUMENT",
"message": "Invalid cursor.",
"errorDetails": [
{
"errorDetailType": "DatastoreErrorInfo",
"datastoreErrorCode": "InvalidCursor"
}
]
}

エラーの詳細は、error 以下のコーナーに示されています:

すべての注文されたデータストアのエラー返信には、同じ形式が含まれています。これには、次の内容が含まれます:

データストアの注文エラーに対する応答

{
"code": "INVALID_ARGUMENT",
"message": "Invalid cursor."
}

The code は、高度なエラーのストリングを含み、The message は、エラーに関連する特定の詳細を含みます

コード

以下の表に参照して、すべての高度なオープンクラウドエラーの概要をまとめます。

HTTP ステータスコードエラー説明
400無効な引数無効な引数、例えば無効な universeId をパスしました。あなたはまた、 Content-Length および Content-Type などの欠落したまたは無効なヘッダーを持つ可能性があります。
403INSUFFICIENT_SCOPEリクエストには、アクセストークンによって提供されているより高い特権を必要とします。
403PERMISSION_DENIEDあなたのリクエストは、オペレーションを実行するのに十分なスコープを持っていません。
404NOT_FOUNDデータストアなど、指保管されたリソースをシステムが見つけられません。
409中止ユニバースではない場所を公開など、オペレーションが中止されました。
429資源_エクスハウストオペレーションを実行するのに十分なクエートがない場合は、通常、リクエストを送信するためにすぎるようになっています。
499キャンセルシステムは通常、クライアント側の時間切れによりリクエストを終了します。
500内部内部サーバーエラー。通常、サーバーバグです。
501エラー実装されていませんサーバーは API メソッドを実装していません。
503使用不可サービスは利用できません。通常、サーバーはダウンです。