構造化エラー返信
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
適切なメッセージとログを許可するために、Key Access Control List Service（KACLS）は
オペレーションが失敗すると、構造化 JSON 応答が本文で返されます。
標準の HTTP ステータス コードが使用されます。
| JSON 表現 |
{
"code": int,
"message": string,
"details": string
}
|
| フィールド |
code |
int
標準の HTTP ステータス コード
|
message |
string (UTF-8)
人が読める形式のエラー メッセージ。
|
details |
string (UTF-8)
スタック トレースなど、エラーの詳細。
|
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eKACLS operation failures now return structured JSON responses for improved debugging.\u003c/p\u003e\n"],["\u003cp\u003eThese JSON responses include an HTTP status code, a human-readable message, and detailed error information.\u003c/p\u003e\n"],["\u003cp\u003eThis structure facilitates easier integration with automated systems and provides developers with more context for troubleshooting.\u003c/p\u003e\n"]]],["KACLS operation failures now return a structured JSON response in the body, using standard HTTP status codes. The JSON format includes three fields: `code` (an integer representing the HTTP status), `message` (a human-readable error string), and `details` (a string providing further information like a stack trace). This structured format improves the quality of error messages and logs.\n"],null,["# Structured error replies\n\nTo allow better messages and logs, the Key Access Control List Service (KACLS)\noperation failures returns a structured JSON reply in the body.\nThe standard HTTP status codes are used.\n\n| JSON representation ||\n|---------------------------------------------------------------|---|\n| ``` { \"code\": int, \"message\": string, \"details\": string } ``` |\n\n| Fields ||\n|-----------|-----------------------------------------------------------------------|\n| `code` | `int` Standard HTTP status code |\n| `message` | `string (UTF-8)` A human readable error message. |\n| `details` | `string (UTF-8)` More details about the error, such as a stack trace. |"]]
