上传一致性校验结果
功能介绍
Agent 上传一致性校验结果简报
调用方法
请参见如何调用API。
URI
POST /v3/tasks/{task_id}/consistency-result
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| task_id | 是 | String | 任务id 最小长度:1 最大长度:36 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:1 最大长度:16384 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| consistency_result | 否 | Array of ConsistencyResult objects | 一致性校验结果 数组长度:0 - 30 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| dir_check | 是 | String | 校验目录 最小长度:0 最大长度:1024 |
| num_total_files | 是 | Integer | 文件总数 最小值:0 最大值:1000000 |
| num_different_files | 是 | Integer | 差异文件数量 最小值:0 最大值:1000000 |
| num_target_miss_files | 是 | Integer | 目的端缺少文件数量 最小值:0 最大值:1000000 |
| num_target_more_files | 是 | Integer | 目的端多余文件数量 最小值:0 最大值:1000000 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| - | String | 更新一致性校验结果成功。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 最小长度:0 最大长度:255 |
| error_msg | String | 错误信息 最小长度:0 最大长度:1024 |
状态码:403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误代码 最小长度:0 最大长度:255 |
| error_msg | String | 错误信息 最小长度:0 最大长度:255 |
| encoded_authorization_message | String | 加密授权信息 最小长度:0 最大长度:65535 |
| error_param | Array of strings | 错误参数 最小长度:0 最大长度:65535 数组长度:1 - 20 |
| details | Array of details objects | 详细错误信息 数组长度:1 - 20 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | SMS错误代码 最小长度:0 最大长度:65535 |
| error_msg | String | SMS错误信息 最小长度:0 最大长度:65535 |
状态码:404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 最小长度:0 最大长度:255 |
| error_msg | String | 错误信息 最小长度:0 最大长度:1024 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 最小长度:0 最大长度:255 |
| error_msg | String | 错误信息 最小长度:0 最大长度:1024 |
请求示例
更新任务ID为137224b7-8d7c-4919-b33e-ed159778xxxx 的一致性校验结果简报
POST https://{endpoint}/v3/137224b7-8d7c-4919-b33e-ed159778xxxx/consistency-result
{
"consistency_result" : [ {
"dir_check" : "/root/data",
"num_total_files" : 1235,
"num_different_files" : 12,
"num_target_miss_files" : 12,
"num_target_more_files" : 12
}, {
"dir_check" : "/var",
"num_total_files" : 1235,
"num_different_files" : 12,
"num_target_miss_files" : 12,
"num_target_more_files" : 12
} ]
} 响应示例
状态码:200
更新一致性校验结果成功。
{ } 状态码:403
鉴权失败
{
"error_code" : "SMS.9004",
"error_msg" : "The current account does not have the permission to execute policy. You do not have permission to perform action XXX on resource XXX.",
"encoded_authorization_message" : "XXXXXX",
"error_param" : [ "You do not have permission to perform action XXX on resource XXX." ],
"details" : [ {
"error_code" : "SMS.9004",
"error_msg" : "You do not have permission to perform action XXX on resource XXX."
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 更新一致性校验结果成功。 |
| 400 | 缺少请求参数。 |
| 403 | 鉴权失败 |
| 404 | 任务不存在 |
| 500 | 上传一致性校验结果失败。 |
错误码
请参见错误码。