磁带管理

SDK类名：/resource/Tape;

示例接口

示例接口描述

URL

/example/1691976311143

Method

GET

Request

名称	类型	必选	简介	Mock初始值	Mock规则
foo	String		请求属性示例	@ctitle

Response

名称	类型	必选	简介	Mock初始值	Mock规则
string	String		字符串属性示例	★	1-10
number	Number		数字属性示例	1	1-100
boolean	Boolean		布尔属性示例	true	1-2
regexp	RegExp		正则属性示例	/[a-z][A-Z][0-9]/
function	Function		函数属性示例	() => Math.random()
array	Array		数组属性示例		1-10
foo	Number		数组元素示例	1	+1
bar	String		数组元素示例	★	1-10
items	Array		自定义数组元素示例	[1, true, 'hello', /\w{10}/]
object	Object		对象属性示例
foo	Number		对象属性示例	1	+1
bar	String		对象属性示例	★	1-10
placeholder	String		占位符示例	@title

磁带库 - 扫描

SDK方法名：sanTapeLibraries;

URL

/tape_library/scan

Method

GET

Request

名称	类型	必选	简介	Mock初始值	Mock规则
bk_uuids	Array		备份服务器名称

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success
library_info|4	Array
checked	Boolean
bk_uuid	String		备份服务器uuid	D42BF707-C971-EEA9-521F-BB0F3F7A92FC
bk_node_name	String		备份服务器名称	备份服务器1
library_sn	String		序列号	SYZZ_A
library_vendor	String		厂商	STK
library_product	String		带库型号	L80
library_revision	String		产品版本	0106
dev_path	String		设备路径	/dev
drive_num	Number		驱动器数	1
slot_num	Number		槽数	1
added	Number		是否已被添加过 0否1是
library_uuid	String		已添加带库uuid

磁带库 - 获取带库驱动器列表

SDK方法名：listTapeLibraryDrivers;

URL

/tape_library/drivers

Method

POST

Request

名称	类型	必选	简介	Mock初始值	Mock规则
list	Array		【可选】配置驱动器时调用
bk_uuid	String
library_sn	String
library_uuid	String		【可选】带库列表点击驱动器管理时调用

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success
library_name	String		带库名称
ctrl_host_name	String		控制主机名称
info_list|2	Array
bk_uuid	String		带库对应节点
bk_node_name	String
library_sn	String		带库序列号	DDQQ
driver_list|2	Array		从带库对应节点上面获取到的驱动信息
checked	Boolean
index	String			1
barcode	String		磁带 空显示EMPTY	DDAA
driver_sn	String
dev_path	String			path_more
status	String		1 - ACTIVE, 已用 2 - UP, 空闲 3 - MANU_DOWN 禁用(手动) 4 - AUTO_DOWN 禁用(系统)
last_write	String
time_error	String
use_host	String		当前使用主机	admin

磁带库 - 新建

SDK方法名：createTapeLibrary;

URL

/tape_library

Method

POST

Request

名称	类型	必选	简介	Mock初始值	Mock规则
library_name	String		磁带带库名(逻辑上的)	磁带库1
comment	String		说明	说明
bk_uuid_list	Array		备份服务器 这里下发的是带库所在的备机列表	["D42BF707-C971-EEA9-521F-BB0F3F7A92FC"]
ctrl_host_uuid	String		控制机主机uuid
library_sn	String		控制机主机关联带库 序列号
library_vendor	String		控制机主机关联带库 厂商
library_product	String		控制机主机关联带库 产品型号
library_revision	String		控制机主机关联带库 产品版本
drive_num	String		控制机主机关联带库 驱动器数
slot_num	String		控制机主机关联带库 槽数
dev_path	String		控制机主机关联带库 设备路径
library_list	Array		带库列表 带库与节点的关系是一对多
checked	Boolean		是否选为控制主机 - false否true是
bk_uuid	String		备份服务器uuid	'D42BF707-C971-EEA9-521F-BB0F3F7A92FC'
library_sn	String		序列号	SYZZ_A
library_vendor	String		厂商	STK
library_product	String		产品型号	L80
library_revision	String		产品版本	0106
drive_num	Number		驱动器数	1
slot_num	Number		槽数	1
dev_path	String		设备路径	/dev
driver_info	Array
bk_uuid	String
library_sn	String
driver_list	Array		配置驱动器的配置信息 对应的是否选择 0否1是
checked	String		是否勾选
index	String
barcode	String
driver_sn	String
dev_path	String
status	String
last_write	String
robotic_arm_info	Array		机械臂主机列表信息
slave	Number		0 - 下发到控制主机、机械臂主机、从机 1 - 只下发到从机

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success

磁带库 - 列表

SDK方法名：listTapeLibrary;

URL

/tape_library

Method

GET

Request

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

Response

名称	类型	必选	简介	Mock初始值	Mock规则
data	Object
count	Number			10
info_list	Array
ctrl_host_uuid	String			@uuid
ctrl_host_name	String			控制机主机名
library_name	String			磁带库名
library_uuid	String		一个uuid对应多个库 一对多	磁带库uuid
library_sn	String			@string
library_vendor	String			STK
library_revision	String			@int(100, 10000)
drive_num	Number			1
slot_num	Number			1
total	Number			1
code	Number			0
message	String
msg	String
ret	Number			200

磁带库 - 单个

SDK方法名：describeTapeLibrary;

URL

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

Method

GET

Request

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

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
message	String
tape_library	Object
library_name	String			磁带库1
library_uuid	String
comment	String			说明
bk_uuid_list	Array			["D42BF707-C971-EEA9-521F-BB0F3F7A92FC"]
random_str	String
library_list	Array
ctrl_host	Number			1
node_uuid	String			'D42BF707-C971-EEA9-521F-BB0F3F7A92FC'
library_sn	String			SYZZ_A
library_vendor	String			STK
library_product	String			L80
library_revision	String			0106
drive_num	Number			1
slot_num	Number			1
dev_path	String			/dev
user_uuid	String
code	Number			0

磁带库 - 修改

SDK方法名：modifyTapeLibrary;

URL

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

Method

PUT

Request

名称	类型	必选	简介	Mock初始值	Mock规则
library_name	String			磁带库1
library_uuid	String
random_str	String
comment	String			说明
bk_uuid_list	Array			["D42BF707-C971-EEA9-521F-BB0F3F7A92FC"]
curl_host_uuid	String
library_sn	String
library_vendor	String
library_product	String
drive_num	String
library_revision	String
dev_path	String
slot_num	String
library_list	Array
checked	Number
bk_uuid	String			'D42BF707-C971-EEA9-521F-BB0F3F7A92FC'	true
library_sn	String			SYZZ_A
library_vendor	String			STK
library_product	String			L80
library_revision	String			0106
drive_num	Number			1
slot_num	Number			1
dev_path	String			/dev
driver_info	Array
bk_uuid	String
library_sn	String
driver_list	Object
checked	String
index	String
barcode	String
driver_sn	String
status	String
dev_path	String
last_write	String

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success

磁带库 - 删除

SDK方法名：deleteTapeLibrary;

URL

/tape_library

Method

DELETE

Request

名称	类型	必选	简介	Mock初始值	Mock规则
library_uuids	Array		带库uuid列表
force	Number		是否强制删除 0否1是

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success

磁带库 - 清点 - 刷新

SDK方法名：refreshTapeLibrarySlot;

URL

/tape_library/refresh_slot

Method

POST

Request

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

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
task_uuid	String		刷新任务uuid
message	String			[0] 操作成功
code	Number			0

磁带库 - 清点 - 扫描插槽(废弃)

SDK方法名：scanSlot;

URL

/tape_library/scan_slot

Method

GET

Request

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

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success
slots_info|3	Array
slot_index	String			1
slot_barcode	String			xxxx

磁带库 - 出库 - 获取Slot

SDK方法名：listBusySlot;

URL

/tape_library/busy_slot

Method

GET

Request

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

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success
slots_busy_info	Array
index	String
barcode	String

磁带库 - 入库 - 扫描I/O插槽

SDK方法名：listBusyIeSlot;

URL

/tape_library/busy_ie_slot

Method

GET

Request

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

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success
ieslots_busy_info	Array
index	String
barcode	String

磁带库 - 操作

SDK方法名：operateTapeLibrary;

URL

/tape_library/operate

Method

POST

Request

名称	类型	必选	简介	Mock初始值	Mock规则
operate	String		import - 入库-移动磁带到插槽
library_uuids	Array		带库uuid
list	Array		【可选】入库 - 移动磁带到插槽时用
ieslot_index	String		ieslot
ieslot_barcode	String		ieslot

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success
slot_index	Array		入库-移动到插槽后返回，界面依次显示到插槽列

磁带库 - 驱动器管理 - 操作

SDK方法名：operateTapeLibraryDrivers;

URL

/tape_library/drivers_operate

Method

POST

Request

名称	类型	必选	简介	Mock初始值	Mock规则
operate	String		enable - 启用禁用 move - 装载卸载
library_uuid	String		带库uuid
driver_index	String		驱动器索引
slot_index	String		【可选】磁带索引 装载卸载必选
slot_flag	String		【可选】磁带状态 装载卸载必选
status	String		【必传】驱动器状态
driver_sn	String		【可选】驱动器序列号 启用禁用必选
dev_path	String		【可选】设备路径 启用禁用必选
barcode	String		【可选】Empty表示装载，其他表示卸载
tape_uuid	String		【可选】磁带uuid 装载需要

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success

介质 - 磁带池列表

SDK方法名：listTapePools;

URL

/tape_media/tape_pools

Method

GET

Request

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

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
pool_list|3	Array
pool_name	String
comment	String
note	String			name
pool_uuid	String			E95CB20B-917C-57F4-F926-751ECE95F861
random_str	String
code	Number			0
message	String			success

介质 - 磁带池 - 新建

SDK方法名：createTapePool;

URL

/tape_media/tape_pool

Method

POST

Request

名称	类型	必选	简介	Mock初始值	Mock规则
pool_name	String		磁带池名 rpc下发用 不可修改
comment	String		可修改
note	String		备注，可修改，界面展示用 类似微信用户备注

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success

介质 - 磁带池 - 修改

SDK方法名：updateTapePool;

URL

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

Method

PUT

Request

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

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success

介质 - 磁带池 - 删除

SDK方法名：deleteTapePool;

URL

/tape_media/tape_pool

Method

DELETE

Request

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

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success

介质 - 磁带 - 操作

SDK方法名：operateTapeMedia;

URL

/tape_media/operate

Method

POST

Request

名称	类型	必选	简介	Mock初始值	Mock规则
list	Array
library_uuid	String		带库uuid
slot_index	String		插槽index
slot_barcode	String		磁带序列号
slot_tapename	String		【可选】重构需要
slot_tapesequence	String		【可选】重构需要
pool_name	String		【可选】重构需要
freeze	String		0是解冻，1是冻结
operate	String		freeze - 冻结/解冻 browse - 浏览 rebuild - 重构 export - 出库 move - 移动 refresh - 更新介质 format - 格式化 - 不支持 erase - 擦除
src_pool_name	String		【可选】移动时必传 源磁带池名
dst_pool_name	String		【可选】移动时必传 目标磁带池名
backupset_info	Array		擦除所需参数，定义参考接口：https://apiref.info2soft.com/organization/repository/editor?id=21&mod=470&itf=5593
copy_id	Number
bk_set_id	String
stage	Number

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success
task_uuids	Array		异步任务uuid，根据该uuid查询异步任务结果状态，状态完成后调用task_

介质 - 磁带 - 列表

SDK方法名：listTapeMedia;

URL

/tape_media

Method

GET

Request

名称	类型	必选	简介	Mock初始值	Mock规则
where_args[library_uuid]	String		根据带库过滤
where_args[pool_name]	String		根据磁带池名过滤
where_args[outbound]	Number		1表示已出库过滤
where_args[slot_tapename]	String		按磁带组名过滤
like_args[bk_rule_name]	String		备份集过滤，多个逗号隔开
like_args[slot_barcode]	String		按条形码过滤 多个逗号割开
where_args[slot_flag]	String		状态过滤： 装载 - 获取磁带列表： BLANK - 可用 ACTIVE - 存在数据 FULL - 满 卸载 - 获取磁带列表： EMPTY - 没有磁带 【无法调度的状态】 UNKNOWN_DATA ACTIVE FULL
type	Number		【可选】 点击刷新按钮时必选，其他不传 0-获取全部磁带信息 1-获取有效磁带信息 2-获取自由磁带信息
flag	Number		【可选】 点击刷新按钮时必选，其他不传 筛选磁带状态 0-不筛选 1-只获取KNOWN状态的磁带 2-只获取BLANK状态的磁带 3-只获取UNKNOWN状态的磁带
content_init	String		【可选】入库初始状态-BLANK 无法调度的磁带

Response

名称	类型	必选	简介	Mock初始值	Mock规则
data	Object
count	Number			10
info_list|2	Array
library_name	String		磁带库名称	磁带库名称1
library_uuid	String		磁带库uuid	0B2421D6-C6C1-C3C1-ECEF-C484B69C6878
slot_index	String		索引	1
slot_flag	String		状态 OUTBOUND - 已出库 底层接口： https://apiref.info2soft.com/organization/repository/editor?id=21&mod=470&itf=6230
slot_barcode	String		条形码	xxxx
slot_tapename	String		磁带名	磁带名1
slot_tapesequence	String		组内序号	12345
slot_mtype	String		型号
dst_type	String		归档目标类型
pool_name	String		磁带池名称	磁带池名称1
user_uuid	String
status	String		状态 冻结 - 界面显示冻结 0否1是 返回1显示冻结，返回0则显示slot_flag对应的状态	0
write_protected	Number		是否开启写保护 0 - 否 1 - 是
slot_expiretime	Number		过期时间	1706255405
total	Number			1
code	Number			0
message	String
msg	String
ret	Number			200

查看磁带

SDK方法名：listTapeMediaBkData;

URL

/tape_media/bkdata

Method

GET

Request

名称	类型	必选	简介	Mock初始值	Mock规则
slot_barcode	String	是	磁带条形码
limit	String	是	页大小；默认打开时15页
page	String	是	页号
begin_time	String	否	开始时间
end_time	String		结束时间；两个时间有一个为空就不筛选
check_rule	Number		【预留】是否检查规则 0 - 不检查 【磁带库跳转】 1 - 检查【规则跳转】
task_uuid	String		【预留】备份任务uuid

Response

名称	类型	必选	简介	Mock初始值	Mock规则
msg	String	是
ret	Number	是		200
data	Object	是
code	Number	是		0
message	String	是
info_list	Array	是
slot_list	Array		session所在磁带信息列表
slot_index	String		slot索引
slot_barcode	String		磁带条形码
slot_flag	String		磁带状态
slot_tapename	String		磁带组名
bk_index	String		数据编号
bk_path	String		数据内容
bk_time	String		备份时间
archive_result	Number		备份结果	1
archive_size	String		备份数据量
slot_index	String		Slot索引
slot_barcode	String		磁带条形码
slot_tapesequence	String		组内序号
bk_set_id	String		备份任务ID
total	Number	是	记录总数	1

查看磁带 - 磁带数据

SDK方法名：listTapeMediaBkFiles;

URL

/tape_media/bkfiles

Method

GET

Request

名称	类型	必选	简介	Mock初始值	Mock规则
slot_barcode	String	是	磁带条形码
bk_index	String	是	备份编号
bk_path	String	是	备份路径
limit	String		每页条目数
page	String		页码

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number	是		200
msg	String	是
data	Object	是
code	Number	是		0
message	String	是
info_list	Array	是	备份数据文件列表
file_path_name	String		文件路径名
total	Number	是	总条目数	1

查看磁带 - 磁带详情

SDK方法名：listTapeMediaDetails;

URL

/tape_media/details

Method

GET

Request

名称	类型	必选	简介	Mock初始值	Mock规则
slot_barcode	String		磁带条形码
bk_index	String		备份编号
bk_path	String		备份路径
limit	Number		页条数
page	Number		页码

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			[0] 操作成功。
info_list	Object
bk_end_tm	Number			0
bk_files	Number			0
bk_host_addr	String			192.168.31.33
bk_host_name	String			admin
bk_node_name	String			192.168.31.33Tape
bk_path	String
bk_rule_name	String			4448FULL
bk_rule_uuid	String			B15A3BA8-7B4C-4B4D-9E8B-13ACC3D8223A
bk_set_id	String			admin_1701681738
bk_size	Number			0
bk_start_tm	Number			0
bk_type	Number			0
bk_uuid	String
bkup_policy	Number			0
blk_size	Number			0
compressed	Number			0
concurrent	Number			0
content_type	Number			0
copy_id	Number			0
disk_pool_name	String
dst_os	Number			0
dst_storage_unit	Object
storage_unit_group	Number			0
storage_unit_name	String			tape
storage_unit_type	String			TAPELIBRARY
storage_unit_type_number	Number			2
storage_unit_uuid	String
expire_policy	Number			0
expire_tm	Number			371086875969246
extend	Object
reserved	String
fileCrypt	Object
key	String
ukey_Info	String
val	Number			0
format	Number			0
fragment_size	Number			0
i2node_ver	String
index_server	String
job_uuid	String			45197C24-558E-4F7C-8E05-B6462100638E
metadata_path	String
primary_copy	Number			0
retention	Number			0
src_instance	String
src_os	Number			0
src_type	Number			1
stage	Number			0
tape_info	Array
tape_library	String
tape_name	Array
tape_pool	String
tape_sn	String
task_uuid	String
ver	String
wk_dir	Array			["/var/i2data/log/bakup_sysrun_2023-11-20.log","/var/i2data/log/bakup_sysrun_2023-11-21.log","/var/i2data/log/bakup_sysrun_2023-11-22.log","/var/i2data/log/bakup_sysrun_2023-11-23.log","/var/i2data/log/bakup_sysrun_2023-11-24.log"]
wk_host_addr	String			192.168.31.33
wk_host_name	String			admin
wk_node_name	String			192.168.31.33Tape
wk_uuid	String			555B77D1-86D6-4D14-8395-ED30266C1D85
barcode	String			F01034L5

磁带库 - 发现新带库

SDK方法名：refreshTapeLibrary;

URL

/tape_library/refresh

Method

GET

Request

名称	类型	必选	简介	Mock初始值	Mock规则
bk_uuids	Array		备份服务器uuid列表

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success
info_list	Array
bk_uuid	String		备份服务器uuid
task_uuid	String		异步任务uuid
code	String		rpc调用结果，获取不到task_uuid时会报错，界面可以先判断下这个错误码

磁带库 - 机械臂主机列表

SDK方法名：listTapeLibraryRoboticArm;

URL

/tape_library/robotic_arm_list

Method

GET

Request

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

Response

名称	类型	必选	简介	Mock初始值	Mock规则
ret	Number			200
msg	String
data	Object
code	Number			0
message	String			success
robotic_arm_info	Array		机械臂列表信息
bk_uuid	String		机械臂主机uuid	D42BF707-C971-EEA9-521F-BB0F3F7A92FC
bk_node_name	String		机械臂主机名称	备份服务器1
library_sn	String		带库序列号	SYZZ_A
library_product	String		带库型号	L80
drive_num	Number		驱动器数量	1
slot_num	Number		槽数	1
dev_path	String		设备路径	/dev
checked	Boolean		是否勾选	false
server_type	Number		是否可用作机械臂主机	0