更新时间：2025-04-21 GMT+08:00

创建指定实体的实例

功能介绍

在应用设计态完成模型的构建、发布（模型发布和应用发布），以及控制台部署应用后，会在应用运行态自动生成相应的CRUD接口。其中，create接口用于创建模型实例。

更多API信息请参见全量数据服务。

URI

URI格式：

POST http://{Endpoint}/rdm_{appID}_app/services/dynamic/api/{entityName}/create

参数说明：

表1 URI参数说明
参数	是否必填	参数类型	描述
Endpoint	是	String	承载REST服务端点的服务器域名或IP地址。
appID	是	String	应用ID。
entityName	是	String	实体的英文名称。

请求参数

表2 请求body参数
参数	是否必填	参数类型	描述
id	是	String	唯一编码。
rdmVersion	是	Int	系统版本。
rdmExtensionType	否	String	实体类型。
createTime	否	Date	创建时间。
creator	否	String	创建者。
lastUpdateTime	否	Date	最后更新时间。
modifier	否	String	更新者。
tenant	否	Object	租户。

根据实体类型、功能的不同，请求body参数不同，您可以在全量数据服务查看API具体参数。

响应参数

返回创建实例的详细信息。

请求示例

示例背景

您已在设计态构建一个名称为“Design_document”的数据实体，并完成了实体发布、应用发布和应用部署。根据运行态的“数据服务管理 > 全量数据服务”查看到的“Design_document”数据实体Create接口信息，传入相应的参数。

示例代码

{
    "params": {
        "clsAttrs": null,
        "department": null,
        "income": null,
        "securityLevel": "internal",
        "kiaguid": null,
        "name": "产品设计",
        "description": null,
        "tenant": {
            "id": "-1",
            "clazz": "Tenant"
        },
        "rdmExtensionType": null,
        "id": null
    }
}

响应示例

{
    "result": "SUCCESS",
    "data": [
        {
            "id": "502903940749205504",
            "creator": "TestAccount2 5547b9adee54423cb**********",
            "modifier": "TestAccount2 5547b9adee54423cb**********",
            "createTime": "2023-05-24T10:00:42.978+0000",
            "lastUpdateTime": "2023-05-24T10:00:42.978+0000",
            "rdmVersion": 1,
            "rdmDeleteFlag": 0,
            "rdmExtensionType": "Design_document",
            "tenant": {
                "id": "-1",
                "creator": "xdmAdmin",
                "modifier": "xdmAdmin",
                "createTime": "2022-12-01T11:24:39.000+0000",
                "lastUpdateTime": "2022-12-01T11:24:39.000+0000",
                "rdmVersion": 1,
                "rdmDeleteFlag": 0,
                "rdmExtensionType": "Tenant",
                "tenant": null,
                "className": "Tenant",
                "name": "basicTenant",
                "description": "默认租户",
                "kiaguid": null,
                "securityLevel": "internal",
                "code": "basicTenant",
                "disableFlag": false,
                "dataSource": "DefaultDataSource"
            },
            "className": "Design_document",
            "name": "产品设计",
            "description": null,
            "kiaguid": null,
            "securityLevel": "internal",
            "income": null,
            "department": null
        }
    ],
    "errors": []
}

父主题： 常用全量数据服务API开发示例