调用AddImage添加镜像_人工智能平台 PAI(PAI)-阿里云帮助中心

添加自定义镜像到工作空间。

调试

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

授权信息

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

请求语法

POST /api/v1/images

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求结构体。
Name	string	是	镜像名称。命名规则如下：长度为 1~50 个英文字符。支持小写字母、数字和短横线（-），以字母开头。工作空间内可重复。	nlp-compression
Description	string	否	镜像的描述信息。	NLP模型压缩训练镜像
ImageUri	string	是	镜像地址，可以重复。关于如何查看镜像地址，详情请参见 ListImage 。	registry.cn-hangzhou.aliyuncs.com/pai-compression/nlp:gpu
Labels	object []	否	镜像标签，是个数组，数组每一项包含 key 和 value 两个字段。官方镜像有如下标签：system.official=true 目前支持添加的键如下： system.chipType system.dsw.cudaVersion system.dsw.fromImageId system.dsw.fromInstanceId system.dsw.id system.dsw.os system.dsw.osVersion system.dsw.resourceType system.dsw.rootImageId system.dsw.stage system.dsw.tag system.dsw.type system.framework system.origin system.pythonVersion system.source system.supported.dlc system.supported.dsw
Key	string	否	标签的键。	system.chipType
Value	string	否	标签的值。	GPU
WorkspaceId	string	否	镜像所属的工作空间 ID。如何获取工作空间 ID，请参见 ListWorkspaces 。	15******45
Accessibility	string	否	镜像的可见性，目前支持： PUBLIC：当前工作空间所有成员都可以操作。 PRIVATE：只有创建者可以操作。	PUBLIC
Size	integer	否	镜像大小，单位为 GB。	2
ImageId	string	否	镜像 Id，如果不填，系统会自动生成。格式为 image-18 位大小写英文字母或者数字。	image-k83*****cv

返回参数

名称	类型	描述	示例值
	object	返回结构体。
RequestId	string	请求 ID。	5A14FA81-DD4E-******-6343FE44B941
ImageId	string	镜像 ID。	image-4c62******53uor

示例

正常返回示例

JSON格式

{
  "RequestId": "5A14FA81-DD4E-******-6343FE44B941",
  "ImageId": "image-4c62******53uor"
}

错误码

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

变更历史

变更时间

变更内容概要

操作

2023-06-26

API 内部配置变更，不影响调用

看变更集

变更项	变更内容
	API 内部配置变更，不影响调用。

2022-12-14

API 内部配置变更，不影响调用

看变更集

变更项	变更内容
	API 内部配置变更，不影响调用。

2022-12-14

API 内部配置变更，不影响调用

看变更集

变更项	变更内容
	API 内部配置变更，不影响调用。

2022-08-12

API 内部配置变更，不影响调用

看变更集

变更项	变更内容
	API 内部配置变更，不影响调用。

2021-09-22

新增 OpenAPI

看变更集