GET (/sessions/{sessionId}/scids/{scid})

检索这种存储类型的配额信息。 这些 URI 的域是 titlestorage.xboxlive.com

URI 参数

参数 类型 说明
sessionId 字符串 要查找的会话的 ID。
scid guid 要查找的服务配置的 ID。

授权

请求必须包含有效的 Xbox LIVE 授权标头。 如果调用方无权访问此资源,该服务将返回“403 已禁止”响应。 如果标头无效或缺失,该服务将返回“401 未授权”响应。

必需请求标头

标头 说明
x-xbl-contract-version 1 API 协定版本。
授权 XBL3.0 x=[hash];[token] STS 身份验证令牌。 STSTokenString 被身份验证请求返回的令牌替换。 有关检索 STS 令牌和创建授权标头的其他信息,请参阅“对 Xbox LIVE 服务请求进行身份验证和授权”。

请求正文

对象不会在此请求的正文中发送。

HTTP 状态代码

服务返回此部分中的状态代码之一,以响应使用此方法对此资源发出的请求。 对于用于 Xbox Live 服务的标准 HTTP 状态代码的完整列表,请参阅标准 HTTP 状态代码

代码 原因短语 说明
200 OK 请求已成功。
201 Created 实体已创建。
400 无效请求 服务无法理解格式错误的请求。 通常是无效参数。
401 未授权 请求需要用户身份验证。
403 已禁止 用户或服务不允许此请求。
404 未找到 找不到指定资源。
406 不可接受 不支持资源版本。
408 请求超时 请求完成时间太长。
500 内部服务器错误 服务器遇到了阻止它执行请求的意外情况。
503 服务不可用 请求受到限制,请在客户端重试秒数值(例如,5 秒以后)后再次尝试请求。

响应正文

如果调用成功,该服务将返回一个 quotaInfo (JSON) 对象。

示例响应

{
  "quotaInfo":
  {
    "usedBytes":619,
    "quotaBytes":16777216
  }
}
         

另请参阅

父级

/sessions/{sessionId}/scids/{scid}

参考

quotaInfo (JSON)