AI 助理
备案控制台
文档
输入文档关键字查找
首页 人工智能平台 PAI 操作指南 API参考 PAI-AI WorkSpace API目录 模型 GetModelVersion - 获取模型版本

GetModelVersion - 获取模型版本

更新时间：
产品详情
我的收藏

获取模型版本。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用背景高亮的方式表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
paimodel:GetModelVersionget
  • 全部资源
    *
    无
无

请求语法

GET /api/v1/models/{ModelId}/versions/{VersionName} HTTP/1.1

请求参数

名称类型必填描述示例值
ModelIdstring是

模型 ID。如何获取模型 ID，请参见 ListModels 。

model-rbvg5wzljz****ks92
VersionNamestring是

模型版本。

1.0.1

返回参数

名称类型描述示例值
object

返回体。

RequestIdstring

请求 ID。

5A14FA81-DD4E-******-6343FE44B941
GmtCreateTimestring

创建模型 UTC 时间，格式 ISO8601。

2021-01-30T12:51:33.028Z
GmtModifiedTimestring

最后更新模型 UTC 时间，格式 ISO8601。

2021-01-30T12:51:33.028Z
UserIdstring

用户 ID。

1234567890******
OwnerIdstring

阿里云账号 ID。

1234567890******
Uristring

模型版本 URI，即模型存储位置。可能值为：

  • 模型的 HTTP（S）地址，例如：https://myweb.com/mymodel.tar.gz。
  • 如果模型存储在 OSS 中，格式为oss://<bucket>.<endpoint>/object。其中 endpoint 配置，请参见访问域名和数据中心，例如：oss://mybucket.oss-cn-beijing.aliyuncs.com/mypath/。
oss://t***.cn-beijing.oss.aliyuncs.com/mod**/
Labelsarray

模型版本标签列表。

LabelsLabel

标签。

Optionsstring

扩展字段。JsonString 类型。

{}
VersionNamestring

模型版本。

0.1.0
VersionDescriptionstring

模型版本描述。

通用情感分析。
TrainingSpecobject

训练配置。用于微调，增量训练的配置。

{}
InferenceSpecobject

描述如何应用于下游的推理服务：例如描述 EAS 的 processor、container 等。

{ "Processor": "tensorflow_gpu_1.12" }
FormatTypestring

模型格式，可能值：

  • OfflineModel
  • SavedModel
  • Keras H5
  • Frozen Pb
  • Caffe Prototxt
  • TorchScript
  • XGBoost
  • PMML
  • AlinkModel
  • ONNX
SavedModel
FrameworkTypestring

模型框架，可能值：

  • Pytorch -XGBoost
  • Keras
  • Caffe
  • Alink
  • Xflow
  • TensorFlow
TensorFlow
SourceTypestring

模型来源类型，可能值：

  • Custom：自定义。
  • PAIFlow：PAI 工作流。
  • TrainingService：PAI 训练服务。
PAIFlow
SourceIdstring

来源 ID。

  • 来源类型为 Custom 时，该字段不做限制。
  • 来源为 PAIFlow、TrainingService 时，格式为
region=<region_id>,workspaceId=<workspace_id>,kind=<kind>,id=<id>

其中：

  • region 为阿里云区域 ID。
  • workspaceId 为工作空间 ID。
  • kind：为类型。取值：PipelineRun（PAIFlow 工作流）；ServiceJob（训练服务）。
  • id：为唯一标识。
region=cn-shanghai,workspaceId=13**,kind=PipelineRun,id=run-sakdb****jdf
ApprovalStatusstring

准入状态，取值如下：

  • Pending：待定。
  • Approved：允许上线。
  • Rejected：不允许上线。
Approved
EvaluationSpecobject

评测配置

{}
CompressionSpecobject

压缩配置

{}
ExtraInfoobject

其它信息。

{ "CoverUris": ["https://e***u.oss-cn-hangzhou.aliyuncs.com/st****017.preview.png"], "TrainedWords": ["albedo_overlord"] }
Metricsobject

指标

{}

示例

正常返回示例

JSON格式

{
  "RequestId": "5A14FA81-DD4E-******-6343FE44B941",
  "GmtCreateTime": "2021-01-30T12:51:33.028Z",
  "GmtModifiedTime": "2021-01-30T12:51:33.028Z",
  "UserId": "1234567890******",
  "OwnerId": "1234567890******",
  "Uri": "oss://t***.cn-beijing.oss.aliyuncs.com/mod**/",
  "Labels": [
    {
      "Key": "env",
      "Value": "test"
    }
  ],
  "Options": "{}",
  "VersionName": "0.1.0",
  "VersionDescription": "通用情感分析。",
  "TrainingSpec": {},
  "InferenceSpec": {
    "Processor": "tensorflow_gpu_1.12"
  },
  "FormatType": "SavedModel",
  "FrameworkType": "TensorFlow",
  "SourceType": "PAIFlow",
  "SourceId": "region=cn-shanghai,workspaceId=13**,kind=PipelineRun,id=run-sakdb****jdf",
  "ApprovalStatus": "Approved",
  "EvaluationSpec": {},
  "CompressionSpec": {},
  "ExtraInfo": {
    "CoverUris": [
      "https://e***u.oss-cn-hangzhou.aliyuncs.com/st****017.preview.png"
    ],
    "TrainedWords": [
      "albedo_overlord"
    ]
  },
  "Metrics": {}
}

错误码

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

变更历史

变更时间变更内容概要操作
2024-07-19API 内部配置变更，不影响调用查看变更详情
2024-07-03OpenAPI 返回结构发生变更查看变更详情
2023-12-26OpenAPI 返回结构发生变更查看变更详情
2023-12-19OpenAPI 返回结构发生变更查看变更详情
2023-10-26OpenAPI 返回结构发生变更查看变更详情
上一篇：UpdateModelVersion - 更新模型版本下一篇：ListModelVersions - 获取模型版本列表
文档推荐