调用ListModelVersions获取模型版本列表_机器学习平台 PAI-阿里云帮助中心

获取模型版本列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

GET /api/v1/models/{ModelId}/versions

请求参数

名称	类型	必填	描述	示例值
PageNumber	integer	否	模型版本列表的页码。起始值为1，默认为1。	1
PageSize	integer	否	分页查询时设置的每页行数。默认为10。	10
Order	string	否	分页查询时，对指定的排序字段进行升序或降序。默认ASC。 ASC：升序。 DESC：降序。	DESC
SortBy	string	否	分页查询时的排序字段。目前GmtCreateTime字段用于排序。	GmtCreateTime
VersionName	string	否	配置模型版本名称，来过滤模型版本列表。	1.0.1
FormatType	string	否	配置模型格式，来过滤模型版本列表。取值如下： OfflineModel SavedModel Keras H5 Frozen Pb Caffe Prototxt TorchScript XGBoost PMML AlinkModel ONNX	SavedModel
FrameworkType	string	否	配置模型框架，来过滤模型版本列表，取值如下： Pytorch -XGBoost Keras Caffe Alink Xflow TensorFlow	TensorFlow
ModelId	string	是	模型ID。如何获取模型ID，请参见ListModels。	model-dajbueh******
SourceType	string	否	根据模型来源类型，来过滤模型版本列表。取值如下： Custom（默认值）：自定义。 PAIFlow：PAI工作流。 TrainingService：PAI训练服务。	PAIFlow
SourceId	string	否	来源ID。来源类型为Custom时，该字段不做限制。来源为PAIFlow、TrainingService时，格式为 `region=<region_id>,workspaceId=<workspace_id>,kind=<kind>,id=<id>` 其中： region为阿里云区域ID。 workspacceId为工作空间ID。 kind：为类型。取值：PipelineRun（PAIFlow工作流）；ServiceJob（训练服务）。 id：为唯一标识。	region=cn-shanghai,workspaceId=13,kind=PipelineRun,id=run-sakdb**jdf
Label	string	否	标签串。用于列表过滤，标签中Key或Value中，有指定字符串的，都会被过滤出来。	key1
ApprovalStatus	string	否	根据准入状态来过滤模型版本列表，取值如下： Pending：待定。 Approved：允许上线。	Approved

返回参数

名称	类型	描述	示例值
	object	返回体。
RequestId	string	请求ID。	473469C7-AA6F-4DC5-B3DB-A3DC***3C83E
Versions	array	模型版本列表。
	ModelVersion	模型版本。
TotalCount	long	模型版本列表总数。	15

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC***3C83E",
  "Versions": [
    {
      "VersionName": "0.1.0",
      "GmtCreateTime": "2021-01-21T17:12:35Z",
      "GmtModifiedTime": "2021-01-21T17:12:35Z",
      "UserId": "155770209******",
      "OwnerId": "155770209******",
      "Uri": "oss://mybucket.oss-cn-beijing.aliyuncs.com/mypath/",
      "VersionDescription": "情感分析。",
      "Labels": [
        {
          "Key": "env",
          "Value": "test"
        }
      ],
      "FormatType": "SavedModel",
      "FrameworkType": "TensorFlow",
      "Options": "{}",
      "Metrics": {
        "test": "test",
        "test2": 1
      },
      "TrainingSpec": {
        "test": "test",
        "test2": 1
      },
      "InferenceSpec": {
        "test": "test",
        "test2": 1
      },
      "SourceType": "PAIFlow",
      "SourceId": "region=cn-shanghai,workspaceId=13**,kind=PipelineRun,id=run-sakdb****jdf",
      "ApprovalStatus": ""
    }
  ],
  "TotalCount": 15
}

错误码

访问错误中心查看更多错误码。