备份集

February 26, 2024About 19 min

备份集

SDK类名:/backupSet/BackupSet;

备份集管理 - 列表

SDK方法名:listBackupSet

URL

/backup_set

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
pageNumber1
limtNumber10
where_argsArray
  wk_nameString源端备份服务器名称或者主机名
  src_typeString源类型(规则类型)
  bk_nameString备端备份服务器名称或者主机名
  bk_rule_nameString备份规则名称
  bk_start_tmString备份起始时间晚于
  bk_end_tmString备份结束时间早于
  storage_unit_nameString存储单元名
  tnameString磁带名
  deleteString是否已删除备份集,0:关,1:已过期,2:已删除
  copy_idString副本号
  bk_typeString备份类型:0-全备
1-增量
2-差异
  replica_task_sched_nameString备份计划名
  vp_uuidString虚拟平台uuid
  vm_idString虚机id
  instance_nameString实例名称
  db_nameString数据库名称
  backup_methodNumber数据库备份类型:
0:物理备份
1:逻辑备份
  content_typeNumber数据库备份粒度:
0:集群;
1:实例;
2:整库;
3:模式;
4:多表;
(mysq、GaussDWS)
  wk_uuidString源客户端UUId
or_where_by_groupStringjson格式
stageArray需要过滤的状态,不传分页参数时生效[0,1]
like_argsArray
  barcodeString根据条形码过滤 磁带-查看备份集
show_all_copyNumber是否区分主副本,0:区分,1:不区分
filter_logNumber是否过滤日志备份集:
0:否;
1:是;
0

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  info_listArray2
    copy_sumNumber1
    user_uuidString1BCFCAA3-E3C8-3E28-BDC5-BE36FDC2B5DC
    backup_rule_nameArray["oracle-rac-data","oracle-rac-log"]+1
    bk_set_idArray["icbc-ora12c-sles12-r2_1714298447_72BFEFA3_0","icbc-ora12c-sles12-r2_1714296820_98CD5524_0"]+1
    bk_rule_uuidArray["61F978BA-C2A3-4A22-9336-FB9469C7C0AF","0E08AFA8-9787-4485-9256-A4DF9CBBFEEA"]+1
    copy_idNumber0
    primary_copyNumber1
    created_atNumber1714298926+1
    verArray["20240426211959","20240425112318"]+1
    raw_jsonObject
      backup_keyString
      bk_end_tmNumber1714298926+1
      bk_filesNumber18+1
      bk_host_addrString10.1.65.63
      bk_host_nameStringicbc-backup1-kylinv10
      bk_node_nameStringbaksvr63
      bk_pathArray["/pool0425/oracleFS1/666D8992-7EBC-4C11-AA05-00764AADEEE1/72BFEFA3-A550-469B-8847-5FDBC0BDD016/icbc-ora12c-sles12-r2_1714298447_72BFEFA3_0/C0/","/pool0425/oracleFS1/666D8992-7EBC-4C11-AA05-00764AADEEE1/98CD5524-C5CF-40CA-8FBF-1A59F7B2E68F/icbc-ora12c-sles12-r2_1714296820_98CD5524_0/C0/"]+1
      bk_rule_nameArray["oracle-rac-data","oracle-rac-log"]+1
      bk_rule_uuidArray["61F978BA-C2A3-4A22-9336-FB9469C7C0AF","0E08AFA8-9787-4485-9256-A4DF9CBBFEEA"]+1
      bk_set_idArray["icbc-ora12c-sles12-r2_1714298447_72BFEFA3_0","icbc-ora12c-sles12-r2_1714296820_98CD5524_0"]+1
      bk_set_sizeNumber0
      bk_sizeNumber208450617632+1
      bk_start_tmNumber1714298447+1
      bk_typeNumber0
      bk_uuidString2EFC948F-1CB5-41AF-9E31-8D93ECE0DF89
      bkup_policyNumber1
      blk_sizeNumber0
      compressedNumber0
      concurrentNumber4
      content_typeNumber0+1
      copy_idNumber0
      data_sourceObject
        vpObject
          vm_idString虚机ID
          vm_nameString虚机名称
          disksArray磁盘配置
            idString磁盘ID
            disk_nameString磁盘名称
            boot_indexNumber磁盘引导顺序
            disk_typeString磁盘类型
            datastore_typeString存储格式
          nicsArray网卡配置
            network_idString网卡ID
            network_nameString网卡名称
            macStringMAC地址
          num_cpusNumbercpu数
          memory_mbNumber内存大小(MB)
          core_per_sockNumber核心数
          vp_uuidString平台UUID
          vp_typeNumber平台类型
0:VMWARE,
1:HYPERV,
2:KVM,
3:I2DRP,
4:ClOUD,
5:OPENSTACK,
6:FF2VM,
7:CAS,
8:HUAWEI,
9:HWCLOUDSTACK
10:FUSIONCOMPUTE
11:WINSTACK
13:AIO
14:ALICLOUD
15:CLOUDOS
16:SCP
17:ZSTACKCLOUD
          file_recoveryNumber是否支持文件恢复
0:否;
1:是;
          instant_recoveryNumber是否支持瞬时恢复
0:否;
1:是;
          detailsString
          stor_encryptNumber备份集加密类型
0:未加密;
1:AES;
2:SM4;
算法可扩展
0
        mssqlObject
          instance_nameString实例名称ins-@first
          db_nameString数据库名称db-@first
          logic_infosArray2-4
            logic_nameString逻辑名称logic-@first
            logic_pathString源路径/@word
            db_file_pathString
          db_sizeString数据库大小
          rt_timeString恢复时间点
        mysqlObject
          instance_nameString实例名称
          backup_methodNumber备份类型:
0:物理备份;
1:逻辑备份;
0-1
          content_typeNumber备份粒度:
0:集群;
1:实例;
2:整库;
3:模式;
4:多表;
(mysq、GaussDWS)
0-4
          multiple_tablesArray表备份:2-4
            db_nameString所属库db@first
            schemasString(mysql无用)
            tablesArray数据表列表["table@first","table@first"]
        pgsqlObject
          instance_nameString
          backup_methodNumber
          content_typeNumber
          db_versionString数据库版本
          pg_recovery_tmNumberunix时间戳,备份集有效恢复时间
        gaussdb_dwsObject
          db_versionString集群版本
          content_typeString备份恢复类型:
0:集群;
1:实例;
2:整库;
3:模式;
4:表;
          multiple_tablesArray备份内容1-3
            db_nameStringdb@first
            schemasString模式schemas@first
            tablesArray["table@first","table@first"]
        obj_storageObject
          wk_dirArray备份目录
          typeNumber对象存储类型
          bucketString桶名称
          uuidString对象存储UUID
          formatNumber存储格式:0:原始格式; 1:打包格式
          dst_osNumber备端操作系统
      dependArray["icbc-ora12c-sles12-r2_1714288452_ED271FE2_0","icbc-ora12c-sles12-r2_1714293686_A8B57604_1"]
      disk_pool_nameStringtest
      dst_osNumber0
      dst_storage_unitObject
        storage_unit_groupNumber0
        storage_unit_nameStringoracleUT1
        storage_unit_typeStringDISKPOOL
        storage_unit_type_numberNumber0
        storage_unit_uuidString16360DBA-B600-4826-BE65-CAF972F09BAD
      dst_storage_unit_groupObject
        storage_unit_nameString
        storage_unit_uuidString
      expire_policyNumber0
      expire_tmNumber1714385326+1
      extendObject
        reservedString
      fileCryptObject
        keyString
        ukey_InfoStringNULL_UKEY_INFO
        valNumber0
      formatNumber1
      fragment_sizeNumber0
      full_job_uuidArray["72BFEFA3-A550-469B-8847-5FDBC0BDD016","98CD5524-C5CF-40CA-8FBF-1A59F7B2E68F"]+1
      i2node_verString9.0.2404242137
      index_serverString10.1.65.65
      job_uuidArray["72BFEFA3-A550-469B-8847-5FDBC0BDD016","98CD5524-C5CF-40CA-8FBF-1A59F7B2E68F"]+1
      media_infoString
      metadata_pathArray["/pool0425/oracleFS1/666D8992-7EBC-4C11-AA05-00764AADEEE1/72BFEFA3-A550-469B-8847-5FDBC0BDD016/icbc-ora12c-sles12-r2_1714298447_72BFEFA3_0/C0/","/pool0425/oracleFS1/666D8992-7EBC-4C11-AA05-00764AADEEE1/98CD5524-C5CF-40CA-8FBF-1A59F7B2E68F/icbc-ora12c-sles12-r2_1714296820_98CD5524_0/C0/"]+1
      primary_copyNumber1
      retentionNumber1
      sched_nameArray["RAC-DATA-FULL","RAC-LOG-FULL"]+1
      src_instanceStringicbc2
      src_osNumber0
      src_typeNumber3
      stageNumber4
      tape_libraryString
      tape_nameArray
        tnameString
      tape_poolString
      tape_snString
      task_uuidArray["61F978BA-C2A3-4A22-9336-FB9469C7C0AF","0E08AFA8-9787-4485-9256-A4DF9CBBFEEA"]+1
      verArray["20240426211959","20240425112318"]+1
      wk_host_addrString10.1.65.57
      wk_host_nameStringicbc-ora12c-sles12-r2
      wk_node_nameStringoracle-rac-n2
      wk_uuidString666D8992-7EBC-4C11-AA05-00764AADEEE1
    expire_tmNumber1714385326+1
    bk_start_tmNumber1714298447+1
    bk_end_tmNumber1714298926+1
    bk_rule_nameArray["oracle-rac-data","oracle-rac-log"]+1
    bk_sizeNumber208450617632+1
    wk_host_nameStringicbc-ora12c-sles12-r2
    wk_node_nameStringoracle-rac-n2
    bk_host_nameStringicbc-backup1-kylinv10
    bk_node_nameStringbaksvr63
    storage_unit_nameStringoracleUT1
    src_typeNumber3
    bk_set_uuidArray["EFF7BA74-3DD6-49D9-B056-DE64F813187B","E91E827B-BE77-4CF6-98D0-999019EC4C0F"]+1
    bk_typeNumber0
    task_typeNumber0
    wk_uuidString666D8992-7EBC-4C11-AA05-00764AADEEE1
    next_copy_idNumber0
    stageNumber4
    tnameNull
    barcodeString
    storage_unit_uuidString16360DBA-B600-4826-BE65-CAF972F09BAD
    deleteNumber0
    deleted_atNumber0
    src_instanceStringicbc2
    task_uuidArray["61F978BA-C2A3-4A22-9336-FB9469C7C0AF","0E08AFA8-9787-4485-9256-A4DF9CBBFEEA"]+1
    storage_unit_group_nameString
    storage_unit_group_uuidString
    sched_nameArray["RAC-DATA-FULL","RAC-LOG-FULL"]+1
    group_nameNull
    dependArray["icbc-ora12c-sles12-r2_1714288452_ED271FE2_0","icbc-ora12c-sles12-r2_1714293686_A8B57604_1"]
    bk_uuidString2EFC948F-1CB5-41AF-9E31-8D93ECE0DF89
    bk_node_delNumber0
    wk_node_delNumber0
    storage_unit_delNumber0
    storage_unit_group_delNumber0
    bk_set_sizeNumber0
    storage_unit_typeNumber3
    is_biz_adminNumber1
    can_delNumber1
    can_opNumber1
    can_upNumber1
    os_typeNumber1
    instance_nameString备份数据库实例名称
    db_nameString备份数据库名称
    backup_methodNumber备份类型:
0:物理备份
1:逻辑备份
    content_typeNumber备份粒度:
0:集群;
1:实例;
2:整库;
3:模式;
4:多表;
(mysq、GaussDWS)
    tape_pool_nameString磁带池名称
    disk_pool_nameString磁盘池名称
  totalNumber2
  data_sumNumber208608952736

备份集管理 - 获取列表查询候选信息

SDK方法名:listQueryArgsBackupSet

URL

/backup_set/query_args

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
search_fieldString搜索字段名(仅限可以条件查询的)
search_valueString搜索内容
deleteNumber是否为已删除菜单,0:否,1:是

Response

名称类型必选简介Mock初始值Mock规则
retString
msgString
dataObject
  codeString
  totalString
  info_listArray对应模糊搜索结果(根据系统设置分页)

备份集管理 - 操作

SDK方法名:operateBackupSet;

URL

/backup_set/operate

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
bk_set_listArray备份集uuid数组
  bk_set_uuidString备份集uuid
  expire_tmString过期时间(延长期限操作)
operateStringextend:延长期限
expire:立即过期
set_primary:设为主副本
extend
forceNumber是否强制过期,0:关,1:开

Response

名称类型必选简介Mock初始值Mock规则
retNumber
msgString
dataObject
  success_listArray
    codeString
    messgaeString
    bk_set_idString
    copy_idString
  fail_listArray
    codeString
    messageString
    bk_set_idString
    copy_idString
  all_listArray
    codeString
    messageString
    bk_set_idString
    copy_idString

备份集管理 - 手动删除

SDK方法名:deleteDbBackupSet

URL

/backup_set

Method

DELETE

Request

名称类型必选简介Mock初始值Mock规则
uuidsArray备份集uuid列表
forceString是否强制删除,0:否,1:是

Response

名称类型必选简介Mock初始值Mock规则
retNumber
msgString
dataObject
  success_listArray
    codeString
    messgaeString
    bk_set_idString
    copy_idString
  fail_listArray
    codeString
    messageString
    bk_set_idString
    copy_idString
  all_listArray
    codeString
    messageString
    bk_set_idString
    copy_idString

备份集管理 - 手动强制清理

SDK方法名:manualForceDeleteDbBackupSet

URL

/backup_set/force_delete

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
uuidsArray备份集uuid列表

Response

名称类型必选简介Mock初始值Mock规则
retNumber
msgString
dataObject
  success_listArray
    codeString
    messgaeString
    bk_set_idString
    copy_idString
  fail_listArray
    codeString
    messageString
    bk_set_idString
    copy_idString
  all_listArray
    codeString
    messageString
    bk_set_idString
    copy_idString

备份集管理 - 标记删除(内部程序调用)

SDK方法名:deleteBackupSet

URL

/backup_set/delete

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
bk_set_listArray备份集id数组
  bk_set_idString备份集id
  bk_rule_uuidString备份集规则uuid
  copy_idString副本id
delete_from_dbNumber是否直接从库内删除,0:否,1:是

Response

名称类型必选简介Mock初始值Mock规则
retNumber
msgString
dataObject
  success_listArray
    codeString
    messgaeString
    bk_set_idString
    copy_idString
  fail_listArray
    codeString
    messageString
    bk_set_idString
    copy_idString
  all_listArray
    codeString
    messageString
    bk_set_idString
    copy_idString

备份集复制 - 提交复制规则

SDK方法名:createBackupSetRepRule

URL

/backup_set/rule

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
bk_set_uuidsArray备份集uuid数组
unit_uuidString存储单元uuid
tape_pool_uuidString磁带池uuid
retention_levelString保留等级
start_timeNumber启动时间戳

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  all_listArray
    codeString
    messageString
    bk_set_idString
  fail_listString
  success_listString

备份集管理 - 单个

SDK方法名:describeBackupSet;

URL

/backup_set/single

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
bk_set_uuidString备份集uuid
bk_set_idString备份集id(bk_set_uuid空时,必传)

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString[0] 操作成功。
  backup_setObject
    bk_set_idStringi2bbdev_1719369205_F22BD3CA_0
    bk_rule_uuidString961C9E98-2E76-4139-890A-F5EDAEF1B9B8
    copy_idNumber0
    primary_copyNumber1
    created_atNumber1719370015
    verString961C9E98-2E76-4139-890A-F5EDAEF1B9B8 - 1719368627
    expire_tmNumber1719974158
    bk_start_tmNumber1719369237
    bk_end_tmNumber0
    bk_rule_nameString备份规则名1453磁带bak
    bk_sizeNumber备份大小70496278
    wk_host_nameString客户端主机名
    wk_node_nameString客户端名称135.37-i2bb
    bk_host_nameString服务器主机名
    bk_node_nameString服务器名称
    storage_unit_nameString磁带带库12
    src_typeNumber源数据类型,
1: file,
2: vp(虚拟机)
3: oracle
4:HDFS
5:HIVE
21: oracle rac
22: GaussDB(HCS)
23: PostgreSQL
24: OceanBase
25: PolarDB
26: S3
27: FusionCompute
28: GaussDB(DWS)
29:mssql
30:ffo(整机)
31. mysql
32. dm
4
    bk_set_uuidString0EB9CC93-6225-4CBB-8059-BCBFA8D91866
    bk_typeNumber备份策略中的备份类型:
0全备;1增量;2差异;3:预留;4:日志
0
    task_typeNumber任务类型:
0:备份;
1:恢复;
0
    wk_uuidStringA7830B7D-084E-48A1-A153-69F17CA6EB16
    next_copy_idNumber0
    stageNumber状态4
    tnameNull
    barcodeString/var/i2data/bakmetadata/A7830B7D-084E-48A1-A153-69F17CA6EB16/F22BD3CA-5D11-472B-96CF-1F8B41402A88/i2bbdev_1719369205_F22BD3CA_0/C0
    storage_unit_uuidString614F317A-E3A6-407C-8D03-A7F23CFD081E
    deleteNumber0
    deleted_atNumber0
    src_instanceNull
    content_typeNull
    task_uuidStringF22BD3CA-5D11-472B-96CF-1F8B41402A88
    storage_unit_group_nameString
    storage_unit_group_uuidString
    sched_nameStringds
    group_nameNull业务组名
    dependNull
    bk_uuidString73FA2775-A5CA-47A8-A8AA-C871DBAB9C83
    bk_node_delNumber0
    wk_node_delNumber0
    storage_unit_delNumber0
    storage_unit_group_delNumber0
    bk_set_sizeNumber70496278
    storage_unit_typeNumber2
    protocol_versionNumber2
    storage_bk_pathNull存储介质
    work_dir_listNull客户端保护对象
    expire_policyNumber备份集删除策略0
    bk_host_addrString客户端地址10.1.132.136
    wk_host_addrString服务器地址10.1.135.37
    bk_chain_idStringF22BD3CA-5D11-472B-96CF-1F8B41402A88
    biz_grp_nameArray
    biz_grp_listArray
    is_biz_adminNumber1
    can_delNumber1
    can_opNumber1
    can_upNumber1
    can_viewNumber1
    bk_filesString备份文件数

备份集管理 - 已删除备份集 单个

SDK方法名:describeDeletedBackupSet

URL

/backup_set/single_deleted

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
bk_set_uuidString备份集uuid

Response

名称类型必选简介Mock初始值Mock规则
retString
msgString
dataObject
  backup_setObject

备份集管理 - 查看副本

SDK方法名:describeBackupSetCopy

URL

/backup_set/copy_list

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
bk_set_uuidString备份集uuid
pageNumber1
limtNumber10
search_fieldString
search_valueString

Response

名称类型必选简介Mock初始值Mock规则
retString
msgString
dataObject
  codeString
  messageString
  info_listArray
    xxxObject

备份集复制 - 列表

SDK方法名:listBackupSetRule

URL

/backup_set/rule

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
pageNumber1
limtNumber10
search_fieldStringprimary_copy
search_valueString0:非主副本
1:主副本
1

Response

名称类型必选简介Mock初始值Mock规则
retString
msgString
dataObject
  codeString
  totalString
  info_listArray10

备份集管理 - 验证

SDK方法名:validateBackupSet

URL

/backup_set/verify

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
bk_set_uuidsArray备份集uuid
modeString63 简单验证
64 详细验证

Response

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

备份集管理 - 过期当前主副本 & 更新最小副本号备份集为主副本(内部程序调用)

SDK方法名:resetPrimaryBackupSet;

URL

/backup_set/reset_primary

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
bk_set_idString备份集id
bk_rule_uuidString备份规则uuid
expire_tmNumber过期时间时间戳(如果不传则不更新)

Response

名称类型必选简介Mock初始值Mock规则
retNumber
msgString
dataObject
  codeString0:成功,其他:失败
  messageString
  prev_bk_set_idString前主副本备份集id
  prev_copy_idString前主副本副本id
  prev_bk_rule_uuidString前主副本备份规则uuid
  next_bk_set_idString新主副本备份集id
  next_copy_idString新主副本副本id
  next_bk_set_uuidString新主副本备份规则uuid

备份集管理 - 查看备份链

SDK方法名:listBackupChain

URL

/backup_set/backup_chain

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
bk_set_uuidString备份集uuid
backup_chain_policyNumber恢复时使用
1: 策略1
2: 策略2
3: 策略3
4: 策略4
bk_server_uuidString策略4时需要下发,备份服务器uuid
bk_server_addrString策略4时需要下发,备份服务器地址

Response

名称类型必选简介Mock初始值Mock规则
retString200
msgString
dataObject
  info_listArray格式同备份集列表
  totalString

备份集管理 - 演练

SDK方法名:drillBackupSet

URL

/backup_set/drill

Method

POST

Request

名称类型必选简介Mock初始值Mock规则
vp_uuidString演练平台uuid
drill_listArray
  bk_set_uuidString备份集uuid
  orch_vm_nameString演练虚机名称
  scripts_typeNumber脚本验证的方式:
0:ping验证;
1:tcp端口验证;
2:脚本验证方式
  scriptsString验证内容
  new_flavor_idString云平台演练 - 规格ID
  new_network_idString云平台演练 - 网络ID
  new_network_nameString云平台演练 - 网络名称
  cpuNumbercpu数量
  core_per_sockNumbercpu核心数
  mem_mbNumber内存
auto_drillNumber自动演练:
0:否;
1:是;
0

Response

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

获取(存在备份集的)实例客户端列表

SDK方法名:listSrcClient;

src_type必传,其余参数参照创建规则时默认获取所有备份集所传递的过滤参数

URL

/backup_set/list_src_client

Method

GET

Request

名称类型必选简介Mock初始值Mock规则
where_args[src_type]Number源数据类型:
4:mssql;
9:mysql;
23:PostgreSQL;
28:GaussDWS;

Response

名称类型必选简介Mock初始值Mock规则
retNumber200
msgString
dataObject
  codeNumber0
  messageString
  listArray2-4
    node_uuidString客户端节点UUID@uuid
    node_nameString客户端节点名称node-@first
    gauss_db_versionStringgaussdws集群版本
    instance_listArray实例列表3
      instance_nameStringins-@first
      db_listArray数据库列表['zxcv', 'qwer']
Last update: 8/1/2024, 2:00:50 PM
Contributors: ganl