多人游戏会话状态代码

本主题提供请求多人游戏会话时从 Xbox 服务返回的状态代码。

注意

返回会话的 4xx 状态代码始终返回整个会话，即使 URI 指向会话元素。

状态代码	字符串	Content-Type	正文	说明
200	OK	application/json	会话	成功读取 (GET) 或更新 (PUT)。
201	已创建	application/json	会话	成功创建。
202	已接受	text/plain	无	已接受请求，但尚未完成。
204	无内容			在会话的 GET 上，会话不存在。 在会话元素的 GET 上，会话存在，但该元素不存在。 在会话的 PUT 上，会话由于 PUT 操作而被删除。 在会话元素的 PUT 或 DELETE 上，会话在操作开始时存在，但现在会话和元素都不存在。
304	未修改			在带有 If-None-Match 标头的 GET 上，会话未更改。
400	无效的请求	text/plain	消息	请求被假设为在第一次检查时无效。 其缺少必填字段或 JSON 文件格式不正确。 正文包括其他详细信息。
403	已禁止	text/plain	消息	请求在某些上下文中可能有效，但对于其上下文无效。 授权已失败。
		application/json	会话	用户无法更新会话，但可以读取该会话。
404	未找到	text/plain	消息	无法访问会话，因为 URI 无效；找不到句柄、服务配置标识符 (SCID) 或会话模板；找不到漏斗；无法访问某个会话元素，因为相应会话未退出；或元素查找对于会话无效。
405	不允许的方法	text/plain	消息	请求 URI 看似正确，但谓词是错误的。 例如，当需要 PUT 操作时，请求是针对 POST 操作的。
409	冲突	text/plain	消息	无法更新会话，因为该请求与会话不兼容。 例如，请求中的常量与会话或会话模板中的常量冲突，或调用方以外的成员被添加到大型会话或从会话中删除。
412	前置条件失败			无法满足 If-Match 标头或 If-None-Match 标头（对于 GET 以外的操作）的要求。
		application/json	会话	在现有会话的 PUT 或 DELETE 操作上无法满足 If-Match 标头的要求。 返回会话的当前状态以及当前的 ETag 值。
429	请求太多	application/json	消息	由于超出细化速率限制 (FGRL)，服务调用受限。 有关详细信息，请参阅细化速率限制。
503	服务不可用	text/plain	无	服务过载，请求应稍后重试。 此代码包括客户端应服从的 Retry-After 标头。