删除备份范围 - batchDeleteBackupScope
功能介绍
批量删除模块的备份范围
授权信息
当前API调用无需身份策略权限。
URI
DELETE /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 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| scopeIdList | 是 | Array of strings | 参数解释: 范围id列表 约束限制: 集合长度最大为100 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | Integer | 状态码 |
| msg | String | 状态描述 |
| scopeIdList | Array of strings | 删除成功的备份范围 |
| failedScopeList | ScopeDeleteFailedInfo object | 删除失败的备份范围 |
请求示例
批量删除模块的备份范围请求示例
/koodrive/ose/v1/backup/device/1842812272691451648/scope
Authorization:Bearer+60f4ccc7b1********3dd9a68068
{
"scopeIdList": [
"123",
123,
345,
"1760265745989677300VW5TYWZlSW50ZWdlcg==",
"1752777931588940000VW5TYWZlSW50ZWdlcg==",
"1752990708303704300VW5TYWZlSW50ZWdlcg==",
"1842846715527366700VW5TYWZlSW50ZWdlcg=="
]
} 响应示例
状态码:200
批量删除模块的备份范围响应体
{
"scopeIdList" : [ "1842846715527366528" ],
"failedScopeList" : [ {
"scopeId" : "123",
"errorCode" : "15000424",
"msg" : "Request to repeatedly delete scopeId."
}, {
"scopeId" : "123",
"errorCode" : "15000418",
"msg" : "The backup scope does not exist."
}, {
"scopeId" : "345",
"errorCode" : "15000418",
"msg" : "The backup scope does not exist."
}, {
"scopeId" : "1760265745989677312",
"errorCode" : "15000418",
"msg" : "The backup scope does not exist."
}, {
"scopeId" : "1752777931588940032",
"errorCode" : "15000418",
"msg" : "The backup scope does not exist."
}, {
"scopeId" : "1752990708303704321",
"errorCode" : "15000418",
"msg" : "The backup scope does not exist."
} ],
"code" : 0,
"msg" : "success"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 批量删除模块的备份范围响应体 |