快照任务

November 23, 2021About 6 min

快照任务

SDK类名:/snapshotTask/SnapshotTask;

新建

SDK方法名:createSnapshotTask;

URL

//snapshot_task

Method

POST

Request

名称类型必选初始值简介Mock规则
task_nameString任务名称
bk_uuidString客户端(灾备机)uuid
copy_volume_listArray关联复制卷
quiet_switchNumber启用静默快照
quiet_obj_typeNumber静默快照对象:
0-oracle、
1-mysql、
2-sqlserver、
3-rep
quiet_obj_configObject静默快照配置信息
ORACLE|MYSQL
SQLSERVER对应的配置信息
scheduleObject快照策略
  intervalNumber时间间隔
  retetion_daysNumber快照保留天数
  limitNumber快照数量
  typeString0:每天;1:每周:2:每月;3:每隔
注: 目前只支持每隔
  unitNumber0: 分钟 1:小时
volume_typeNumber卷类型:0-复制卷 1-副本卷

Response

名称类型必选初始值简介Mock规则
msgString
retNumber200
dataObject
  messageString
  codeNumber0

修改

SDK方法名:modifySnapshotTask;

下发参数同新建

URL

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

Method

PUT

Request

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

Response

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

列表

SDK方法名:listSnapshotTask;

URL

//snapshot_task

Method

GET

Request

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

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] success
  info_listArray2
    bk_node_nameString7.250
    usernameStringadmin
    user_uuidString1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
    task_uuidArray['16CB63E1-13FA-FB32-EB49-D790682C9648','16CB63E1-13FA-FB32-EB49-D790682C9647']+1
    task_nameStringtask1
    bk_uuidString65E3E4A5-D089-8B6A-25F3-096F6997E3F0
    last_timeString12345
    next_timeString
    statusString
    create_timeString1597738052
  totalNumber1

删除

SDK方法名:deleteSnapshotTask;

URL

//snapshot_task

Method

DELETE

Request

名称类型必选初始值简介Mock规则
task_uuidsArray[ "16CB63E1-13FA-FB32-EB49-D790682C9648" ]
forceString1 - 强制删除 0 - 非强制删除
del_snapNumber0-不删除 1-删除

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber11110001
  messageString[0] success
  success_listArray
    codeNumber11110001
    messageString[0] success
    task_uuidString16CB63E1-13FA-FB32-EB49-D790682C9648
    task_nameStringtask1
  fail_listArray
    codeNumber11110001
    messageString[-1] 找不到节点
    task_uuidString16CB63E1-13FA-FB32-EB49-D790682C9647
    task_nameStringtask2

状态

SDK方法名:listSnapshotTaskStatus;

URL

//snapshot_task/status

Method

GET

Request

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

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] success
  statusArray2
    task_uuidArray['16CB63E1-13FA-FB32-EB49-D790682C9648','16CB63E1-13FA-FB32-EB49-D790682C9647']+1
    statusArray['STOP', 'WAIT']+1
    last_resultStringsuccess
    last_timeString2010-08-14 13:00:00
    next_timeString2010-08-15 13:00:00

快照任务-获取单个

SDK方法名:describeSnapshotTask;

URL

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

Method

GET

Request

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

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  messageString
  snapshot_taskObject
  codeNumber0
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] success
  snapshot_taskObject
    task_nameStringtask1
    bk_uuidString65E3E4A5-D089-8B6A-25F3-096F6997E3F0
    copy_volume_listArray["E95CB20B-917C-57F4-F926-751ECE95F869"]
    quiet_switchNumber1
    quiet_obj_typeNumber0
    quiet_obj_configObject
      oracle_dbagent_paramObject
        enableBooleantrue
        oracle_sidString321
        sql_plus_pathString/st
        table_spaceArray['SYSAUX', 'UNDOTBS1', 'USERS']
        usernameStringuser
        passwordString12345678
        portNumber1521
        timeoutString4444
      mysql_dbagent_paramObject
        mysql_pathString/my_st
        database_nameArray['USERS', 'TEST', 'TB']
        usernameStringmysql_user
        passwordString12345678
        portNumber3366
        timeoutString666
      sqlserver_dbagent_paramObject
        enableBooleantrue
        timeoutString333
    scheduleObject
      intervalNumber15
      retetion_daysNumber1
      limitNumber64
      typeStringinterval
      unitNumber1

操作

SDK方法名:{action}SnapshotTask;

URL

//snapshot_task/operate

Method

POST

Request

名称类型必选初始值简介Mock规则
operateStringstart_immediately立即快照 - start_immediately
启动 - start
停止 - stop
task_uuidsArray['3D7AD825-9C50-ADBA-6AC8-536B9615C40F']

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] success
  success_listArray
    codeNumber0
    messageString[0] success
    task_uuidString16CB63E1-13FA-FB32-EB49-D790682C9648
    task_nameStringtask1

获取任务快照列表

SDK方法名:listSnapshotList;

URL

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

Method

GET

Request

名称类型必选初始值简介Mock规则
pageNumber1页数
limitNumber10条数
fromNumber0按时间范围过滤,从什么时候开始
toNumber0按时间范围过滤,到什么时候结束

Response

名称类型必选初始值简介Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] success
  snapshot_listArray
    snapshot_nameStringtestpool/13CB1D17-D0E7-169A-D6DC-9CFB32341989@2020-06-17-11:30:51快照名称
    snapshot_timeString2020-06-17-11:30:51快照时间
    volume_uuidString13CB1D17-D0E7-169A-D6DC-9CFB32341989复制卷uuid
    volume_nameStringvolume_name复制卷名称
    clone_listArray["testpool/13CB1D17-D0E7-169A-D6DC-9CFB32341989@2020-06-17-11:30:51_clone1","testpool/13CB1D17-D0E7-169A-D6DC-9CFB32341989@22020-06-17-11:30:51_clone2"]副本卷
  totalNumber1

删除任务快照

SDK方法名:deleteSnapshotList;

URL

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

Method

DELETE

Request

名称类型必选初始值简介Mock规则
snapshot_listArray
  volume_uuidString
  snapshot_nameString
  snapshot_timeString

Response

名称类型必选初始值简介Mock规则
msgString
retNumber200
dataObject
  messageString
  codeNumber0
  success_listArray
    codeString
    messageString
    snapshot_nameString54A49235-12F5-4E21-205F-4D8FAACA4079快照名称
    volume_uuidString34A49235-12F5-4E21-205F-4D8FAACA4079复制卷uuid
    volume_nameStringvolume_name复制卷名称
  fail_listArray
    codeString
    messageString
    snapshot_nameString54A49235-12F5-4E21-205F-4D8FAACA4079快照名称
    volume_uuidString34A49235-12F5-4E21-205F-4D8FAACA4079复制卷uuid
    volume_nameStringvolume_name复制卷名称
Last update: 6/25/2022, 9:23:18 PM
Contributors: ganl