傳回工作階段的 4xx 狀態碼一律會傳回整個工作階段，即使 URI 指向的是工作階段元素也一樣。
多人遊戲工作階段狀態碼
要求或更新 MPSD 多人遊戲工作階段時，XBOX 服務所傳回之 HTTP 狀態碼的參考表格，包含回應本文與意義。
本主題提供要求多人遊戲工作階段時，XBOX 服務所傳回的狀態碼。
| 狀態碼 | 字串 | Content-Type | 本文 | 說明 |
|----|
| 200 | OK | application/json | 工作階段 | 已成功讀取 (GET) 或更新 (PUT)。 |
| 201 | Created | application/json | 工作階段 | 已成功建立。 |
| 202 | Accepted | text/plain | 無 | 已接受要求，但尚未完成。 |
| 204 | No content | | | 對工作階段執行 GET 時，表示工作階段不存在。對工作階段元素執行 GET 時，表示工作階段存在但元素不存在。對工作階段執行 PUT 時，表示工作階段因 PUT 作業而被刪除。對工作階段元素執行 PUT 或 DELETE 時，表示作業開始時工作階段存在，但現在工作階段與元素都不存在。 |
| 304 | Not modified | | | 使用 If-None-Match 標頭執行 GET 時，表示工作階段未變更。 |
| 400 | Bad request | text/plain | 訊息 | 初步檢查時即判定要求無效。要求缺少必要欄位，或 JSON 檔案格式不正確。本文包含其他詳細資料。 |
| 403 | Forbidden | text/plain | 訊息 | 要求在某些內容中可能有效，但在其目前內容中無效。授權失敗。 |
| | | application/json | 工作階段 | 使用者無法更新工作階段，但可以讀取。 |
| 404 | Not found | text/plain | 訊息 | 由於下列原因而無法存取工作階段：URI 無效；找不到控制代碼、服務設定識別碼 (SCID) 或工作階段範本；找不到 hopper；由於工作階段不存在而無法存取工作階段元素；或元素查詢對該工作階段無效。 |
| 405 | Method not allowed | text/plain | 訊息 | 要求 URI 看似合理，但動詞錯誤。例如，需要 PUT 作業時要求的卻是 POST 作業。 |
| 409 | Conflict | text/plain | 訊息 | 由於要求與工作階段不相容，因此無法更新工作階段。例如，要求中的常數與工作階段或工作階段範本中的常數衝突，或是在大型工作階段中新增或移除了呼叫者以外的成員。 |
| 412 | Precondition failed | | | 無法滿足 If-Match 標頭或 If-None-Match 標頭 (適用於 GET 以外的作業)。 |
| | | application/json | 工作階段 | 對現有工作階段執行 PUT 或 DELETE 作業時，無法滿足 If-Match 標頭。會傳回工作階段的目前狀態以及目前的 ETag 值。 |
| 429 | Too many requests | application/json | 訊息 | 由於超過細部速率限制 (FGRL) 的限制，服務呼叫已遭到節流。如需詳細資訊，請參閱細部速率限制。 |
| 503 | Service unavailable | text/plain | 無 | 服務超載，應稍後重試要求。此狀態碼包含用戶端應遵守的 Retry-After 標頭。 |
最後修改於 2026年10月8日