Assign Assets to Organization Structure¶
将资产挂载到组织结构节点。
请求格式¶
POST https://{apigw-address}/app-portal-service/v2.3/structure/asset/assign
请求参数(URI)¶
名称 |
位置(Path/Query) |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|---|
orgId |
Query |
必需 |
String |
OU ID。如何获取 orgId 信息 >> |
请求参数(Body)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
structureId |
必需 |
String |
组织结构节点 ID。 |
assetIds |
必需 |
Array |
需要挂载的资产 ID。指定的资产将全部挂载到组织结构节点中。若该组织结构节点上已有挂载的资产,但此参数中未指定,则资产将从组织结构节点中移除。 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
data |
Boolean |
资产是否挂载成功。 |
错误码¶
代码 |
描述 |
---|---|
31400 |
必要参数缺失。 |
31403 |
组织结构未分配给应用。 |
31404 |
组织结构节点或资产不存在于当前 OU。 |
31435 |
资产已被分配给当前组织结构。 |
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.3/structure/asset/assign
method: POST
requestBody:
{
"structureId": "your_node_ID",
"assetIds": ["your_asset_id_1", "your_asset_id_2"]
}
返回示例¶
{
"code": 0,
"data": true,
"message": "OK"
}