资源转移API
1. 资源转移相关API 概述
Public API，是指观远数据为系统集成提供的标准化开放接口。系统集成，通常是指将各个分离的设备(如个人电脑)、系统、功能和信息等集成到相互关联的、统一和协调的系统之中，使资源达到充分共享，实现集中、高效、便利的管理。系统集成实现的关键在于解决系统之间的互连和互操作性问题，是一个多厂商、多协议和面向各种应用的体系结构。
观远数据提供一套简便的验证机制，来供私有化部署用户进行外部系统和账户对接集成，实现集中、高效、便利的管理。本文将为您详细介绍观远数据为您提供的与资源转移相关的 Public API。
2. 资源转移相关API 列表速览
目前，与资源转移相关的 Public API 共包含2个，列表如下：
| 序号 | 接口描述 | PATH |
| 1 | 将指定用户组下辖的所有资源迁移至其他用户组或用户 | POST /public-api/user-group/:ugId/transfer-resources |
| 2 | 将指定用户下辖的所有资源迁移至其他用户组或用户 | POST /public-api/user/:uId/transfer-resources |
3. 资源转移相关API 具体说明
3.1 将指定用户组下有所有者权限的资源迁移至其他用户组或用户 （1017）
3.1.1 接口简介
请求方式：POST
请求地址：/public-api/user-group/:ugId/transfer-resources
3.1.2 参数说明
| 参数名 | 参数值说明 | Location | 类型 | 是否必填 | 备注 |
| token | 应用Token | Body | String | 是 | 在观远平台中获得 |
| ugId | 当前资源所属用户组的ugId | url | String | 是 | -- |
| inheritorUIds | 获得权限的用户uId列表 | Body | String List | 否 | -- |
| inheritorUgIds | 获得权限的用户ugId列表 | Body | String List | 否 | -- |
inheritorUIds与inheritorUgIds中至少包含一个参数。
3.1.3 请求与响应示例
POST Body Sample:
{
"token":"x2a369b32444b48caa873411",
"inheritorUIds":[],
"inheritorUgIds":["w54fdc9a7877a4c7ba387a36"]
}
Response Sample:
{
"result": "ok",
"response": "UserGroup resources transfered"
}
3.2 将指定用户下辖有所有者权限的资源迁移至其他用户组或用户（1018）
3.2.1 接口简介
请求方式： POST
请求地址：/public-api/user/:uId/transfer-resources
3.2.2 参数说明
| 参数名 | 参数值说明 | Location | 类型 | 是否必填 | 备注 |
| token | 应用Token | Body | String | 是 | 在观远平台中获得 |
| inheritorUIds | 获得权限的用户uId列表 | Body | String List | 否 | -- |
| inheritorUgIds | 获得权限的用户组ugId列表 | Body | String List | 否 | -- |
inheritorUIds与inheritorUgIds中至少包含一个参数。
可根据通过指定的用户的loginid查询对应的uid接口再用uid调用编号为1017的接口（本页面第1个接口）做迁移。
3.2.3 请求与响应示例
POST Body Sample:
{
"token":"m3a369b32444b48caa873411",
"inheritorUIds":["w54fdc9fa877a4c7ba387a36"],
"inheritorUgIds":[]
}
Response Sample:
{
"result": "ok",
"response": "UserGroup resources transfered"
}