全部產品
Search

搜尋本產品

    Elastic Container Instance：UpdateImageCache - 更新一個鏡像緩衝

    文件中心

    Elastic Container Instance：UpdateImageCache - 更新一個鏡像緩衝

    更新時間：Oct 17, 2025

    調用UpdateImageCache更新一個鏡像緩衝。

    介面說明

    僅支援更新狀態為 Ready（建立完成）或者 UpdateFailed（更新失敗）的鏡像緩衝。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    eci:UpdateImageCache

    update

    *ImageCache

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

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    地區 ID。

    cn-hangzhou

    RegionId

    string

    是

    地區 ID。

    cn-hangzhou

    ImageCacheId

    string

    是

    鏡像緩衝 ID。

    imc-bp195erqe9o2pb09****

    SecurityGroupId

    string

    否

    安全性群組 ID。

    sg-uf66jeqopgqa9hdn****

    VSwitchId

    string

    否

    交換器 ID。

    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

    否

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

    說明

    如果您希望觸發一次鏡像緩衝的原地升級，而不需要更新緩衝鏡像列表，仍然需要傳入緩衝鏡像列表，否則鏡像資料不會更新到最新版本，只會重新整理 meta 資料。

    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 企業版執行個體資訊。

    object

    否

    ACR 企業版執行個體資訊。

    Domain

    array

    否

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

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

    string

    否

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

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

    string

    否

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

    test****
    InstanceId

    string

    否

    ACR 企業版執行個體 ID。

    cri-nwj395hgf6f3****

    RegionId

    string

    否

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

    cn-hangzhou
    StandardCopyCount

    integer

    否

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

    說明

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

    7
    FlashCopyCount

    integer

    否

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

    說明

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

    7
    EliminationStrategy

    string

    否

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

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

    LRU

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID，唯一標識。

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

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "0E234675-3465-4CC3-9D0F-9A864BC391DD"
}

    錯誤碼

    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 OperationConflict Request was denied due to conflict with a previous request. 該請求被禁止，因為與之前的請求衝突
    400 NoNeedUpdate There are no changes to be updated for current resource. 本次操作沒有需要更新的參數
    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許可權。

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

    變更歷史

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