文档首页/ 工业数字模型驱动引擎/ API参考/ API/ 数据建模引擎/ 基础数据服务/ 批量更新实例 - BatchUpdateUsingPost
更新时间：2026-07-28 GMT+08:00
查看PDF
分享

批量更新实例 - BatchUpdateUsingPost

功能介绍

本接口用于批量更新指定数据模型中的多个实例数据。如果请求列表中某个实例的唯一编码（id）在系统中不存在，系统将跳过该实例，不执行任何更新操作，且不会因此导致整个批量请求失败。

在调用本接口前，请确保目标数据模型已满足实例化条件：

  1. 已在应用设计态完成数据模型（数据实体或关系实体）的创建与发布。具体操作请参见创建数据实体、创建关系实体和应用发布。

  2. 已将对应应用成功部署至运行态。具体操作请参见部署应用。

接口约束

  • 单次请求的params数组中，最多允许传入1000个更新对象。若超出限制，请求将被直接拒绝。

  • 如需将某些属性值清空（置为Null），必须通过needSetNullAttrs数组显式指定需要置空的属性英文名称，而不能仅在请求体中传空字符串。

  • 批量更新支持“部分成功”。系统会尽力处理列表中的所有对象，实际成功更新的实例信息将在响应的data字段中返回，而因约束无法更新的实例原因将记录在errors字段中。

  • 建议传入modifier（更新者账号）参数。系统会自动更新lastUpdateTime并递增rdmVersion（系统版本号），确保数据变更具备完整的审计轨迹。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /rdm_{identifier}_app/publicservices/api/{modelName}/batchUpdate

表1 路径参数

参数

是否必选

参数类型

描述

identifier

是

String

参数解释：

应用的唯一标识。

  • 于2023年06月01日之前创建的应用，其唯一标识为该应用的名称。

  • 于2023年06月01日之后创建的应用，其唯一标识为该应用的ID。

获取方法请参见获取运行服务清单 - ListEnvs。

约束限制：

不涉及。

取值范围：

  • 于2023年06月01日之前创建的应用：由英文字母和数字组成，长度为1-36个字符。

  • 于2023年06月01日之后创建的应用：由英文字母和数字组成，且长度为32个字符。

默认取值：

不涉及。

modelName

是

String

参数解释：

数据模型的英文名称。

约束限制：

不涉及。

取值范围：

以大写字母开头，只能包含字母、数字、“_”，且长度为1-60个字符。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

IAM用户的token。

获取方法请参见获取IAM用户Token。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

applicationId

否

String

参数解释：

应用ID，用于指定实例所属的应用。

当URL路径中已能明确应用上下文时，此参数可不传。

获取方法请参见获取租户下的应用清单 - ListApps。

约束限制：

不涉及。

取值范围：

由英文字母和数字组成，且长度固定为32个字符。

默认取值：

不涉及。

params

是

Array of PersistableModelUpdateDTO objects

参数解释：

请求参数对象。

约束限制：

单次请求不超过1000个。

取值范围：

不涉及。

默认取值：

不涉及。
表4 PersistableModelUpdateDTO

参数

是否必选

参数类型

描述

createTime

否

String

参数解释：

创建时间。使用UTC+0时间格式，格式为yyyy-MM-ddTHH:mm:ss.SSSZ。

例如：2025-12-04T03:50:40.599+0000。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

creator

否

String

参数解释：

创建者账号。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

id

否

String

参数解释：

数据实例的唯一标识，用于指定待更新的实例。

获取方法请参见分页查询实例 - ShowFindUsingPost。

约束限制：

不涉及。

取值范围：

-9223372036854775808到9223372036854775807的整数。

默认取值：

不涉及。

lastUpdateTime

否

String

参数解释：

最后更新时间。使用UTC+0时间格式，格式为yyyy-MM-ddTHH:mm:ss.SSSZ。

例如：2025-12-04T03:50:40.599+0000。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

modifier

否

String

参数解释：

更新者账号，用于记录执行更新操作的用户。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

needSetNullAttrs

否

Array of strings

参数解释：

需要置空的自定义属性列表，包括基本属性、扩展属性和分类属性。

约束限制：

不涉及。

取值范围：

属性名称长度不能超过1000个字符。

默认取值：

不涉及。

rdmExtensionType

否

String

参数解释：

扩展类型，用于指定数据模型的具体扩展类型。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

uniqueKey

否

String

参数解释：

数据模型的唯一键属性，用于业务层面的唯一标识。

约束限制：

实例值不能重复。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

result

String

参数解释：

请求处理结果状态。

取值范围：

  • SUCCESS：请求成功。

  • FAIL：请求失败。

data

Array of PersistableModelViewDTO objects

参数解释：

请求数据。

取值范围：

不涉及。

errors

Array of strings

参数解释：

异常信息列表。当result为FAIL时，返回具体的错误描述，包含失败原因及建议处理方式。

取值范围：

不涉及。
表6 PersistableModelViewDTO

参数

参数类型

描述

className

String

参数解释：

类名，表示数据实例的具体类类型。

取值范围：

不涉及。

createTime

String

参数解释：

创建时间。使用UTC+0时间格式，格式为yyyy-MM-ddTHH:mm:ss.SSSZ。

取值范围：

不涉及。

creator

String

参数解释：

创建者账号。

取值范围：

不涉及。

id

String

参数解释：

数据实例的唯一标识。

取值范围：

-9223372036854775808到9223372036854775807的整数。

rdmDeleteFlag

Integer

参数解释：

软删除标识，用于标识实例是否已被逻辑删除。

取值范围：

  • 0：表示未删除。

  • 1：表示已删除。

rdmExtensionType

String

参数解释：

扩展类型，表示数据模型的具体扩展类型。

取值范围：

不涉及。

rdmVersion

Integer

参数解释：

系统版本号，用于标识实例的版本信息。

取值范围：

不涉及。

modifier

String

参数解释：

更新者账号。

取值范围：

不涉及。

lastUpdateTime

AnyType

参数解释：

最后更新时间。使用UTC+0时间格式，格式为yyyy-MM-ddTHH:mm:ss.SSSZ。

取值范围：

不涉及。

tenant

TenantViewDTO object

参数解释：

租户信息，表示实例所属的租户详情。

取值范围：

不涉及。

uniqueKey

String

参数解释：

数据模型的唯一键属性。

取值范围：

不涉及。
表7 TenantViewDTO

参数

参数类型

描述

className

String

参数解释：

租户对象的类名。

取值范围：

不涉及。

code

String

参数解释：

租户编码，用于多租户场景下的租户唯一标识。

取值范围：

不涉及。

createTime

String

参数解释：

租户对象的创建时间。使用UTC+0时间格式，格式为yyyy-MM-ddTHH:mm:ss.SSSZ。

取值范围：

不涉及。

creator

String

参数解释：

租户对象的创建者账号。

取值范围：

不涉及。

dataSource

String

参数解释：

租户使用的数据源名称，用于多租户数据隔离。

取值范围：

不涉及。

description

String

参数解释：

租户描述信息。

取值范围：

不涉及。

disableFlag

Boolean

参数解释：

租户失效标识，用于标识租户是否已失效。

取值范围：

  • true：失效。

  • false：未失效（默认）。

id

String

参数解释：

租户的唯一标识。

取值范围：

-9223372036854775808到9223372036854775807的整数。

kiaguid

String

参数解释：

租户KIA密级。

取值范围：

不涉及。

lastUpdateTime

String

参数解释：

租户的最后更新时间。使用UTC+0时间格式，格式为yyyy-MM-ddTHH:mm:ss.SSSZ。

取值范围：

不涉及。

modifier

String

参数解释：

租户的更新者账号。

取值范围：

不涉及。

name

String

参数解释：

租户中文名称。

取值范围：

不涉及。

nameEn

String

参数解释：

租户英文名称。

取值范围：

不涉及。

rdmDeleteFlag

Integer

参数解释：

软删除标识。

取值范围：

  • 0：表示未删除。

  • 1：表示已删除。

rdmExtensionType

String

参数解释：

租户扩展类型。

取值范围：

不涉及。

rdmVersion

Integer

参数解释：

租户对象的系统版本号。

取值范围：

不涉及。

securityLevel

String

参数解释：

租户安全密级，用于标识租户信息的安全等级。

取值范围：

  • internal：内部公开。

  • secret：秘密。

  • confidential：机密。

  • top_secret：绝密。

tenant

TenantViewDTO object

参数解释：

租户信息，表示当前租户的父租户信息。

取值范围：

不涉及。

请求示例

示例：批量更新多个实例

同时更新PersistableModel模型中ID为2和3的两个实例的uniqueKey，操作人为test1。

POST https://dme.cn-north-4.huaweicloud.com/rdm_04219627d6794f37ae26e8aba250415d_app/publicservices/api/PersistableModel/batchUpdate

{
  "applicationId" : "04219627d6794f37ae26e8aba250415d",
  "params" : [ {
    "id" : "2",
    "modifier" : "test1",
    "creator" : "test1",
    "rdmExtensionType" : "PersistableModel",
    "uniqueKey" : "批量更新1"
  }, {
    "id" : "3",
    "modifier" : "test1",
    "creator" : "test1",
    "rdmExtensionType" : "PersistableModel",
    "uniqueKey" : "批量更新2"
  } ]
}

响应示例

状态码：200

OK，表示请求成功。

{
  "result": "SUCCESS",
  "data": [
    {
      "id": "123",
      "creator": "test1",
      "modifier": "XDM_Developer xxx",
      "createTime": 2023-12-04T11:52:48.000+0000,
      "lastUpdateTime": 2023-12-06T06:47:35.183+0000,
      "rdmVersion": 4,
      "rdmDeleteFlag": 0,
      "rdmExtensionType": "PersistableModel",
      "tenant": {
        "id": "-1",
        "creator": "xdmAdmin",
        "modifier": "xdmAdmin",
        "createTime": 2023-12-01T01:25:21.000+0000,
        "lastUpdateTime": 2023-12-01T01:25:21.000+0000,
        "rdmVersion": 1,
        "rdmDeleteFlag": 0,
        "rdmExtensionType": "Tenant",
        "tenant": null,
        "className": "Tenant",
        "name": "basicTenant",
        "description": "默认租户",
        "kiaguid": null,
        "securityLevel": "internal",
        "nameEn": null,
        "code": "basicTenant",
        "disableFlag": false,
        "dataSource": "DefaultDataSource"
      },
      "className": "PersistableModel",
      "uniqueKey": "456"
    }
  ],
  "errors": []
}

状态码

状态码

描述

200

OK，表示请求成功。

错误码

请参见错误码。

父主题： 基础数据服务

相关文档