更新驱动盘
适用版本>=v7.0.2411a.20241114
接口说明:更新驱动盘
请求说明
| 请求地址 | 配置域名+/graph+/v7/drives/{drive_id}/update |
|---|---|
| 请求方法 | POST |
| 签名方式 | WPS-4签名/WPS-4-GM签名(配置域名+/graph不参与签名) |
| 权限要求 | 管理驱动盘(应用授权) kso.drive.readwrite |
请求头(Header)
| 名称 | 是否必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 固定为: application/json |
| Wps-Docs-Date | 是 | 取当前时间,示例: Wed, 23 Jan 2013 06:43:08 GMT |
| Wps-Docs-Authorization | 是 | 计算方法参考签名说明 |
| Authorization | 是 | 授权凭证,格式为: Bearer {access_token} |
请求体(Body)
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| name | string | 否 | 驱动盘名称,不支持"/:*?"<>|"特殊符号,长度范围[1,255] |
| bucket | string | 否 | 盘归属的存储key,长度范围[0,255] |
请求体示例
{
"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 | integer | 错误码,参照《错误码说明》 |
| msg | string | 状态信息 |
| detail | string | 详细信息 |
响应体示例
json
{
"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"
}