本文导读

展开导读

文档首页/ 云空间服务 KooDrive/ API参考/ API/ 空间管理/ 获取空间分配状况 - GetSpaceAllocation

获取空间分配状况 - GetSpaceAllocation

更新时间：2025-10-21 GMT+08:00

查看PDF

功能介绍

获取一个租户下的各种类型空间的分配量和总量

授权信息

当前API调用无需身份策略权限。

URI

GET /koodrive/ose/v1/space/allocation/get

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
Authorization	是	String	该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token}
X-Traceid	否	String	消息日志跟踪标识（必须58位）
language	否	String	国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语
X-User-Id	是	String	用户id，用于app鉴权
X-Date	是	String	日期，用于app鉴权
Host	是	String	地址，用于app鉴权

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
code	String	错误码
msg	String	错误描述
data	Array of GetSpaceAllocatedData objects	空间分配状况

表3 GetSpaceAllocatedData
参数	参数类型	描述
type	Integer	空间类型
allocateCapacity	Long	已分配的大小，单位GB
totalCapacity	Long	总大小，单位GB

请求示例

获取一个租户下的各种类型空间的分配量和总量

/koodrive/ose/v1/space/allocation/get

Authorization: HMAC-SHA256 AppId=a378331eca141163119eb602adb67b7802cc79cd33ba44c7d2fe61d1586c96a1,SignedHeaders=host;x-date;x-user-id,Signature=bd355f202be40f95bf9510fd7bd48ad711a7d144c01df07d515ee0fbf3a47416
X-User-Id: 1505084218764547200
Host: 10.32.45.165
X-Date: 20240909T033325Z

响应示例

状态码：200

获取空间分配状况

{
  "data" : {
    "type" : "0",
    "allocateCapacity" : "1000",
    "totalCapacity" : "2000"
  },
  "code" : 0,
  "msg" : "操作成功。"
}

状态码


状态码	描述
200	获取空间分配状况

父主题： 空间管理

上一篇：获取空间信息 - GetSpaceV2

下一篇：空间分配 - TransferUnallocatedSpace

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消