业务组管理
November 23, 2021About 6 min
业务组管理
对分组关系的处理有两个入口，可以从相应资源的【获取列表】、【新建】、【编辑】接口下通过 biz_grp_list 字段更新分组关系，也可以在【分组管理】页面通过【分组关系-更新绑定】接口处理； SDK类名：/resource/BizGroup;
下面接口为【分组管理】页面所用，
1 分组-1 添加
SDK方法名：createBizGroup;
类型，
注：3-0 与 3:(0:xxx) 都表示参数 type: 3, subtype: 0，区别是3-0表示必须传，而()是可选的；
1-0：节点；1-1：集群；1-3：Dtrack节点；
2：比较；
3：复制规则（0：普通；1：集群；10：模板）；
4：恢复（0：普通；1：CDP；2：快照）；
5-1：全服迁移；5-3：全服备份；5-5：全服恢复；
6-0：定时备份；6-1：定时备份-还原；
7：NAS同步；
8：虚平台（0：Vmware；1：h3c；2：openstack）；
9：虚备份；
10：虚恢复；（0：普通；1：瞬时）
11-1：虚迁移；11-0：复制；
12: 虚文件恢复
13：平台监控；
14：DTO存储；
15：DTO主机；
16：DTO规则；
17：Dtrack策略；
18：存储管理；
19：VP演练平台；
20：VP演练规则；
URL
//biz_grp
Method
POST
Request
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| biz_grp | Object | 否 | |||
| comment | String | 否 | 123 | 说明 | |
| grp_name | String | 否 | grp_name | 组名 | |
| subtype | Number | 否 | 0 | 该模块下的子类型，没子类型传默认0，详情如上； | |
| type | Number | 否 | 1 | 分组所属模块类型，范围1-13，详情如上 |
Response
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 否 | 200 | @mock=200 | |
| msg | String | 否 | @mock= | ||
| data | Object | 否 | |||
| message | String | 否 | [0] 操作成功 | @mock=[0] 操作成功 | |
| code | Number | 否 | 0 | @mock=0 |
1 分组-2 更新
SDK方法名：modifyBizGroup;
URL 中 [A-F0-9-]+ 为 grp_uuid;
URL
//biz_grp/:uuid([A-F0-9-]+)
Method
PUT
Request
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| biz_grp | Object | 否 | |||
| comment | String | 否 | 123 | 说明 | |
| grp_name | String | 否 | grp_name | 组名 | |
| subtype | Number | 否 | 10 | 该模块下的子类型，没子类型传默认0，详情如上； | |
| type | Number | 否 | 3 | 分组所属模块类型，范围1-12，详情如上 |
Response
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 否 | 200 | @mock=200 | |
| msg | String | 否 | @mock= | ||
| data | Object | 否 | |||
| code | Number | 否 | 0 | @mock=0 | |
| message | String | 否 | [0] 操作成功 | @mock=[0] 操作成功 |
1 分组-3 获取单个
SDK方法名：describeBizGroup;
URL 中 [A-F0-9-]+ 为 grp_uuid;
URL
//biz_grp/:uuid([A-F0-9-]+)
Method
GET
Request
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|
Response
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 否 | 200 | @mock=200 | |
| data | Object | 否 | |||
| biz_grp | Object | 否 | |||
| grp_name | String | 否 | grp_name | 组名 | |
| subtype | Number | 否 | 10 | 该模块下的子类型，没子类型传默认0，详情如上； | |
| type | Number | 否 | 3 | 分组所属模块类型，范围1-12，详情如上 | |
| comment | String | 否 | 123 | 评论 | |
| grp_uuid | String | 否 | C23BD84A-3895-0F06-4478-2312E022F8F0 | 分组uuid | |
| message | String | 否 | [0] 操作成功 | @mock=[0] 操作成功 | |
| code | Number | 否 | 0 | @mock=0 | |
| msg | String | 否 | @mock= |
1 分组-5 删除
SDK方法名：deleteBizGroup
URL
//biz_grp
Method
DELETE
Request
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| grp_uuids | Array | 否 | ["11111111-1111-1111-1111-111111111111"] |
Response
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| msg | String | ||||
| data | Object | ||||
| code | Number | 11110001 | |||
| message | String | ||||
| fail_list | Array | ||||
| code | Number | 11110001 | |||
| message | String | [-1] 离线 | |||
| grp_uuid | String | @guid | |||
| grp_name | String | test2 | |||
| success_list | Array | ||||
| code | Number | 11110001 | |||
| message | String | [0] success | |||
| grp_uuid | String | @guid | |||
| grp_name | String | test1 | |||
| ret | Number | 200 |
1 分组-4 获取列表
SDK方法名：listBizGroup;
可以搜索的字段：都能搜；
获取列表详细入参说明详见【节点管理-获取节点列表】接口说明；
URL
//biz_grp
Method
GET
Request
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| limit | Number | 否 | 可选，不传就是全部 | ||
| search_field | String | 否 | 可选，搜索字段 | ||
| search_value | String | 否 | 可选，搜索字段对应值（可以模糊） | ||
| direction | String | 否 | ASC : 正向; DESC: 反向; RANDOM: 随机; | ||
| order_by | String | 否 | 用哪个字段排序 | ||
| page | Number | 否 | 可选，不传就是全部 |
Response
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| data | Object | 否 | |||
| info_list | Array | 否 | 2 | ||
| type | Number | 否 | 4 | 分组所属模块类型，范围1-12，详情如上 | |
| subtype | Number | 否 | 0 | 该模块下的子类型，没子类型传默认0，详情如上； | |
| grp_uuid | Array | 否 | [ | ||
| "C23BD84A-3895-0F06-4478-2312E022F8F0", | |||||
| "C23BD84A-3895-0F06-4478-2312E022F8F1" | |||||
| ] | 分组uuid | +1 | |||
| grp_name | String | 否 | grp_name | 组名 | |
| comment | String | 否 | 123 | 评论 | |
| code | Number | 否 | 0 | ||
| message | String | 否 | [0] 操作成功 | ||
| total | Number | 否 | 1 | ||
| msg | String | 否 | |||
| ret | Number | 否 | 200 |
2 分组关系-1 更新绑定
SDK方法名：updateBizGroupBind;
更新 某个组绑定的res；URL 中 [A-F0-9-]+ 为 grp_uuid；
对分组关系的处理有两个入口，可以从相应资源的【获取列表】、【新建】、【编辑】接口下通过 biz_grp_list 字段更新分组关系，也可以在【分组管理】页面通过【分组关系-更新绑定】接口处理；
下面接口为【分组管理】页面所用，
URL
//biz_grp/:uuid([A-F0-9-]+)/bind
Method
PUT
Request
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| uuids | Array | 否 | ["67E33CDB-D75B-15B3-367D-50C764F5A26F"] | 被绑定给该组的uuid数组，必须为同一类型，例如节点则对应节点uuid； |
Response
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| msg | String | 否 | |||
| ret | Number | 否 | 200 | ||
| data | Object | 否 | |||
| message | String | 否 | [0] 操作成功 | ||
| code | Number | 否 | 0 |
2 分组关系-2 获取绑定情况
SDK方法名：listBizGroupBind;
分组管理页面修改绑定关系；URL 中 [A-F0-9-]+ 为 grp_uuid；获取所有 res 并用 is_bound 标记是否与该 grp_uuid 绑定
URL
//biz_grp/:uuid([A-F0-9-]+)/bind
Method
GET
Request
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|
Response
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 否 | 200 | ||
| msg | String | 否 | |||
| data | Object | 否 | |||
| code | Number | 否 | 0 | ||
| message | String | 否 | [0] 操作成功 | ||
| info_list | Array | 否 | 10 | ||
| uuid | String | 否 | @guid | ||
| name | String | 否 | N4_72.76 | ||
| type | Number | 否 | 1 | ||
| subtype | Number | 否 | 0 | ||
| create_time | Number | 否 | 1527661249 | ||
| is_bound | Number | 否 | 0 | 是否已经被添加到当前组中 |
3 其他-1 获取 Res 列表
SDK方法名：listBizGroupResource;
URL
//biz_grp/res
Method
GET
Request
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| type | Number | 否 | 1 | 类型 | |
| subtype | Number | 否 | 0 | 子类型 | |
| uuid | String | 否 | |||
| group_uuid | String | 否 | |||
| name | String | 否 | |||
| wk_uuid | String | 否 | |||
| bk_uuid | String | 否 |
Response
| 名称 | 类型 | 必选 | 初始值 | 简介 | Mock规则 |
|---|---|---|---|---|---|
| ret | Number | 否 | 200 | ||
| msg | String | 否 | |||
| data | Object | 否 | |||
| code | Number | 否 | 0 | ||
| message | String | 否 | [0] 操作成功 | ||
| info_list | Array | 否 | 22 | ||
| uuid | String | 否 | @guid | ||
| name | String | 否 | resource name | ||
| type | Number | 否 | 1 | 1-11 | |
| subtype | Number | 否 | 0 | 0-3 | |
| create_time | Number | 否 | 1527661249 |