全部產品
Search

搜尋本產品

    DataWorks：CreateImage

    文件中心

    DataWorks：CreateImage

    更新時間：Oct 09, 2026

    建立映像。

    介面說明

    1. 需要購買 DataWorks 基礎版及以上版本才能使用。

    2. 請確保在使用該介面前，已建立服務關聯角色 AliyunServiceRoleForDataWorks。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dataworks:CreateImage

    create

    *All Resource

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Name

    string

    是

    映像名稱，可包含小寫字母、數字、底線（_），最多 128 個字元。

    task_image_001
    Description

    string

    否

    映像描述資訊，最多 128 個字元。

    create by xxxx
    Accessibility

    string

    否

    映像可見性：

    • Public：全員可見；

    • Private：僅建立者可見。

    枚舉值：

    • Private :

      Private

    • Public :

      Public

    Public
    ProviderType

    string

    是

    映像引用類型：

    • ACR：ACR 映像儲存庫；

    • DataWorks：DataWorks 官方映像。

    枚舉值：

    • ACR :

      容器映像服務 ACR。

    • DataWorks :

      DataWorks

    ACR
    Namespace

    string

    是

    映像命名空間，引用 DataWorks 官方映像填 DataWorks Default。

    namespace_name
    RepositoryName

    string

    是

    映像儲存庫名稱，引用 DataWorks 官方映像填 DataWorks Default。

    repo_name
    ProviderImageId

    string

    否

    映像提供方映像 ID，引用 DataWorks 官方映像必填。

    System_shell_20251201
    AcrInstanceId

    string

    否

    ACR 執行個體 ID，引用 ACR 映像必填。

    acr_instance_id
    ImageUri

    string

    否

    映像 URI，引用 ACR 映像必填。

    registry-vpc.cn-beijing.cr.aliyuncs.com/namespace/image:0.1.0
    AcrAssociatedVpcId

    string

    否

    ACR 執行個體關聯專有網路 ID，引用 ACR 映像必填。

    vpc-xxx
    EnableSyncMaxCompute

    boolean

    否

    是否同步映像至 MaxCompute，引用 ACR 映像時填寫，預設為 false。

    false
    Supported

    object

    是

    映像作用子用途。

    Module

    string

    否

    映像作用子模組：

    • Scheduler：資料開發。

    枚舉值：

    • Scheduler :

      Scheduler

    Scheduler
    TaskTypes

    array

    否

    映像支援的任務類型清單。

    string

    否

    支援的任務類型：

    • Shell

    • Python

    • ServerIDE

    • Notebook

    • PyODPS 2

    • PyODPS 3。

    枚舉值：

    • PyODPS 2 :

      PyODPS 2

    • Shell :

      Shell

    • Notebook :

      Notebook

    • PyODPS 3 :

      PyODPS 3

    • ServerIDE :

      ServerIDE

    • Python :

      Python

    Shell
    BuildConfig

    object

    否

    映像建置設定。

    BuildType

    string

    否

    建置類型。

    枚舉值：

    • PackageInstallation :

      安裝軟體套件。

    PackageInstallation
    PackageInstallationScripts

    array<object>

    否

    預安裝執行指令碼清單。

    object

    否

    預安裝執行指令碼。

    Type

    string

    否

    指令碼類型。

    枚舉值：

    • Yum :

      YUM

    • Script :

      指令碼。

    • Python2 :

      Python 2

    • Python3 :

      Python 3

    Python3
    Content

    string

    否

    指令碼內容，若為安裝套件名稱則以英文逗號分隔。

    requests
    ClientToken

    string

    是

    用戶端冪等 id。

    dasfsd-94fqwe-da8d

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    Success

    boolean

    是否請求成功。

    true
    ImageId

    string

    建立的映像 ID。

    Custom_image_xxxx_xxxx
    RequestId

    string

    請求的 ID，用於定位日誌，排查問題。

    6A6CBE87-9F91-1323-B680-E7A7065XXXXX

    樣本

    正常返回樣本

    JSON格式

    {
  "Success": true,
  "ImageId": "Custom_image_xxxx_xxxx",
  "RequestId": "6A6CBE87-9F91-1323-B680-E7A7065XXXXX"
}

    錯誤碼

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

    變更歷史

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