更新时间:2024-09-05 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

表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

VersionModelCompareVersionVO object

参数解释:

请求参数对象。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表4 VersionModelCompareVersionVO

参数

是否必选

参数类型

描述

basicVersion

String

参数解释:

基础版本号。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

correlationVersion

String

参数解释:

对比版本号。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

id

String

参数解释:

主对象ID。

约束限制:

不涉及。

取值范围:

-9223372036854775808到9223372036854775807的整数。

默认取值:

不涉及。

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

result

String

参数解释:

请求结果。

取值范围:

  • SUCCESS:请求成功。

  • FAIL:请求失败。

默认取值:

不涉及。

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

错误码

请参见错误码

相关文档