【15110版本之后】自定义资产类型 API 详解

简介

15100版本之后，优化了资产模块的自定义资产类型。能帮助管理者更有效组织和管理资产。

比如支持创建子类型，自定义API URL以及所属附加字段的API Name。

因为自定义资产类型的API调用方法不会展示在API文档页面中。所以创建此文档供参考：

示例

创建资产和所属附加字段

在计算机>Server>下创建了自定义资产类型it physics server和 it virtual server.

创建时会提示API名称和API复数名称必填。

创建专属附加字段时，也会提示API字段名称必填

获取所有自定义资产

方法: GET

URL: 服务器地址/api/v3/API复数名称

      示例: http://localhost/api/v3/custom_asset_it_physics_servers/

其它参数可参考API文档中的其它API。

Postman调用示例：

获取一个自定义资产

方法: GET

URL: 服务器地址/api/v3/API复数名称/具体的资产ID

      示例：http://localhost/api/v3/custom_asset_it_physics_servers/15603

其它参数可参考API文档中的其它API。

Postman调用示例：

添加一个自定义资产

方法: POST

URL: 服务器地址/api/v3/API复数名称

      示例：http://localhost/api/v3/custom_asset_it_physics_servers

input_data参数：{"API名称":{Json}}

      示例：

{
    "custom_asset_it_physics_server": {
        "name": "测试物理机666",
        "product": {
            "id": "3301",
            "name": "Server_Unknown+Server"
        },
        "udf_fields": {
            "udf_physics_filed": "测试专属附加字段"
        },
        "state": {
            "id": "1",
            "name": "In+Store"
        }
    }
}

其它参数可参考API文档中的其它API。

Postman调用示例：

• Related Articles

• 云版本认证API接口调用过程详解

  云版本认证API接口调用过程详解 云版本API接口调用认证较本地版更为复杂，参考如下文档进行云版本api接口调用。

• SDP SaaS API学习汇总

  DataCenter API Domain URL Accounts Server URL API Endpoint China https://servicedeskplus.cn https://accounts.zoho.com.cn https://servicedeskplus.cn/api/v3/requests 授权领牌/认证代码 - 认证服务器创建的临时领牌，用于客户端认证 访问领牌，执行API操作，时限1小时 刷新领牌，重新获取访问领牌 ...

• apm/opm 添加监视器 or 设备等常规api

  以apm为例，有些特殊情形下，监视器无法添加，无法删除等，但苦于没有及时有效的sql语句去操作，可以参考以下链接，从而排错，其他操作可查阅具体手册。 https://www.manageengine.cn/products/applications_manager/help/addmonitor-api.html opm也有丰富的api可操作设备，告警，组等供参考。 ...

• 用API添加ci项时multi-line类型字段如何带格式？

  CMDB中的字段single-line最多显示250个字符，multi-line最多显示4000个字符，如果不加格式会在一行内显示。 有时客户希望多行文本中的值带一定格式，便于查看，比如说如下方式： 在调用API时，需要使用转码器将字符由ACSI转成Unicode即可，如下述所示，换行转码后是


• 【OPM】如何查找API密钥

  1，点击右上角齿轮图标 2，点击REST API密钥 复制即可。 注意：注意事项