添加备份范围 - batchAddBackupScope
功能介绍
批量添加模块备份范围
授权信息
当前API调用无需身份策略权限。
URI
POST /koodrive/ose/v1/backup/device/{deviceId}/scope
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| deviceId | 是 | String | 参数解释: 设备id 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Authorization | 是 | String | 参数解释: 该字段存储的是 Access Token。 调用KooDrive的API使用Token认证,拥有Token就代表拥有某种权限,在调用API的时候将Token加到请求消息头中,从而通过身份认证,获得操作API的权限。 约束限制: 格式参考:Bearer+/access token} 取值范围: Access Token的获取请参考对应的开发手册 默认取值: 不涉及 |
| X-User-Id | 是 | String | 参数解释: koodrive侧用户id,用于appId鉴权 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| X-Date | 是 | String | 参数解释: 签名时间,用于appId鉴权 约束限制: 距当前时间15分钟以内,不能晚于当前时间 取值范围: yyyMMdd'T'HHmmss'Z',例:20251103T070140Z 默认取值: 不涉及 参数解释: 签名时间,用于appId鉴权 约束限制: 距当前时间15分钟以内,不能晚于当前时间 取值范围: yyyMMdd'T'HHmmss'Z',例:20251103T070140Z 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| moduleCode | 是 | String | 参数解释: 模块码 约束限制: 100-102 取值范围: 100 文件夹备份,101 相册备份,102 通讯录备份 默认取值: 不涉及 |
| scopeList | 是 | Array of ScopeBaseInfo objects | 参数解释: 范围列表 约束限制: 最大长度100 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | Integer | 状态码 |
| msg | String | 状态描述 |
| scopeList | Array of ScopeInfo objects | 添加成功的范围信息 |
| failedScopeList | Array of ScopeAddFailedInfo objects | 添加失败的范围信息 |
请求示例
批量添加模块备份范围请求示例
/koodrive/ose/v1/backup/device/1842812272691451648/scope
Authorization:Bearer+60f4ccc7b1********3dd9a68068
{
"moduleCode": "102",
"scopeList": [
{
"localPath": "/asdkhsdahjksd",
"targetFolderPath": "/ashdjkha"
}
]
} 响应示例
状态码:200
批量添加模块备份范围响应体
{
"scopeList" : [ {
"localPath" : "/asdkhsdahjksd",
"targetFolderPath" : "/ashdjkha",
"scopeId" : "1842846715527366528",
"moduleCode" : "102",
"createTime" : "2025-12-17T07:27:27.709Z"
} ],
"failedScopeList" : [ ],
"code" : 0,
"msg" : "success"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 批量添加模块备份范围响应体 |