GET (/json/users/xuid({xuid})/scids/{scid})
检索这种存储类型的配额信息。
这些 URI 的域是 titlestorage.xboxlive.com
。
URI 参数
参数 | 类型 | 说明 |
---|---|---|
xuid | 64 位无符号整数 | 正在发起请求的玩家的 Xbox 用户 ID (XUID)。 |
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 对象。
示例响应
{
"quotaInfo" :
{
"usedBytes" : 619,
"quotaBytes" : 16777216
}
}
另请参阅
父级
/json/users/xuid({xuid})/scids/{scid}