全部產品
Search

搜尋本產品

    Elastic Container Instance：CreateImageCache - 建立一個鏡像緩衝

    文件中心

    Elastic Container Instance：CreateImageCache - 建立一個鏡像緩衝

    更新時間：Oct 17, 2025

    調用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 等相關雲端服務。更多資訊，請參見Elastic Container Instance服務關聯角色。

    調試

    您可以在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

    是

    地區 ID。

    cn-hangzhou
    ZoneId

    string

    否

    可用性區域。

    cn-hangzhou-g
    SecurityGroupId

    string

    否

    安全性群組 ID。

    sg-uf66jeqopgqa9hdn****
    VSwitchId

    string

    否

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

    vsw-uf6h3rbwbm90urjwa****
    ImageCacheName

    string

    是

    鏡像緩衝名稱。

    testcache
    EipInstanceId

    string

    否

    彈性公網 IP。如果需要拉取公網鏡像，需要確保 ECI 執行個體能夠訪問公網，您可以配置 EIP 或者 NAT Gateway實現公網訪問。

    eip-2zedsm5mfl3uhdj2d****
    ResourceGroupId

    string

    否

    資源群組 ID。

    rg-aekzh43v*****
    ClientToken

    string

    否

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

    123e4567-xxx-xxx-xxxx-42665544xxxx
    ImageCacheSize

    integer

    否

    鏡像緩衝的大小。預設為 20 GiB。

    20
    RetentionDays

    integer

    否

    鏡像緩衝保留時間，到期將會被清理，預設永不到期。

    說明

    建立失敗的鏡像緩衝僅保留一天。

    7
    AutoMatchImageCache

    boolean

    否

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

    • true：開啟

    • false：不開啟

    預設為 false。

    true
    ImageRegistryCredential

    array<object>

    否

    鏡像倉庫資訊。

    object

    否

    鏡像倉庫資訊。

    Password

    string

    否

    鏡像倉庫密碼。

    password
    Server

    string

    否

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

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

    string

    否

    鏡像倉庫使用者名稱。

    username
    Image

    array

    是

    用於製作鏡像緩衝的容器鏡像。

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

    string

    否

    用於製作鏡像緩衝的容器鏡像。

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

    array<object>

    否

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

    object

    否

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

    Key

    string

    否

    鏡像緩衝標籤鍵。

    imc
    Value

    string

    否

    鏡像緩衝標籤值。

    test
    Flash

    boolean

    否

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

    • true：開啟

    • false：不開啟

    預設為 false。

    true
    AcrRegistryInfo

    array<object>

    否

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

    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

    否

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

    hide
    PlainHttpRegistry

    string

    否

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

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

    string

    否

    自建鏡像倉庫地址。

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

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

    integer

    否

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

    說明

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

    7
    FlashCopyCount

    integer

    否

    本地快照副本數。預設情況下，一個鏡像緩衝對應一個快照。如果該鏡像緩衝將用於大量建立多個 ECI 執行個體，建議您配置該參數實現快照多副本。推薦每 1000 個 ECI 執行個體增加一個快照副本。

    說明

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

    7
    EliminationStrategy

    string

    否

    鏡像緩衝的淘汰策略。預設為空白，表示一直保留。

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

    LRU
    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許可權。

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

    變更歷史

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