文档首页/工业数字模型驱动引擎/API参考/API/数据建模引擎/基础数据服务/根据唯一键为“是”的属性更新实例的指定字段 - SaveUsingPost
更新时间：2025-11-07 GMT+08:00
查看PDF
分享

根据唯一键为“是”的属性更新实例的指定字段 - SaveUsingPost

功能介绍

当数据模型中存在“唯一键”为“是”的属性时，可根据该属性的英文名称更新该数据模型中实例的指定字段数据。

如果更新的实例不存在，系统将自动创建该实例数据。

接口约束

不涉及。

授权信息

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

identifier

是

String

参数解释：

应用唯一标识。

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。

modelName

是

String

参数解释：

数据模型的英文名称。

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

IAM用户的token。

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

applicationId

否

String

参数解释：

应用ID。

约束限制：

不涉及。

取值范围：

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

默认取值：

不涉及。

params

是

Array of PersistableModelSaveDTO objects

参数解释：

请求参数对象。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

表4 PersistableModelSaveDTO

参数

是否必选

参数类型

描述

createTime

否

String

参数解释：

创建时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

creator

否

String

参数解释：

创建者。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

id

否

String

参数解释：

唯一标识。

约束限制：

不涉及。

取值范围：

-9223372036854775808到9223372036854775807的整数。

默认取值：

不涉及。

lastUpdateTime

否

String

参数解释：

最后更新时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

modifier

否

String

参数解释：

更新者。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

needSetNullAttrs

否

Array of strings

参数解释：

将自定义属性（包括基本属性、扩展属性和分类属性）设置为空值，其长度不能超过1000个字符。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

rdmExtensionType

否

String

参数解释：

扩展类型。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

tenant

否

ObjectReferenceParamDTO object

参数解释：

租户信息。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

uniqueKey

否

String

参数解释：

示例模型的唯一键属性。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

表5 ObjectReferenceParamDTO

参数

是否必选

参数类型

描述

clazz

否

String

参数解释：

类名。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

id

是

String

参数解释：

数据实例ID。

约束限制：

不涉及。

取值范围：

-9223372036854775808到9223372036854775807的整数。

默认取值：

不涉及。

响应参数

状态码：200

表6 响应Body参数

参数

参数类型

描述

result

String

参数解释：

请求结果。

取值范围：

  • SUCCESS：请求成功。

  • FAIL：请求失败。

默认取值：

不涉及。

data

Array of longs

参数解释：

请求数据。

约束限制：

不涉及。

默认取值：

不涉及。

errors

Array of strings

参数解释：

异常信息。

取值范围：

不涉及。

默认取值：

不涉及。

请求示例

POST https://dme.cn-north-4.huaweicloud.com/rdm_b3f9b7523a6141f4b2d76b92d6595281_app/publicservices/api/PersistableModel/save

{
  "applicationId" : "b3f9b7523a6141f4b2d76b92d6595281",
  "params" : [ {
    "id" : "1",
    "modifier" : "test1",
    "creator" : "test1",
    "rdmExtensionType" : "PersistableModel",
    "uniqueKey" : "save接口通过唯一键更新值",
    "tenant" : {
      "id" : "-1",
      "clazz" : "Tenant"
    }
  } ]
}

响应示例

状态码：200

OK

{
  "result" : "SUCCESS",
  "data" : [ 1 ],
  "errors" : [ ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题：基础数据服务

相关文档