# 比较与同步

SDK类名：/tools/Compare

# 1 单体-1 新建

SDK方法名：createCompare;

# URL

//compare

# Method

POST

# Request

名称	类型	必选	初始值	简介
compare	Object	否
excl_path	Array	否		源机排除目录
bkup_policy	Number	否	2	备份策略，2 立即，0 定时，1 循环；
bkup_one_time	Number	否	0	定时任务，执行时间（备份策略）
bkup_schedule	Object	否		周期任务（备份策略）
sched_gap_min	Number	否	60	间隔分钟数
sched_time	Array	否	["00:00:00"]	哪几点
sched_day	Array	否	["1"]	哪几天
sched_time_end	String	否	23:59	运行时间范围结束
limit	Number	否	5	数据保留期限（天）
sched_time_start	String	否	00:00	运行时间范围开始
sched_every	Number	否	0	0：每天；1：每周：2：每月；3：每隔；
mirr_file_check	String	否	1	校验方式，0：md5；1：文件大小和时间；
task_name	String	否	testCompare1	任务名
wk_path	Array	否	["E:\test\"]	工作路径
bk_uuid	String	否	67E33CDB-D75B-15B3-367D-50C764F5A26F	备机节点uuid
cmp_type	Number	否	0	任务类型，0：只比较，1：比较并同步；
bk_path	Array	否	["E:\test\"]	备份路径
wk_uuid	String	否	67E33CDB-D75B-15B3-367D-50C764F5A26F	工作机节点uuid
mirr_sync_attr	Number	否		文件安全属性，0代表不同步安全属性，1代表同步安全属性
compress	Number	否	0	压缩，0关；1：低；2：中；
encrypt_switch	String	否		加密开关，0关1开
secret_key	String	否		加密密钥
biz_grp_list	Array	否		业务分组UUID
oph_policy	String	否		孤儿文件处理策略：0不处理，1删除，2移动到指定路径；6 归档；
ct_name_str1	String	否		文件名转换：prefix string / regex string
ct_name_str2	String	否		文件名转换：suffix string / replace string
ct_name_str3	String	否		文件名转换：restore regex string
ct_name_str4	String	否		文件名转换：restore regex string

# Response

名称	类型	必选	初始值	简介
ret	Number	否	200	@mock=200
msg	String	否		@mock=
data	Object	否
code	Number	否	0	@mock=0
message	String	否	[0] success	@mock=[0] success

# 1 单体-2 获取单个(包括比较结果)

类名：/tools/Compare

方法名：describeCompare

# URL

//compare/:uuid([A-F0-9-]+)

# Method

GET

# Request

名称	类型	必选	初始值	简介	Mock规则

# Response

名称	类型	必选	初始值	简介
msg	String	否		@mock=
ret	Number	否	200	@mock=200
data	Object	否
code	Number	否	0	@mock=0
compare	Object	否
task_type	Number	否	0	0：主任务（旧）

# 1 单体-2 获取比较结果详情

详见

i2soft / i2cc / webapi / api /

底层日志 / i2node日志 / 规则/任务日志接口；

http://rap.info2soft.com/workspace/myWorkspace.do?projectId=3#225;

# URL

//logs

# Method

GET

# Request

名称	类型	必选	初始值	简介	Mock规则

# Response

名称	类型	必选	初始值	简介	Mock规则

# 2 列表-1 获取列表

获取列表详细入参说明详见【节点管理-获取节点列表】接口说明；

类名：/tools/Compare

方法名：listCompare

# URL

//compare

# Method

GET

# Request

名称	类型	必选	初始值	简介
limit	Number	否	10	, 可选，不传就是全部
page	Number	否	1	, 可选，不传就是全部
search_field	String	否		, 可选，搜索字段
search_value	String	否		, 可选，搜索字段对应值（可以模糊）

# Response

名称	类型	必选	初始值	简介	Mock规则
msg	String	否		@mock=
data	Object	否
total	Number	否	100	@mock=100, 规则总数
code	Number	否	0	@mock=0
info_list	Array	否			10
bk_uuid	String	否	0DD4E727-70AB-62C6-BEB5-D012DFAE46E3	@mock=0DD4E727-70AB-62C6-BEB5-D012DFAE46E3, 备机节点uuid
end_time	Number	否	1508833953	@mock=1508833953, 结束时间，unix时间戳
wk_uuid	String	否	0DD4E727-70AB-62C6-BEB5-D012DFAE46E3	@mock=0DD4E727-70AB-62C6-BEB5-D012DFAE46E3, 工作机节点uuid
username	String	否	@pick(["admin", "user"])	@mock=@pick(["admin", "user"]), 所有者
bkup_policy	Number	否	2	@mock=2, 备份策略，0立刻，1定时，2周期
status	String	否	FINISH	@mock=FINISH, SCHEDULED，COMPARING，GENERATING，FINISH
result_sum	Object	否		, 结果概览
f_missing	Number	否	123	@mock=123, 丢失文件数
f_total	Number	否	0	@mock=0, 文件总数
f_skip	Number	否	123	@mock=123, 相同文件数
total	Number	否	100	@mock=100, 总文件大小
finish_in	Number	否	123	@mock=123, 耗时（秒）
state_code	Number	否	0	@mock=0, 结果代码
f_diff	Number	否	123	@mock=123, 不同文件数
wk_node_name	String	否	@pick(["Smith", "Will", "Nary"])	@mock=@pick(["Smith", "Will", "Nary"]), 工作机节点名
user_uuid	String	否	@pick(["1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC","1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC"])	@mock=@pick(["1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC","1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC"]), 操作者用户名uuid
bk_node_name	String	否	@pick(["kevin", "Jane", "Grey"])	@mock=@pick(["kevin", "Jane", "Grey"]), 备机节点名
start_time	Number	否	1508833766	@mock=1508833766, 开始时间，unix时间戳
task_uuid	String	否	7AD64D7A-7D1D-AC51-5DF1-29A58345A288	@mock=7AD64D7A-7D1D-AC51-5DF1-29A58345A288, 任务id，如果节点和规则id都不传，则全部
task_name	String	否	task_name	@mock=task_name, 任务名
create_time	Number	否	1515568566	@mock=1515568566, 任务创建时间
message	String	否	[0] success	@mock=[0] success
ret	Number	否	200	@mock=200

# 2 列表-1.1 获取结果列表（周期）

类名：/tools/Compare

方法名：listCircleCompareResult

# URL

//compare/:uuid([A-F0-9-]+)/result_list

# Method

GET

# Request

名称	类型	必选	初始值	简介
limit	Number	否	10	可选，不传就是全部
page	Number	否	1	可选，不传就是全部
search_field	String	否		可选，搜索字段
search_value	String	否		可选，搜索字段对应值（可以模糊）

# Response

名称	类型	必选	初始值	简介	Mock规则
ret	Number	否	200	@mock=200
msg	String	否		@mock=
data	Object	否
code	Number	否	0	@mock=0
message	String	否	[0] success	@mock=[0] success
total	Number	否	100	@mock=100, 规则总数
info_list	Array	否			10
task_uuid	String	否	7AD64D7A-7D1D-AC51-5DF1-29A58345A288	@mock=7AD64D7A-7D1D-AC51-5DF1-29A58345A288, 任务id，如果节点和规则id都不传，则全部
wk_uuid	String	否	0DD4E727-70AB-62C6-BEB5-D012DFAE46E3	@mock=0DD4E727-70AB-62C6-BEB5-D012DFAE46E3, 工作机节点uuid
bk_node_name	String	否	@pick(["kevin", "Jane", "Grey"])	@mock=@pick(["kevin", "Jane", "Grey"]), 备机节点名
username	String	否	@pick(["admin", "user"])	@mock=@pick(["admin", "user"]), 所有者
bk_uuid	String	否	0DD4E727-70AB-62C6-BEB5-D012DFAE46E3	@mock=0DD4E727-70AB-62C6-BEB5-D012DFAE46E3, 备机节点uuid
start_time	Number	否	1508833766	@mock=1508833766, 开始时间，unix时间戳
user_uuid	String	否	@pick(["1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC","1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC"])	@mock=@pick(["1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC","1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC"]), 操作者用户名uuid
end_time	Number	否	1508833953	@mock=1508833953, 结束时间，unix时间戳
task_name	String	否	task_name	@mock=task_name, 任务名
status	String	否	FINISH	@mock=FINISH, SCHEDULED，COMPARING，GENERATING，FINISH
bkup_policy	Number	否	0	@mock=0, 备份策略，0立刻，1定时，2周期
raw_uuid	String	否	7AD64D7A-7D1D-AC51-5DF1-29A58345A288	@mock=7AD64D7A-7D1D-AC51-5DF1-29A58345A288, 父任务id
create_time	Number	否	1515568566	@mock=1515568566, 任务创建时间
result_sum	Object	否		, 结果概览
f_total	Number	否	0	@mock=0, 文件总数
total	Number	否	100	@mock=100, 总文件大小
f_missing	Number	否	123	@mock=123, 丢失文件数
finish_in	Number	否	123	@mock=123, 耗时（秒）
f_diff	Number	否	123	@mock=123, 不同文件数
state_code	Number	否	0	@mock=0, 结果代码
f_skip	Number	否	123	@mock=123, 相同文件数
wk_node_name	String	否	@pick(["Smith", "Will", "Nary"])	@mock=@pick(["Smith", "Will", "Nary"]), 工作机节点名

# 2 列表-2 状态

类名：/tools/Compare

方法名：listCompareStatus

# URL

//compare/status

# Method

GET

# Request

名称	类型	必选	初始值	简介	Mock规则
task_uuids	Array	否	["11111111-1111-1111-1111-111111111111"]	必传，uuid数组，页面加载第一次获取状态一个一个获取，之后是批量获取；

# Response

名称	类型	必选	初始值	简介
ret	Number	否	200
data	Object	否
message	String	否	[0] success
status	Object	否
progress	Number	否	0	进度
result_sum	Object	否		结果概览
f_missing	Number	否	123	丢失文件数
state_code	Number	否	0	结果代码
f_diff	Number	否	123	不同文件数
total	Number	否	100	总文件大小
f_skip	Number	否	123	相同文件数
finish_in	Number	否	123	耗时（秒）
f_total	Number	否	0	文件总数
already_cmp_num	Number	否	1	已比较次数
sub_task_num	Number	否	1	子任务数量
task_uuid	String	否	7AD64D7A-7D1D-AC51-5DF1-29A58345A288	任务id
status	Number	否	FINISH	@mock=FINISH, SCHEDULED，COMPARING，GENERATING，FINISH
code	Number	否	0
count	Number	否	0
msg	String	否

# 2 列表-4 操作

类名：/tools/Compare

方法名：[action] + 'Compare'

# URL

//compare/operate

# Method

POST

# Request

名称	类型	必选	初始值	简介	Mock规则
operate	String	否	download	下载：download，删除：delete（与独立的删除接口效果等同）；
task_uuids	Array	否	["11111111-1111-1111-1111-111111111111"]	必传

# Response

名称	类型	必选	初始值	简介
ret	Number	否	200	@mock=200
msg	String	否		@mock=
data	Object	否
file_name	String	否	CPR_20180207164539.zip	@mock=CPR_20180207164539.zip
message	String	否	[0] 操作成功	@mock=[0] 操作成功
code	Number	否	0	@mock=0
download_url	String	否	E:\ctrlcenter\wwwroot\default\public\download\CPR_20180207164539.zip	@mock=E:\ctrlcenter\wwwroot\default\public\download\CPR_20180207164539.zip

# 2 列表-3 删除

类名：/tools/Compare

方法名：deleteCompare

# URL

//compare

# Method

DELETE

# Request

名称	类型	必选	初始值	简介	Mock规则
task_uuids	Array	否	["11111111-1111-1111-1111-111111111111"]	规则数组

# Response

名称	类型	必选	初始值	简介
ret	Number	否	200	@mock=200
data	Object	否
message	String	否	[0] success	@mock=[0] success
code	Number	否	0	@mock=0
msg	String	否		@mock=