更新时间:2025-07-14 GMT+08:00

API概览

ModelArts服务所提供的接口均为自研接口。

通过ModelArts服务自研接口,您可以使用ModelArts开发环境、训练管理、AI应用管理及服务管理功能。

开发环境接口

表1 开发环境

类型

API

说明

开发环境实例管理

查询Notebook实例列表

可按需查询满足条件的开发环境实例列表。

创建Notebook实例

根据指定的实例规格、AI引擎镜像、存储等相关参数,创建一个开发环境实例。

查询Notebook实例详情

查询开发环境实例详情。

更新Notebook实例

更新开发环境实例。

删除Notebook实例

删除开发环境实例,删除的资源包括Notebook容器以及对应的所有存储资源。

通过运行的实例保存成容器镜像

运行的实例可以保存成容器镜像,保存的镜像中,安装的依赖包(pip包)不丢失,VSCode远程开发场景下,在Server端安装的插件不丢失。

查询支持的有效规格列表

查询支持的有效规格列表。

查询支持可切换规格列表

查询Notebook实例可切换的规格列表。

查询运行中的开发环境可用时长

查询运行中的开发环境可用时长。

Notebook时长续约

延长运行中的开发环境时长。

启动Notebook实例

启动Notebook实例。

停止Notebook实例

停止Notebook实例。

动态挂载OBS

获取动态挂载OBS实例信息列表

获取动态挂载OBS实例信息列表。

动态挂载OBS

在运行态Notebook实例,动态挂载OBS。

获取动态挂载OBS实例详情

获取动态挂载OBS实例详情。

动态卸载OBS

动态卸载OBS。

镜像管理

查询支持的镜像列表

根据指定条件分页查询满足条件的所有镜像。

注册自定义镜像

将用户自定义的镜像注册到ModelArts镜像管理。

查询用户镜像组列表

查询用户镜像信息概览,以镜像名称作为聚合的信息。

查询镜像详情

查询镜像详情。

删除镜像

删除镜像对象,对于个人私有镜像可以通过参数一并删除SWR镜像内容。

训练管理接口

表2 算法管理接口

API

说明

创建算法

创建一个算法。

查询算法列表

查询算法列表。

查询算法详情

根据算法ID查询指定算法。

更新算法

更新算法。

删除算法

删除算法。

表3 训练作业管理接口

API

说明

创建训练作业

创建训练作业。

查询训练作业详情

查询训练作业详情。

更新训练作业描述

更新训练作业描述。

删除训练作业

删除训练作业。

终止训练作业

终止训练作业,只可终止创建中、等待中、运行中的作业。

查询训练作业指定任务的日志(预览)

查询训练作业指定任务的日志(预览)。

查询训练作业指定任务的日志(OBS链接)

查询训练作业指定任务的日志(OBS链接),可全量查看或直接下载。

查询训练作业指定任务的运行指标

查询训练作业指定任务的运行指标。

查询训练作业列表

根据指定查询条件查询用户创建的训练作业列表。

表4 训练作业事件

API

说明

获取训练作业事件列表

获取训练作业事件列表。

表5 资源和引擎规格接口

API

说明

获取训练作业支持的公共规格

获取训练作业支持的公共规格。

获取训练作业支持的AI预置框架

获取训练作业支持的AI预置框架。

AI应用管理接口

表6 AI应用管理接口

API

说明

查询模型runtime

查询模型AI引擎以及runtime。

创建AI应用

创建AI应用。

查询AI应用列表

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

查询AI应用详情

查询AI应用详情,根据AI应用ID查询AI应用的详细信息。

删除AI应用

删除AI应用,根据AI应用ID删除指定AI应用,可以级联删除该AI应用下的所有版本。

APP认证管理接口

表7 APP认证管理接口

API

说明

获取APP列表

获取APIG APP基本信息列表,用户只能获取自己创建的APP信息。

创建APP

创建API网关应用(简称APP)。

查询APP详情

查询指定的APP详情。

删除APP

删除指定的APP。

增加AppCode

为指定API网关应用创建新的AppCode。

重置AppCode

重置指定API网关应用的指定的AppCode。

删除AppCode

删除指定API网关应用的指定的AppCode。

重置AppSecret

重置指定API网关应用的AppSecret。

获取用户绑定APP的api列表

获取用户绑定APP的API列表。

注册API并授权给APP

注册API并将API授权给APP。

删除API

删除指定的API,只有对API所属服务有删除权限的用户才可以删除API。

授权API至APP

将指定的API授权给APP。

更新API授权

更新API的授权关系。

解除API对APP的授权

解除指定的API对APP的授权。

获取API授权关系列表

获取指定的API与APP授权关系列表。

创建API

创建API,未将API授权给APP。

查询API

查询指定API详情。

查询API和APP

查询服务授权的API、APP信息。

查询APP的API认证信息

查询APP的API认证信息。

查询APP是否存在

查询APP是否存在。

服务管理接口

表8 服务管理接口

API

说明

通过patch操作对服务进行更新

通过patch操作对服务进行更新。

查询服务监控信息

查询服务监控信息。

查询服务列表

查询服务列表。

部署服务

部署服务。

查询支持的服务部署规格

查询支持的服务部署规格列表。

查询服务详情

查询服务详情,根据服务ID查询服务详情。

更新服务配置

更新模型服务配置。

删除服务

删除服务。

更新模型服务的单个属性

更新模型服务的单个属性,目前只支持instance_count(更新模型服务实例数量),仅运行中、告警、异常状态下的在线服务可以执行该操作。

查询服务事件日志

查询服务事件日志,包含服务的操作记录及部署过程中的关键动作、部署失败原因。

查询服务更新日志

查询实时服务更新日志。

添加资源标签

给指定服务添加标签(目前只支持在线服务),当添加的标签key已存在,则覆盖该标签的value。

删除资源标签

删除服务(目前只支持在线服务)的标签,支持批量删除。

查询推理服务标签

查询当前项目下的推理服务标签,默认查询所有工作空间,无权限不返回标签数据。

查询推理VPC访问通道信息的API

该接口用于查询推理VPC访问通道。

资源管理接口

表9 配置管理

API

说明

查询OS的配置参数

获取ModelArts OS服务的配置参数,如网络网段,用户资源配额等。

表10 插件模板管理

API

说明

查询插件模板

获取指定插件模板的详细信息。

表11 节点管理

API

说明

查询节点列表

查询资源池中的节点列表。

批量删除节点

批量删除指定资源池中的节点,资源池中至少保留一个节点。

批量对节点功能上锁

批量对节点功能上锁,被上锁的功能在控制台不能正常使用。

批量对节点功能解锁

批量对节点功能解锁,被上锁的功能在控制台不能正常使用,解锁后恢复正常。

表12 事件管理

API

说明

查询事件列表

查询事件列表。

表13 网络管理

API

说明

创建网络资源

创建网络资源。

查询网络资源列表

查询网络资源列表。

查询网络资源

查询指定网络资源的详情信息。

删除网络资源

删除指定网络资源。

更新网络资源

更新指定网络资源。

表14 资源指标管理

API

说明

查询资源实时利用率

查询当前项目下所有资源池的实时利用率。

表15 资源池管理

API

说明

创建资源池

用户创建资源池。

查询资源池列表

查询资源池列表。

查询资源池

查询指定资源池的详细信息。

删除资源池

删除指定的资源池。

更新资源池

更新指定的资源池。

资源池监控

获取资源池的监控信息。

资源池统计

获取资源池的统计信息。

表16 资源规格管理

API

接口

查询资源规格列表

查询资源规格列表。

表17 资源池作业管理

API

说明

查询专属资源池作业列表

查询专属资源池作业列表。

查询专属资源池作业统计信息

查询专属资源池作业统计信息。

Lite Server管理接口

表18 Lite Server管理接口

API

说明

查询用户所有DevServer实例列表

查询用户所有DevServer实例列表。

创建DevServer

创建DevServer。

查询DevServer实例详情

查询DevServer实例详情。

删除DevServer实例

删除DevServer实例。

实时同步用户所有DevServer实例状态

实时同步用户所有DevServer实例状态。

启动DevServer实例

启动DevServer实例。

停止DevServer实例

停止DevServer实例。

创建DevServer超节点标签

创建DevServer超节点标签。

删除DevServer超节点标签

删除DevServer超节点标签。

查询DevServer超节点标签

查询DevServer超节点标签。

重装DevServer服务器操作系统镜像

重装DevServer服务器操作系统镜像。

切换DevServer服务器操作系统镜像

切换DevServer服务器操作系统镜像。

切换DevServer超节点服务器操作系统镜像

切换DevServer超节点服务器操作系统镜像。

查询用户所有超节点实例详情

查询用户所有超节点实例详情。

删除DevServer超节点实例

删除DevServer超节点实例。

重启DevServer实例

重启DevServer实例。

启动DevServer超节点服务器

启动DevServer超节点服务器。

停止DevServer超节点服务器

停止DevServer超节点服务器。

授权管理接口

表19 授权管理接口

API

说明

查看授权列表

查看授权列表。

配置授权

配置ModelArts授权。若没有授权,ModelArts训练管理、开发环境、数据管理、在线服务等功能将不能正常使用。

删除授权

删除指定用户的授权或者删除全量用户的授权。

创建ModelArts委托

创建包含OBS、SWR、IEF等依赖服务的ModelArts委托。

配额管理

表20 配额管理

API

说明

查询OS的配额

获取ModelArts OS服务中部分资源的配额,如资源池配额、网络配额等。

资源标签管理

表21 资源标签管理

API

说明

查询资源池的所有标签

查询用户当前项目下资源池的所有标签,默认查询所有工作空间,无权限的工作空间不返回标签数据。

查询资源池上的标签

查询指定资源池的标签。

节点池管理

表22 节点池管理

API

说明

查询节点池列表

查询节点池列表。

创建节点池

创建节点池。

查询指定节点池详情

查询指定节点池详情。

更新节点池

更新节点池。

删除节点池

删除节点池。包周期资源池不支持。

查询节点池的节点列表

查询节点池的节点列表。