DTO对象存储保护

June 24, 2022About 13 min

DTO对象存储保护

SDK类名:/dto/Dto

规则 - 新建

SDK方法名:createDtoRule;

URL

/dto/rule

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
enableNumber是否启用:0否1是0
rule_nameString名称
rule_typeNumber规则类型:0:同步规则;1:恢复规则;2:比较规则; 3:解冻规则;0
sync_typeNumber同步类型:1:静态同步;2:动态同步;3:仅比较;4:比较并同步;5:FTP比较并同步;(旧:规则类型)
policy_typeNumber同步策略类型:0:手动同步;1:定期同步;2:间隔同步;0
policy_strString同步策略定义:(星期天为0)
1)当同步策略为“手动同步”时,该项为空;
2)当同步策略为“定期同步”时,该项定义如下(|
前后都有空格):
D::1,2,3=8:00,9:00,10:00
sync_uuidString同步机uuid
wk_uuidString(比较)比较源存储(FTP比较同步时只能用FTP服务器)
wk_pathArray同步规则时为源路径(同步机上的路径),
还原时为目标路径(同步机上的路径),
比较时为源路径(源存储上的路径)
bk_uuidString(还原、解冻、比较)比较的目标存储uuid,(还原、解冻)的源存储(FTP比较同步时只能用本地存储)
bk_pathArray同步规则时为目标路径(目标存储上的路径),
(还原、解冻)时为源路径(源存储上的路径),
比较时为目标路径(目标存储上的路径)
excl_pathArray排除路径
file_type_filter_switchNumber文件后缀名过滤,1 包含,2 排除0
file_type_filterString以后缀名为过滤条件,格式为“.文件扩展名”;若多个过滤条
件则用逗号隔开,如:.txt,.doc,.rtf
compare_typeNumber(同步、比较)比较类型:0: 文件属性校验(大小+修改时间);1:MD5校验;2:文件大小;3:对象智能比对(需要存储支持自定义META) ;0
oph_policyNumber(比较)孤儿文件处理方式:0:不处理;1:确认后删除;2:直接删除0
bk_name_optNumber(同步)对象文件路径名:0:和源端保持不变;1:全部为大写;2:全部为小写;0
trans_thread_numNumber传输线程数量,1-1000
obj_scan_thread_numNumber(还原、解冻、比较)对象存储扫描线程数量,1-100
cmp_thread_numNumber(比较)比对线程数量0
cmp_algorithmNumber(比较)比对算法,1:小目录先扫描后比对;2:大目录边扫描边比对(页面上暂不显示,传死值1)0
cmp_result_limitNumber(比较)保留结果数量0
band_widthString(同步、比较)带宽设置;

周几几几几点-几点限速(单位k/m);如

1234508:00-18:00100m,0500:00-23:00200k

,意为,周一到周五8点到18点限速100m,周日和周五0点到23点限速200k
app_db_up_switchNumber(同步)是否启用映射更新,0否1是0
app_db_up_typeString(同步)应用数据库类型:Oracle / SQLServer0
app_db_up_sqlString(同步)更新映射的SQL语句0
archive_flagNumber(比较)是否启用归档,0关1开,

归档只有在 孤儿文件处理方式、压缩、加密 都关闭的情况下才能开启;

归档只支持本地存储到对象存储;
1
archive_typeNumber(比较)归档类型,0:同步所有文件,并删除本地符合条件的文件;1:只同步并删除符合条件的文件,默认01
archive_daysNumber(比较)归档条件,创建时间和修改时间早于同步时间的天数,默认901
compressNumber压缩(同步)、解压(还原)开关,0关1开;只有比较类型为:对象智能比对(需要存储支持自定义META) 、忽略目标端存在的文件 时可以开启;0
encryptNumber加密(同步)、解密(还原)开关,0关1开;只有比较类型为:对象智能比对(需要存储支持自定义META) 、忽略目标端存在的文件 时可以开启;0
encrypt_passString加密(同步)、解密(还原)密码,需要加密;
rc_pointNumber默认0,恢复时间点-精确到毫秒
rc_typeNumber恢复类型:
0:普通恢复;
1:历史恢复;
2:解冻;
3:恢复到复制卷
scan_obj_flagNumberrule_type为2时(比较规则),备端扫描:1-开启 0-关闭1
archive_objectObjectrule_type为2时(比较规则),归档时间条件
  create_timeNumber创建时间:1勾选,0未勾选
  modify_timeNumber修改时间:1勾选,0未勾选
  access_timeNumber访问时间:1勾选,0未勾选
  typeString或0,与1
  name_featureString命名特征
  file_typeString文件类型
valid_periodNumber【解冻】有效期
rate_typeNumber【解冻】速率: 1-加急 0-标准
real_pathArray【还原】用户实际选择的备份到本地的路径。还原的bk_path为底层返回的mapper_path,保持不变
volume_uuidString复制卷uuid;
恢复规则,恢复到复制卷时,必传
(rule_type:1,rc_type:3)
file_recordNumber规则传输记录功能是否开启:
0:不开启(默认);
1:开启;

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。

规则 - 修改

SDK方法名:modifyDtoRule;

URL 参数为:rule_uuid;

URL

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

Method

PUT

Request

名称类型必选简介Mock初始值Mock规则
enableNumber0
rule_nameString
sync_uuidString
policy_typeNumber0
policy_strString
wk_uuidString
wk_pathArray
bk_uuidString
bk_pathArray
real_pathString【恢复】用户实际选择的恢复路径
excl_pathArray
file_type_filter_switchNumber0
file_type_filterString
compare_typeNumber0
oph_policyNumber0
bk_name_optNumber0
trans_thread_numNumber0
obj_scan_thread_numNumber0
cmp_thread_numNumber0
cmp_algorithmNumber0
cmp_result_limitNumber0
band_widthString
app_db_up_switchNumber0
app_db_up_typeNumber0
app_db_up_sqlNumber0
random_strString
sync_typeNumber
archive_flagNumber1
archive_typeNumber1
archive_daysNumber1
compressNumber0
encryptNumber0
encrypt_passString
scan_obj_flagNumberrule_type为2时(比较规则),备端扫描:1-开启 0-关闭1
archive_objectObjectrule_type为2时(比较规则),归档时间条件
  create_timeNumber
  modify_timeNumber
  access_timeNumber
  typeString
  name_featureString
  file_typeString

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。

规则 - 单个

SDK方法名:describeDtoRule;

URL

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

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  dto_ruleObject
    enableNumber0
    rule_uuidString
    rule_nameString
    rule_typeNumber0
    sync_uuidString
    sync_nameString
    policy_typeNumber1
    policy_strString
    wk_uuidString
    wk_nameString
    wk_pathArray
    bk_uuidString
    bk_nameString
    bk_pathArray
    excl_pathArray
    file_type_filter_switchNumber0
    file_type_filterString
    compare_typeNumber0
    oph_policyNumber0
    bk_name_optNumber0
    trans_thread_numNumber0
    obj_scan_thread_numNumber0
    cmp_thread_numNumber0
    cmp_algorithmNumber0
    cmp_result_limitNumber0
    band_widthString
    app_db_up_switchNumber1
    app_db_up_typeStringOracal
    app_db_up_sqlStringtest
    random_strString
    user_uuidString
    usernameString
    create_timeNumber0
    sync_typeNumber
    scan_obj_flagNumber
    archive_objectObject
      create_timeNumber
      modify_timeNumber
      access_timeNumber
      typeString
      name_featureString
      file_typeString

规则 - 列表

SDK方法名:listDtoRule;

URL

/dto/rule

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
typeNumber规则类型:0:同步规则;1:恢复规则;2:比较规则;3:解冻规则;
limitNumber1
pageNumber1
search_valueString
search_fieldString

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  totalNumber1
  info_listArray
    enableNumber1
    rule_uuidString9c420cF9-8EA2-2b5F-cDB4-A5680bC3E9D2
    rule_nameString
    rule_typeNumber0
    sync_uuidString
    user_uuidString
    usernameString
    create_timeNumber0
    sync_typeNumber
    wk_sto_nameString
    bk_sto_nameString
    sync_host_nameString
    wk_sto_uuidString
    bk_sto_uuidString
    wk_sto_typeNumber11
    bk_sto_typeNumber11
    rate_typeNumber解冻速率
    can_delNumber1
    can_opNumber1

规则 - 状态

SDK方法名:listDtoRuleStatus;

URL

/dto/rule/status

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
rule_uuidsArray
force_refreshNumber点击操作栏刷新按钮必传,下发1,表示从rpc获取;其他情况不传

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  statusArray
    rule_uuidString9c420cF9-8EA2-2b5F-cDB4-A5680bC3E9D2
    progressString百分比=read_bytes/total_bytes50
    statusString-1-UNKNOWN-未知,
0-STOP-停止 表示数据同步完成,可切换,
1-CALC-准备中 表示扫描中,list,
2-MIRROR-显示百分比表示传输中,
3-MIRROR-显示百分比表示传输中,
4-ORPHAN-孤儿文件处理中,
8-THAWING-解冻中
16-COMPARING -比较,

32-CALC-准备中 表示扫描中,list,
33-CALC-准备中 表示扫描中,list,
64-END-完成
65-IDLE-空闲
66-停止(用户手动停止)
67-EXCEPTION-异常
ORPHAN
    total_bytesNumber总字节数0
    trans_bytesNumber传输字节数0
    read_bytesNumber0
    totalNumber文件总数0
    transNumber传输文件数0
    sameNumber相同文件数0
    missNumber缺失文件数0
    diffNumber不同文件数0
    failNumber传输失败数0
    thawNumber解冻文件数0
    wait_thawNumber待解冻文件数0
    rate_typeNumber解冻速率0

规则 - 删除

SDK方法名:deleteDtoRule;

URL

/dto/rule

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
rule_uuidsArray
forceNumber1 - 强制删除 0 - 非强制删除

Response

名称类型必选简介Mock初始值Mock规则
msgString
dataObject
  codeNumber11110001
  messageString
  fail_listArray
    codeNumber11110001
    messageString[0] success
    rule_uuidString@guid
    rule_nameStringtest2
  success_listArray
    codeNumber11110001
    messageString[0] success
    rule_uuidString@guid
    rule_nameStringtest1
retNumber200

规则 - 操作

SDK方法名:

启动:startDtoRule;

停止:stopDtoRule;

继续:resumeDtoRule;

URL

/dto/rule/operate

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
operateString启动:start;停止:stop;继续:resume;失败重传:restart;
rule_uuidsArray["dCf2732A-fBdA-5F3F-cE3f-7989AA8De4cd","17b99b8e-2e11-C1b2-7302-b8ee1BCdF3Bd"]

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。

规则 - 文件列表(比较 不同/丢失/失败/孤儿)

SDK方法名:listDtoRuleFile; URL 参数为:rule_uuid;

URL

/dto/rule/:uuid([A-F0-9-]+)/file

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
typeString参数:diff/miss/fail/orphan
pageNumber
limitNumber

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  totalNumber1
  info_listArray
    pathString某路径下。。/
    filesString。。有什么文件(逗号分隔)2
    moreNumber如果files中多于1000个,则more值为一共多少个,否则more为0

规则 - 文件列表 删除孤儿(比较)

SDK方法名:deleteDtoRuleFile; URL 参数为:rule_uuid;

URL

/dto/rule/:uuid([A-F0-9-]+)/file

Method

DELETE

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功

规则 - 比较结果(比较)

SDK方法名:listDtoRuleCmpResult; URL 参数为:rule_uuid;

URL

/dto/rule/:uuid([A-F0-9-]+)/cmp_result

Method

GET

Request

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

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功
  info_listArray
    idNumber1
    totalNumber总文件数0
    sameNumber丢失文件数0
    missNumber丢失文件数1
    diffNumber不同文件数0
    transNumber传输文件数1
    failNumber失败文件数1
    trans_bytesNumber传输字节数0
    statusStringIDEL / STOP / FINISH / EXCEPTIONFINISH
    start_timeNumber时间戳1557398375
    finish_timeNumber时间戳1557398381
    wk_pathArray执行时源路径["aliyun--oos:/TestDir/222 - 副本 (4).txt"]
    bk_pathArray执行时目标路径["aliyun--oos:/TestDir/222 - 副本 (5).txt"]
    excl_pathArray执行时排除路径[]

规则 - 获取源端对应路径列表

SDK方法名:listDtoRuleSourcePath;

URL

/dto/rule/source_path_list

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
host_uuidString源端存储UUID@guid
host_ipString源端ip
timepointString@timestamp()
prefixString前缀
mapper_pathString选中路径的目标路径

Response

名称类型必选简介Mock初始值Mock规则
dir_listsArray
  nameStringDTOprefix下的子目录
  mapper_pathStringDTO 子目录对应源存储路径
  restore_statusString1:空白,2:未解冻,3:解冻中,4:解冻完成
Last update: 11/3/2023, 3:54:28 PM
Contributors: ganl