全部產品
Search

搜尋本產品

    Elastic Container Instance：CreateImageCache

    文件中心

    Elastic Container Instance：CreateImageCache

    更新時間：Aug 28, 2026

    呼叫 CreateImageCache 介面建立一個映像快取，以便後續建立 ECI 執行個體可以加速映像拉取，減少執行個體啟動耗時。

    介面說明

    注意事項

    • 建立映像快取涉及資源計費。建議您提前了解相關計費資訊。更多資訊，請參見映像快取計費。

    • 建立映像快取前，您需要評估待快取映像的總大小，如果映像總大小超過設定的快取大小，將會建立失敗。

    • 建立映像快取時，系統將自動建立一個 ECI 執行個體和一塊 ESSD PL1 類型的雲端硬碟用於中轉建立映像快取。建立過程中請勿刪除 ECI 執行個體和雲端硬碟，否則映像快取將建立失敗。

    • 建立映像快取將產生對應的快照。請勿刪除快照，否則映像快取將會失效。

    • 如果使用 SDK，則對應版本為：Java 1.0.10 以上，Python 1.0.7 以上。

    使用建議

    • 對於使用自訂網域的 ACR 企業版映像，需要指定 ACR 執行個體（設定 AcrRegistryInfo 相關參數）來配置免密。設定 AcrRegistryInfo 相關參數時，必須設定 AcrRegistryInfo.N.InstanceId。

    • 如果該映像快取將用於批次建立多個（超過 1000 個）ECI 執行個體，建議您設定 StandardCopyCount 和 FlashCopyCount 實現快照多副本功能。快照多副本按增量資料收費，由於本次建立的多個快照副本資料均一致，因此使用快照多副本功能不會增加額外費用。

    說明

    呼叫 CreateImageCache 建立映像快取時，系統將自動為您建立一個服務關聯角色 AliyunServiceRoleForECI，用於存取 ECS、VPC 等相關雲端服務。更多資訊，請參見彈性容器執行個體服務關聯角色。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    eci:CreateImageCache

    create

    *ImageCache

    acs:eci:{#regionId}:{#accountId}:imagecache/*
    • eci:tag
    		 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    地域 ID。

    cn-hangzhou
    RegionId

    string

    是

    可用區。

    cn-hangzhou-g
    ZoneId

    string

    否

    安全性群組 ID。

    sg-uf66jeqopgqa9hdn****
    SecurityGroupId

    string

    否

    交換器 ID。支援指定多個交換器 ID（單次最多 10 個），各交換器 ID 之間可以用半形逗號（,）進行分割，例如 vsw-***,vsw-***。

    vsw-uf6h3rbwbm90urjwa****
    VSwitchId

    string

    否

    映像快取名稱。

    testcache
    ImageCacheName

    string

    是

    彈性公網 IP。如果需要拉取公網映像，需要確保 ECI 執行個體能夠存取公網，您可以配置 EIP 或者 NAT 閘道器實現公網存取。

    eip-2zedsm5mfl3uhdj2d****
    EipInstanceId

    string

    否

    資源群組 ID。

    rg-aekzh43v*****
    ResourceGroupId

    string

    否

    保證請求冪等性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。只支援 ASCII 字元，且不能超過 64 個字元。更多資訊，請參見如何保證冪等性。

    123e4567-xxx-xxx-xxxx-42665544xxxx
    ClientToken

    string

    否

    映像快取的大小。預設為 20 GiB。

    20
    ImageCacheSize

    integer

    否

    映像快取保留時間，過期將會被清理，預設永不過期。

    說明

    建立失敗的映像快取僅保留一天。

    7
    RetentionDays

    integer

    否

    是否開啟映像快取複用。開啟後，新建立的映像快取可以複用已有映像快取的映像層，加快映像快取的製作速度。取值範圍：

    • true：開啟

    • false：不開啟

    預設為 false。

    true
    AutoMatchImageCache

    boolean

    否

    映像倉庫資訊。

    true
    ImageRegistryCredential

    array<object>

    否

    用於製作映像快取的容器映像。

    registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl

    object

    否

    用於製作映像快取的容器映像。

    registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
    Password

    string

    否

    鏡像倉庫密碼。

    password
    Server

    string

    否

    不帶 http:// 或 https:// 首碼的鏡像倉庫地址。

    registry-vpc.cn-hangzhou.aliyuncs.com
    UserName

    string

    否

    鏡像倉庫使用者名稱。

    username
    Image

    array

    是

    映像快取標籤資訊，最多 20 個。

    registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl

    string

    否

    映像快取標籤資訊，最多 20 個。

    registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
    Tag

    array<object>

    否

    是否開啟極速映像快取功能，開啟後，可以加速映像快取建立。取值範圍：

    • true：開啟

    • false：不開啟

    預設為 false。

    true

    object

    否

    鏡像緩衝標籤資訊，最多 20 個。

    Key

    string

    否

    鏡像緩衝標籤鍵。

    imc
    Value

    string

    否

    鏡像緩衝標籤值。

    test
    Flash

    boolean

    否

    ACR 執行個體資訊。更多資訊，請參見免密拉取 ACR 映像。

    true
    AcrRegistryInfo

    array<object>

    否

    註解。該參數暫不對外使用。

    hide

    object

    否

    ACR 執行個體資訊。

    Domain

    array

    否

    ACR 企業版執行個體的網域名稱。預設為相應執行個體的所有網域名稱。支援指定個別網域名稱，多個以半形逗號分隔。

    test****-registry.cn-beijing.cr.aliyuncs.com

    string

    否

    ACR 企業版執行個體的網域名稱。預設為相應執行個體的所有網域名稱。支援指定個別網域名稱，多個以半形逗號分隔。

    test****-registry.cn-beijing.cr.aliyuncs.com
    InstanceName

    string

    否

    ACR 企業版執行個體的名稱。

    test****
    InstanceId

    string

    否

    ACR 企業版執行個體 ID。

    cri-nwj395hgf6f3****
    RegionId

    string

    否

    ACR 企業版執行個體所屬地區。

    cn-beijing
    ArnService

    string

    否

    ECI 執行個體等資源歸屬帳號下的 RAM 角色的 ARN。

    acs:ram::1609982529******:role/role-assume
    ArnUser

    string

    否

    ACR 執行個體歸屬帳號下的 RAM 角色的 ARN。

    acs:ram::1298452580******:role/role-acr
    Annotations

    string

    否

    自建映像倉庫地址。使用 HTTP 通訊協定的自建映像倉庫中的映像建立映像快取時，需配置該參數，使得 ECI 使用 HTTP 通訊協定拉取映像，避免因通訊協定不同而導致映像拉取失敗。

    "harbor***.pre.com,192.168.XX.XX:5000,reg***.test.com:80"
    PlainHttpRegistry

    string

    否

    自建映像倉庫地址。

    使用自簽發憑證的自建映像倉庫中的映像建立映像快取時，需配置該參數來跳過憑證認證，避免因憑證認證失敗而導致映像拉取失敗。

    "harbor***.pre.com,192.168.XX.XX:5000,reg***.test.com:80"
    InsecureRegistry

    string

    否

    標準快照副本數。預設情況下，一個映像快取對應一個快照。如果該映像快取將用於批次建立多個 ECI 執行個體，建議您配置該參數實現快照多副本。推薦每 1000 個 ECI 執行個體增加一個快照副本。

    說明

    未開啟極速映像快取功能（Flash 取值為 false）時，建立映像快取的過程中僅產生標準快照。

    7
    StandardCopyCount

    integer

    否

    本機快照副本數。預設情況下，一個映像快取對應一個快照。如果該映像快取將用於批次建立多個 ECI 執行個體，建議您配置該參數實現快照多副本。推薦每 1000 個 ECI 執行個體增加一個快照副本。

    說明

    開啟極速映像快取功能（Flash 取值為 true）時，建立映像快取的過程中將先建立本機快照，在本機快照建立完成後開始建立標準快照，待標準快照建立完成後會自動刪除本機快照。

    7
    FlashCopyCount

    integer

    否

    映像快取的淘汰策略。預設為空，表示一直保留。

    支援配置為 LRU，表示可以被自動刪除。當映像快取數量達到配額限制時，系統將自動刪除最不常用的 EliminationStrategy 為 LRU 的映像快取。

    LRU
    EliminationStrategy

    string

    否

    容器映像的作業系統。取值範圍：

    • Linux（預設值）

    • Windows

    說明

    Windows 正在邀測中，如需使用，請提交工單申請。

    Linux
    OsType

    string

    否

    容器鏡像的作業系統。取值範圍：

    • Linux（預設值）

    • Windows

    說明

    Windows 正在邀測中，如需使用，請提交工單申請。

    Linux

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID，唯一標識。

    0E234675-3465-4CC3-9D0F-9A864BC391DD
    ImageCacheId

    string

    映像快取 ID。

    imc-2zebxkiifuyzzlhl****
    ContainerGroupId

    string

    用於中轉建立映像快取的 ECI 執行個體 ID。

    eci-2zebxkiifuyzzlhl****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "0E234675-3465-4CC3-9D0F-9A864BC391DD",
  "ImageCacheId": "imc-2zebxkiifuyzzlhl****",
  "ContainerGroupId": "eci-2zebxkiifuyzzlhl****"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 Account.Arrearage Your account has an outstanding payment. 帳號已經欠費。
    400 DryRunOperation Request validation has been passed with DryRun flag set. 此次 DryRun 預檢請求合格。
    400 InvalidParameter.CPU.Memory The specified cpu and memory are not allowed
    400 IncorrectStatus %s 指定的執行個體狀態不正確。
    400 ServiceNotEnabled %s 該次請求所依賴的服務尚未啟用，請啟用後再試。
    400 DiskVolume.NotSupport The disk volume is not supported. 雲端硬碟磁碟區暫不支援，如有需要請聯絡我們。
    400 RamRole.NotSupport The RAM role is not supported. RAM 執行個體角色不支援。
    400 ImageCache.IncorrectStatus %s 映像快取目前的狀態不正確。
    400 ImageCacheNotSupport Image cache is not available for all users. If you want to enable this function, contact us. 映像快取功能尚未全面開放，如果有需要請聯絡我們。
    400 EipAddressPoolIpNotEnough The ip address of specified PublicIpAddressPool is not enough. 指定的 EIP 公網地址池位址資源不足。
    400 OperationConflict The request was denied. It conflicts with a previous request.
    403 OperationDenied.VswZoneMisMatch The specified VSwitchId is not in the specified Zone.
    403 QuotaExceeded %s quota exceeded.
    403 Zone.NotOnSale The specified zone is not available for purchase. 建立執行個體的可用區已停止銷售，請更換其他可用區；或無法在該可用區使用指定 VPC 的虛擬交換器。
    403 Forbidden.RiskControl This operation has been identified as an abnormal operation and cannot be processed. 此操作已被確定為一個操作異常，無法處理。
    403 Forbidden.SubUser The specified action is not available for you.
    403 Forbidden.OnlyForInvitedTest Eci create action is only open to invited users during public beta.
    403 OperationDenied.SecurityGroupMisMatch The specified VSwitchId and SecurityGroupId are not in the same VPC.
    403 InvalidVSwitchId.IpNotEnough The specified VSwitch does not have enough IP addresses.
    403 Forbidden.UserBussinessStatus This operation is not allowed, because you have overdue bills. Pay the overdue bill and try again. 使用者處於欠費狀態不允許建立，請儲值後再嘗試。
    403 Forbidden.UserNotRealNameAuthentication This operation is not allowed, because you have not passed the real-name verification. 操作被禁止，因為使用者尚未進行實名驗證。
    403 InvalidUser.PassRoleForbidden The RAM user is not authorized to assume a RAM role. 子帳號使用者沒有權限使用 RAM 執行個體角色。
    403 OperationDenied.NoStock Sales of this resource are temporarily suspended in the specified zone. We recommend that you use the multi-zone creation function to avoid the risk of insufficient resource. For more information, see https://www.alibabacloud.com/help/document_detail/157290.html
    403 NoPermission The RAM role AliyunECIContainerGroupRole does not belong to eci.aliyuncs.com. Please check and try again.
    403 SecurityRisk.3DVerification We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email. 我們偵測到您的預設信用卡或金融卡存在安全風險。請透過電子郵件中的連結進行驗證。
    403 CreateServiceLinkedRole.Denied Please make sure the account has ram:CreateServiceLinkedRole permission. 請確保帳號擁有 ram:CreateServiceLinkedRole 權限。

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

    變更歷史

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