更新时间:2024-05-30 GMT+08:00

查询AI应用列表

功能介绍

查询AI应用列表,可以根据不同的检索参数进行查询。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/{project_id}/models

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

用户项目ID。获取方法请参见获取项目ID和名称

表2 Query参数

参数

是否必选

参数类型

描述

model_name

String

模型名称,可支持模糊匹配。当模型名称包含下划线时,由于下划线涉及转义处理,因此需要在请求中增加exact_match参数,且参数值设置为true,确保能够正常执行查询操作。

exact_match

String

是否对下划线进行转义处理,当模型名称包含下划线时,需要将该参数值设置为true,确保能够正常执行查询操作。默认不填该值。

model_version

String

模型版本。格式需为“数值:数值:数值”,其中数值为1-2位正整数,注意:版本不可以出现例如01.01.01等以0开头的版本号形式。

model_status

String

模型状态,可根据模型状态执行查询。模型状态:

  • publishing:发布中

  • published:已发布

  • failed:发布失败

  • building: 构建镜像中

  • building_failed: 构建失败

description

String

描述信息,可支持模糊匹配。

offset

Integer

指定要查询页的索引,默认为“0”。

limit

Integer

指定每一页返回的最大条目数,默认为“1000”。

sort_by

String

指定排序字段,枚举值如下:

  • create_at:默认值,AI应用创建时间

  • model_version:AI应用版本

  • model_size:AI应用大小

order

String

排序方式,枚举值如下:

  • asc: 递增排序

  • desc: 递减排序,默认值

workspace_id

String

工作空间id,默认是0。

model_type

String

模型类型,查询属于该类型的模型列表。model_type与not_model_type为互斥关系,不能同时存在。可选值为TensorFlow、PyTorch、MindSpore、Image、Custom、Template。

not_model_type

String

模型类型,查询不属于该类型的模型列表。可选值为TensorFlow、PyTorch、MindSpore、Image、Custom、Template。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

models

Array of ModelListItem objects

模型元数据信息。

total_count

Integer

不分页的情况下符合查询条件的总模型数量。

count

Integer

符合查询条件的模型数量。

表5 ModelListItem

参数

参数类型

描述

owner

String

模型所属租户的用户id。

model_version

String

模型版本。

model_type

String

模型类型。

description

String

模型描述信息。

project

String

模型所属租户的项目id。

source_type

String

模型来源的类型,仅当模型为自动学习部署过来时有值,取值为auto。

model_id

String

模型id。

model_source

String

模型来源。auto:自动学习;algos:预置算法;custom:自定义。

install_type

Array of strings

模型支持的部署类型列表。

model_size

Integer

模型大小,单位为字节数。

workspace_id

String

工作空间id,"0"表示默认空间。

model_status

String

模型状态。

market_flag

Boolean

标识模型是否来自市场。

tunable

Boolean

标识模型是否支持二次调优。true表示支持,false表示不支持。

model_name

String

模型名称。

create_at

Long

模型创建时间,距“1970.1.1 0:0:0 UTC”毫秒数。

publishable_flag

Boolean

标识模型是否可发布至市场。

source_copy

String

镜像复制开关,仅当“model_type”为“Image”时有效。

  • true:表示复制镜像模式,无法极速创建AI应用,SWR源目录中的镜像更改或删除不影响服务部署。

  • false:表示不复制镜像模式,可极速创建AI应用,更改或删除SWR源目录中的镜像会影响服务部署。 不设置值时,默认为复制镜像模式。

tenant

String

模型所属租户的账号id。

subscription_id

String

模型订阅ID。

extra

String

扩展字段。

specification

ModelSpecification object

模型部署最小部署规格。

表6 ModelSpecification

参数

参数类型

描述

min_cpu

String

最小CPU规格。

min_gpu

String

最小GPU规格。

min_memory

String

最小内存。

min_ascend

String

最小Ascend规格。

请求示例

GET https://{endpoint}/v1/{project_id}/models

响应示例

状态码: 200

模型列表

{
  "total_count" : 1,
  "count" : 1,
  "models" : [ {
    "model_name" : "mnist",
    "model_version" : "1.0.0",
    "model_id" : "10eb0091-887f-4839-9929-cbc884f1e20e",
    "model_type" : "tensorflow",
    "model_size" : 5012312,
    "tenant" : "6d28e85aa78b4e1a9b4bd83501bcd4a1",
    "project" : "d04c10db1f264cfeb1966deff1a3527c",
    "owner" : "6d28e85aa78b4e1a9b4bd83501bcd4a1",
    "create_at" : 1533041553000,
    "description" : "mnist model",
    "workspace_id" : "0",
    "specification" : { }
  } ]
}

状态码

状态码

描述

200

模型列表

错误码

请参见错误码