更新时间：2025-09-03 GMT+08:00
对比M-V模型实例
功能介绍
通过此接口可以对比某个M-V模型数据实例的不同版本的属性和关系。建议使用数据建模引擎（xDM Foundation，简称xDM-F）新增的差异对比功能，即使用instance-attrs-comparison和instance-relation-comparison接口，更多内容可在应用运行态的“数据服务管理 > 全量数据服务 > 系统管理API > 属性对比API”中查看。
接口约束
仅MV模型可以使用该接口。
URI
POST /rdm_{identifier}_app/publicservices/api/{modelName}/compareBusinessVersion
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
identifier |
是 |
String |
参数解释： 应用唯一标识。 约束限制： 不涉及。 取值范围： 由英文字母和数字组成，且长度为32个字符。 默认取值： 不涉及。 |
|
modelName |
是 |
String |
参数解释： 数据模型的英文名称。 约束限制： 不涉及。 取值范围： 大写字母开头，只能包含字母、数字、“_”，且长度为[1-60]个字符。 默认取值： 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释： IAM用户的token。 获取方法请参见获取IAM用户Token。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
applicationId |
否 |
String |
参数解释： 应用ID。 约束限制： 不涉及。 取值范围： 由英文字母和数字组成，且长度为32个字符。 默认取值： 不涉及。 |
|
params |
是 |
VersionModelCompareVersionVO object |
参数解释： 请求参数对象。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
result |
String |
参数解释： 请求结果。 取值范围：
默认取值： 不涉及。 |
|
data |
Array of objects |
参数解释： 请求数据。 取值范围： 不涉及。 默认取值： 不涉及。 |
|
errors |
Array of strings |
参数解释： 异常信息。 取值范围： 不涉及。 默认取值： 不涉及。 |
请求示例
POST https://dme.cn-north-4.huaweicloud.com/rdm_b3f9b7523a6141f4b2d76b92d6595281_app/publicservices/api/VersionModel/compareBusinessVersion
{
"applicationId" : "b3f9b7523a6141f4b2d76b92d6595281",
"params" : {
"basicVersion" : "A.1",
"correlationVersion" : "B.2",
"id" : "602443425911939073"
}
}
响应示例
状态码：200
OK
{
"result" : "SUCCESS",
"data" : [ {
"id" : "602443425911939072",
"creator" : "test1",
"modifier" : "test1",
"createTime" : "2024-02-19T06:38:10.406+0000",
"lastUpdateTime" : "2024-02-19T06:56:43.319+0000",
"rdmVersion" : 1,
"rdmDeleteFlag" : 0,
"rdmExtensionType" : "VersionModel",
"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" : "VersionModel",
"name" : "这是A版本",
"description" : "这是A版本",
"kiaguid" : "18409de0386546f8af4bb6c1dc5cf50f",
"securityLevel" : "internal",
"master" : {
"id" : "602443425911939073",
"creator" : "test1",
"modifier" : "test1",
"createTime" : "2024-02-19T06:38:10.419+0000",
"lastUpdateTime" : "2024-02-19T06:56:43.319+0000",
"rdmVersion" : 4,
"rdmDeleteFlag" : 0,
"rdmExtensionType" : "VersionModelMaster",
"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" : "VersionModelMaster"
},
"branch" : {
"id" : "602443425911939074",
"creator" : "test1",
"modifier" : "test1",
"createTime" : "2024-02-19T06:38:10.464+0000",
"lastUpdateTime" : "2024-02-19T06:56:43.319+0000",
"rdmVersion" : 4,
"rdmDeleteFlag" : 0,
"rdmExtensionType" : "VersionModelBranch",
"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" : "VersionModelBranch",
"version" : "A"
},
"latest" : false,
"latestIteration" : true,
"versionCode" : 1,
"iteration" : 1,
"version" : "A",
"latestVersion" : true,
"workingCopy" : false,
"workingState" : {
"code" : "CHECKED_IN",
"cnName" : "已检入",
"enName" : "checked in",
"alias" : "CHECKED_IN"
},
"checkOutUserName" : null,
"checkOutTime" : null,
"preVersionId" : "null,",
"relations" : [ ]
}, {
"rdmVersion" : 2,
"description" : "这是B版本",
"version" : "B",
"branch" : {
"id" : 602443476277137408,
"clazz" : "VersionModelBranch"
},
"preVersionId" : 602443476272943104,
"versionCode" : 2,
"hibernateVersion" : 3,
"latestVersion" : true,
"createTime" : "2024-02-23T06:38:10.406+0000",
"name" : "这是B版本",
"iteration" : 2,
"id" : 602443507797336064,
"relations" : [ ],
"latest" : true,
"lastUpdateTime" : "2024-02-23T06:38:10.406+0000"
} ],
"errors" : [ ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。
父主题： 版本服务
