全部產品
Search

搜尋本產品

    Platform For AI：AddImage - 添加鏡像

    文件中心

    Platform For AI：AddImage - 添加鏡像

    更新時間：Nov 18, 2025

    添加自訂鏡像到工作空間。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    paiimage:AddImage

    create

    *全部資源

    *

    		 無 無

    請求文法

    POST /api/v1/images HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    body

    object

    否

    請求結構體。

    Name

    string

    是

    鏡像名稱。命名規則如下：

    • 長度為 1~50 個英文字元。

    • 支援小寫字母、數字和虛線（-），以字母開頭。

    • 同一工作空間內不可重複。

    nlp-compression
    Description

    string

    否

    鏡像的描述資訊。

    NLP模型壓縮訓練鏡像
    ImageUri

    string

    是

    鏡像地址，可以重複。關於如何查看鏡像地址，詳情請參見 ListImage 。

    registry.cn-hangzhou.aliyuncs.com/pai-compression/nlp:gpu
    Labels

    array<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

    object

    否

    標籤。

    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
    SourceType

    string

    否

    SourceId

    string

    否

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結構體。

    RequestId

    string

    請求 ID。

    5A14FA81-DD4E-******-6343FE44B941
    ImageId

    string

    鏡像 ID。

    image-4c62******53uor

    樣本

    正常返回樣本

    JSON格式

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

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。