获取盘列表

适用版本>=v7.0.2412a.20241212

接口说明：获取驱动盘列表

请求说明

请求地址	配置域名+/openapi+/v7/drives
请求方法	GET
签名方式	KSO-1（配置域名+/openapi不参与签名）
权限要求	管理驱动盘（应用授权） kso.drive.readwrite

请求头（Header）

名称	类型	是否必填	说明
Content-Type	string	是	使用：application/json
X-Kso-Date	string	是	RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》
Authorization	string	是	授权凭证，格式为：Bearer {access_token}

查询参数（Query）

名称	参数类型	是否必填	说明
allotee_id	string	否	盘归属的应用id，长度不超过1024位
allotee_type	string	是	盘归属身份类型，固定为app
page_size	integer	是	分页大小，[1,1024]
page_token	string	否	分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回next_page_token作为新的page_token，下次遍历可采用该page_token获取查询结果
with_ext_attrs	boolean	否	是否获取盘扩展属性
sources	object[]	否	盘的来源,默认获取全部来源的盘,可多选(应用文档:忽略此参数)

响应体（Response）

名称	类型	说明
data	object	返回信息
∟ items	object[]	盘列表
∟ ∟ allotee_id	string	盘归属的应用id
∟ ∟ allotee_type	string	盘归属身份类型，固定为app
∟ ∟ company_id	string	企业id(应用文档:忽略此参数)
∟ ∟ created_by	object	创建者信息
∟ ∟ ∟ id	string	身份ID
∟ ∟ ∟ type	string	Enum: "user" "sp"，身份类型
∟ ∟ ctime	integer	创建时间，时间戳，单位为秒
∟ ∟ description	string	盘描述
∟ ∟ ext_attrs	object[]	盘扩展属性
∟ ∟ ∟ name	string	名称
∟ ∟ ∟ value	string	值
∟ ∟ id	string	驱动盘id
∟ ∟ mtime	integer	修改时间，时间戳，单位为秒
∟ ∟ name	string	驱动盘名称
∟ ∟ permission_mode	string	Enum: "builtin" "callback"，权限校验模式
∟ ∟ quota	object[]	盘容量(应用文档:返回-1)
∟ ∟ ∟ deleted	integer	回收站中的文件占用的总空间，以字节为单位。只读。
∟ ∟ ∟ remaining	integer	剩余的总空间，以字节为单位。只读。
∟ ∟ ∟ total	integer	允许的总存储空间，以字节为单位。只读。
∟ ∟ ∟ used	integer	已使用的总空间，以字节为单位。只读。
∟ ∟ source	string	盘来源,应用文档:appfile
∟ ∟ status	string	盘状态 inuse:使用中 deleted: 已删除
∟ ∟ storage_mode	string	Enum: "tree" "kv"，驱动盘组织结构
∟ ∟ bucket	string	驱动盘归属的存储key
∟ next_page_token	string	下一页分页标记，<= 1024 characters；当查询结果中next_page_token为空或无该返回值时，代表无下一页
code	int	错误码
msg	string	状态信息
detail	string	详细信息

响应体示例

{
  "data": {
    "items": [
      {
        "allotee_id": "string",
        "allotee_type": "app",
        "company_id": "string",
        "created_by": {
          "id": "string",
          "type": "sp"
        },
        "ctime": 0,
        "description": "string",
        "ext_attrs": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "id": "string",
        "mtime": 0,
        "name": "string",
        "permission_mode": "callback",
        "quota": {
          "deleted": -1,
          "remaining": -1,
          "total": -1,
          "used": -1
        },
        "source": "string",
        "status": "inuse",
        "storage_mode": "kv",
        "bucket": "string"
      }
    ],
    "next_page_token": "string"
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}