更新时间:2025-12-08 GMT+08:00

获取一致性校验结果

功能介绍

获取一致性校验结果简报

调用方法

请参见如何调用API

URI

GET /v3/tasks/{task_id}/consistency-result

表1 路径参数

参数

是否必选

参数类型

描述

task_id

String

任务id

最小长度:1

最大长度:36

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

最小长度:1

最大长度:16384

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

result_list

Array of result_list objects

一致性校验结果列表

task_id

String

任务id

表4 result_list

参数

参数类型

描述

finished_time

Long

校验完成时间

check_result

String

校验结果

consistency_result

Array of ConsistencyResult objects

校验结果

表5 ConsistencyResult

参数

参数类型

描述

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

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度:0

最大长度:255

error_msg

String

错误信息

最小长度:0

最大长度:1024

状态码:403

表7 响应Body参数

参数

参数类型

描述

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

表8 details

参数

参数类型

描述

error_code

String

SMS错误代码

最小长度:0

最大长度:65535

error_msg

String

SMS错误信息

最小长度:0

最大长度:65535

状态码:404

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度:0

最大长度:255

error_msg

String

错误信息

最小长度:0

最大长度:1024

状态码:500

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码

最小长度:0

最大长度:255

error_msg

String

错误信息

最小长度:0

最大长度:1024

请求示例

获取任务ID为137224b7-8d7c-4919-b33e-ed159778xxxx 的一致性校验结果简报

GET https://{endpoint}/v3/137224b7-8d7c-4919-b33e-ed159778xxxx/consistency-result

响应示例

状态码:200

获取一致性校验结果成功。

{
  "result_list" : [ {
    "finished_time" : 1736854315000,
    "check_result" : "success",
    "consistency_result" : [ {
      "dir_check" : "/root/sync",
      "num_total_files" : 1,
      "num_different_files" : 0,
      "num_target_miss_files" : 0,
      "num_target_more_files" : 0
    } ]
  } ],
  "task_id" : "7861c7ab-06c0-4b23-a350-00e5ed361fbb"
}

状态码: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

获取一致性校验结果失败。

错误码

请参见错误码