更新驱动盘

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

接口说明：更新驱动盘

请求说明

请求地址	配置域名+/openapi+/v7/drives/{drive_id}/update
请求方法	POST
签名方式	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}

请求体（Body）

名称	类型	是否必填	说明
name	string	否	驱动盘名称，不支持"/:*?"<>|"特殊符号，长度范围[1,255]
bucket	string	否	盘归属的存储key，长度范围[0,255]；若传空字符串则清空drive所配置的bucket

请求体示例

{
  "name": "string",
  "bucket": "string"
}

响应体（Response）

名称	类型	说明
data	object	驱动盘信息
∟ allotee_id	string	盘归属的应用id，长度不超过1024位
∟ 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	Enum: "inuse" "deleted"，盘状态
∟ storage_mode	string	Enum: "tree" "kv"，驱动盘组织结构
∟ bucket	string	驱动盘归属的存储key
code	int	错误码
msg	string	状态信息
detail	string	详细信息

响应体示例

{
  "data": {
    "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"
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}