文档首页/ 工业数字模型驱动引擎/ API参考/ API/ 数据建模引擎/ 版本服务/ 获取指定M-V模型实例的版本列表
更新时间:2024-09-05 GMT+08:00
分享

获取指定M-V模型实例的版本列表

功能介绍

根据主对象ID,获取对应M-V模型实例的所有版本信息(包含对应版本下的属性信息)。

接口约束

仅MV模型可以使用该接口。

URI

POST /rdm_{identifier}_app/publicservices/api/{modelName}/getAllVersions/{pageSizePath}/{curPagePath}

表1 路径参数

参数

是否必选

参数类型

描述

pageSizePath

Integer

参数解释:

分页大小(路径参数)。

约束限制:

不涉及。

取值范围:

1-1000。

默认取值:

不涉及。

curPagePath

Integer

参数解释:

当前页数(路径参数)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

1。

identifier

String

参数解释:

应用唯一标识。

约束限制:

不涉及。

取值范围:

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

默认取值:

不涉及。

modelName

String

参数解释:

数据模型的英文名称。

约束限制:

不涉及。

取值范围:

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

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

curPage

Integer

参数解释:

当前页。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

1。

endIndex

Integer

参数解释:

结束索引。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

0。

maxPageSize

Integer

参数解释:

最大分页数。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

1000。

pageSize

Integer

参数解释:

每页大小。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

1000。

startIndex

Integer

参数解释:

起始索引。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

0。

totalPages

Integer

参数解释:

总页数。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

0。

totalRows

Integer

参数解释:

总行数。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

0。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

IAM用户的token。

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表4 请求Body参数

参数

是否必选

参数类型

描述

applicationId

String

参数解释

应用ID。

约束限制

不涉及。

取值范围

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

默认取值

不涉及。

params

VersionModelVersionMasterDTO object

参数解释:

请求参数对象。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表5 VersionModelVersionMasterDTO

参数

是否必选

参数类型

描述

masterId

String

参数解释:

主对象ID。

约束限制:

不涉及。

取值范围:

-9223372036854775808到9223372036854775807的整数。

默认取值:

不涉及。

version

String

参数解释:

版本对象版本号。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码: 200

表6 响应Body参数

参数

参数类型

描述

result

String

参数解释:

请求结果。

取值范围:

  • SUCCESS:请求成功。

  • FAIL:请求失败。

默认取值:

不涉及。

data

Array of VersionModelQueryViewDTO objects

参数解释:

请求数据。

取值范围:

不涉及。

默认取值:

不涉及。

errors

Array of strings

参数解释:

异常信息。

取值范围:

不涉及。

默认取值:

不涉及。

pageInfo

PageInfoViewDTO object

参数解释:

分页信息。

取值范围:

不涉及。

默认取值:

不涉及。

表7 VersionModelQueryViewDTO

参数

参数类型

描述

branch

VersionObjectBranchQueryViewDTO object

参数解释:

分支对象。

取值范围:

不涉及。

默认取值:

不涉及。

checkOutTime

String

参数解释:

检出时间。

取值范围:

不涉及。

默认取值:

不涉及。

checkOutUserName

String

参数解释:

检出人。

取值范围:

不涉及。

默认取值:

不涉及。

className

String

参数解释:

类名。

取值范围:

不涉及。

默认取值:

不涉及。

createTime

String

参数解释:

创建时间。

取值范围:

不涉及。

默认取值:

不涉及。

creator

String

参数解释:

创建者。

取值范围:

不涉及。

默认取值:

不涉及。

description

String

参数解释:

描述信息。

取值范围:

不涉及。

默认取值:

不涉及。

id

String

参数解释:

唯一标识。

取值范围:

-9223372036854775808到9223372036854775807的整数。

默认取值:

不涉及。

iteration

Integer

参数解释:

迭代版本。

取值范围:

不涉及。

默认取值:

不涉及。

lastUpdateTime

String

参数解释:

最后更新时间。

取值范围:

不涉及。

默认取值:

不涉及。

latest

Boolean

参数解释:

是否为最新版本。

取值范围:

  • true:是最新版本。

  • false:不是最新版本。

默认取值:

false。

latestIteration

Boolean

参数解释:

是否为最新迭代版本。

取值范围:

  • true:是最新迭代版本。

  • false:不是最新迭代版本。

默认取值:

false。

latestVersion

Boolean

参数解释:

是否为最新修订版本。

取值范围:

  • true:是最新修订版本。

  • false:不是最新修订版本。

默认取值:

false。

master

MasterObjectQueryViewDTO object

参数解释:

主对象。

取值范围:

不涉及。

默认取值:

不涉及。

modifier

String

参数解释:

修改人。

取值范围:

不涉及。

默认取值:

不涉及。

name

String

参数解释:

中文名称。

取值范围:

不涉及。

默认取值:

不涉及。

preVersionId

String

参数解释:

前序版本实例ID。

取值范围:

不涉及。

默认取值:

不涉及。

rdmExtensionType

String

参数解释:

扩展类型。

取值范围:

不涉及。

默认取值:

不涉及。

tenant

TenantQueryViewDTO object

参数解释:

租户信息。

取值范围:

不涉及。

默认取值:

不涉及。

version

String

参数解释:

版本号。

取值范围:

不涉及。

默认取值:

不涉及。

versionCode

Integer

参数解释:

业务版本内码。

取值范围:

不涉及。

默认取值:

不涉及。

workingCopy

Boolean

参数解释:

是否已检出。

取值范围:

  • true:已检出。

  • false:未检出。

默认取值:

不涉及。

workingState

WorkingState object

参数解释:

工作状态。

取值范围:

不涉及。

默认取值:

不涉及。

表8 VersionObjectBranchQueryViewDTO

参数

参数类型

描述

className

String

参数解释:

类名。

取值范围:

不涉及。

默认取值:

不涉及。

createTime

String

参数解释:

创建时间。

取值范围:

不涉及。

默认取值:

不涉及。

creator

String

参数解释:

创建者。

取值范围:

不涉及。

默认取值:

不涉及。

id

String

参数解释:

唯一标识。

约束限制:

不涉及。

取值范围:

-9223372036854775808到9223372036854775807的整数。

默认取值:

不涉及。

lastUpdateTime

String

参数解释:

最后更新时间。

取值范围:

不涉及。

默认取值:

不涉及。

modifier

String

参数解释:

修改人。

取值范围:

不涉及。

默认取值:

不涉及。

rdmExtensionType

String

参数解释:

扩展类型。

取值范围:

不涉及。

默认取值:

不涉及。

tenant

TenantQueryViewDTO object

参数解释:

租户信息。

取值范围:

不涉及。

默认取值:

不涉及。

version

String

参数解释:

版本号。

取值范围:

不涉及。

默认取值:

不涉及。

表9 MasterObjectQueryViewDTO

参数

参数类型

描述

className

String

参数解释:

类名。

取值范围:

不涉及。

默认取值:

不涉及。

createTime

String

参数解释:

创建时间。

取值范围:

不涉及。

默认取值:

不涉及。

creator

String

参数解释:

创建者。

取值范围:

不涉及。

默认取值:

不涉及。

id

String

参数解释:

唯一标识。

取值范围:

-9223372036854775808到9223372036854775807的整数。

默认取值:

不涉及。

lastUpdateTime

String

参数解释:

最后更新时间。

取值范围:

不涉及。

默认取值:

不涉及。

modifier

String

参数解释:

修改人。

取值范围:

不涉及。

默认取值:

不涉及。

rdmExtensionType

String

参数解释:

扩展类型。

取值范围:

不涉及。

默认取值:

不涉及。

tenant

TenantQueryViewDTO object

参数解释:

租户信息。

取值范围:

不涉及。

默认取值:

不涉及。

表10 TenantQueryViewDTO

参数

参数类型

描述

className

String

参数解释:

类名。

取值范围:

不涉及。

默认取值:

不涉及。

code

String

参数解释:

租户编码。

取值范围:

不涉及。

默认取值:

不涉及。

createTime

String

参数解释:

创建时间。

取值范围:

不涉及。

默认取值:

不涉及。

creator

String

参数解释:

创建者。

取值范围:

不涉及。

默认取值:

不涉及。

dataSource

String

参数解释:

租户使用的数据源名称。

取值范围:

不涉及。

默认取值:

不涉及。

description

String

参数解释:

描述信息。

取值范围:

不涉及。

默认取值:

不涉及。

disableFlag

Boolean

参数解释:

失效标识。

取值范围:

  • true:失效。

  • false:未失效。

默认取值:

false。

id

String

参数解释:

唯一标识。

取值范围:

-9223372036854775808到9223372036854775807的整数。

默认取值:

不涉及。

lastUpdateTime

String

参数解释:

最后更新时间。

取值范围:

不涉及。

默认取值:

不涉及。

modifier

String

参数解释:

修改人。

取值范围:

不涉及。

默认取值:

不涉及。

name

String

参数解释:

中文名称。

取值范围:

不涉及。

默认取值:

不涉及。

rdmExtensionType

String

参数解释:

扩展类型。

取值范围:

不涉及。

默认取值:

不涉及。

tenant

TenantQueryViewDTO object

参数解释:

租户信息。

取值范围:

不涉及。

默认取值:

不涉及。

表11 WorkingState

参数

参数类型

描述

alias

String

参数解释:

别名。

取值范围:

不涉及。

默认取值:

不涉及。

cnName

String

参数解释:

中文名称。

取值范围:

不涉及。

默认取值:

不涉及。

code

String

参数解释:

编码。

取值范围:

不涉及。

默认取值:

不涉及。

enName

String

参数解释:

英文名称。

取值范围:

不涉及。

默认取值:

不涉及。

表12 PageInfoViewDTO

参数

参数类型

描述

curPage

Integer

参数解释:

当前页。

取值范围:

不涉及。

默认取值:

不涉及。

pageSize

Integer

参数解释:

每页大小。

取值范围:

不涉及。

默认取值:

不涉及。

totalRows

Integer

参数解释:

总行数。

取值范围:

不涉及。

默认取值:

不涉及。

totalPages

Integer

参数解释:

总页数。

取值范围:

不涉及。

默认取值:

不涉及。

请求示例

POST https://dme.cn-north-4.huaweicloud.com/rdm_b3f9b7523a6141f4b2d76b92d6595281_app/publicservices/api/VersionModel/getAllVersions/10/1

{
  "applicationId" : "b3f9b7523a6141f4b2d76b92d6595281",
  "params" : {
    "masterId" : "602146893727801345",
    "version" : "A"
  }
}

响应示例

状态码: 200

OK

{
  "result" : "SUCCESS",
  "data" : [ {
    "id" : "601060080745455616",
    "creator" : "test1",
    "modifier" : "test1",
    "createTime" : "2024-02-19T06:38:10.406+0000",
    "lastUpdateTime" : "2024-02-19T06:56:43.319+0000",
    "rdmVersion" : 4,
    "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" : "modifier name",
    "description" : "modifier description",
    "kiaguid" : "18409de0386546f8af4bb6c1dc5cf50f",
    "securityLevel" : "internal",
    "master" : {
      "id" : "601060080779010048",
      "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" : "601060080799981568",
      "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" : true,
    "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
  } ],
  "errors" : [ ],
  "pageInfo" : {
    "curPage" : 1,
    "pageSize" : 10,
    "totalRows" : 1,
    "totalPages" : 1
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档