All Products
Search

This Product

    Elastic Container Instance:UpdateImageCache

    Document Center

    Elastic Container Instance:UpdateImageCache

    Last Updated:Jun 10, 2026

    Memperbarui image cache.

    Deskripsi operasi

    Anda hanya dapat memperbarui image cache yang berada dalam status Ready atau UpdateFailed.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    eci:UpdateImageCache

    update

    *ImageCache

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

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID region.

    cn-hangzhou

    RegionId

    string

    Yes

    ID region.

    cn-hangzhou

    ImageCacheId

    string

    Yes

    ID dari image cache.

    imc-bp195erqe9o2pb09****

    SecurityGroupId

    string

    No

    ID dari security group.

    sg-uf66jeqopgqa9hdn****

    VSwitchId

    string

    No

    ID dari vSwitch.

    vsw-uf6h3rbwbm90urjwa****

    ImageCacheName

    string

    No

    Nama dari image cache.

    testcache
    EipInstanceId

    string

    No

    Alamat IP elastis (EIP). Untuk menarik image dari Internet, pastikan instance ECI memiliki akses Internet. Konfigurasikan EIP atau NAT Gateway untuk mengaktifkan akses Internet.

    eip-2zedsm5mfl3uhdj2d****
    ResourceGroupId

    string

    No

    ID dari resource group.

    rg-aekzh43v*****

    ClientToken

    string

    No

    Client token yang digunakan untuk memastikan idempotensi permintaan. Buat nilai yang unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.

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

    integer

    No

    Ukuran dari image cache. Nilai default adalah 20 GiB.

    20
    RetentionDays

    integer

    No

    Periode retensi image cache dalam hari. Image cache akan kedaluwarsa dan dibersihkan setelah periode retensi berakhir. Secara default, image cache tidak pernah kedaluwarsa.

    Catatan

    Image cache yang gagal dibuat hanya disimpan selama satu hari.

    7
    AutoMatchImageCache

    boolean

    No

    Menentukan apakah akan mengaktifkan penggunaan ulang lapisan image cache. Jika Anda mengaktifkan fitur ini, sistem akan menggunakan ulang lapisan image dari image cache yang sudah ada untuk mempercepat pembuatan image cache. Nilai yang valid:

    • true

    • false

    Nilai default: false.

    true
    ImageRegistryCredential

    array<object>

    No

    Kredensial dari image repository.

    object

    No

    Kredensial dari image repository.

    Password

    string

    No

    Kata sandi untuk image repository.

    password
    Server

    string

    No

    Alamat dari image repository. Jangan sertakan prefix http:// atau https://.

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

    string

    No

    Nama pengguna untuk image repository.

    username
    Image

    array

    No

    Daftar container image yang digunakan untuk membuat image cache.

    Catatan

    Jika Anda ingin memicu peningkatan in-place pada image cache tanpa memperbarui daftar image, Anda tetap harus menyertakan daftar image. Jika tidak, data image tidak akan diperbarui ke versi terbaru. Hanya metadata yang akan disegarkan.

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

    string

    No

    Container image yang digunakan untuk membuat image cache.

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

    array<object>

    No

    Tag yang akan dilampirkan ke image cache. Anda dapat melampirkan hingga 20 tag.

    object

    No

    Tag yang akan dilampirkan ke image cache. Anda dapat melampirkan hingga 20 tag.

    Key

    string

    No

    Kunci dari tag.

    imc
    Value

    string

    No

    Nilai dari tag.

    test
    Flash

    boolean

    No

    Menentukan apakah akan mengaktifkan fitur instant image cache. Fitur ini mempercepat pembuatan image cache. Nilai yang valid:

    • true

    • false

    Nilai default: false.

    true
    AcrRegistryInfo

    array<object>

    No

    Informasi tentang instance Container Registry (ACR) Enterprise Edition.

    object

    No

    Informasi tentang instance ACR Enterprise Edition.

    Domain

    array

    No

    Nama domain dari instance ACR Enterprise Edition. Secara default, semua nama domain dari instance digunakan. Anda dapat menentukan satu atau lebih nama domain. Pisahkan beberapa nama domain dengan koma (,).

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

    string

    No

    Nama domain dari instance ACR Enterprise Edition. Secara default, semua nama domain dari instance digunakan. Anda dapat menentukan satu atau lebih nama domain. Pisahkan beberapa nama domain dengan koma (,).

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

    string

    No

    Nama dari instance ACR Enterprise Edition.

    test****
    InstanceId

    string

    No

    ID dari instance ACR Enterprise Edition.

    cri-nwj395hgf6f3****

    RegionId

    string

    No

    Region tempat instance ACR Enterprise Edition berada.

    cn-hangzhou
    StandardCopyCount

    integer

    No

    Jumlah replika snapshot standar. Secara default, satu snapshot dibuat untuk satu image cache. Jika image cache digunakan untuk membuat beberapa instance ECI secara batch, konfigurasikan parameter ini untuk membuat beberapa replika snapshot. Kami merekomendasikan untuk membuat satu replika snapshot untuk setiap 1.000 instance ECI.

    Catatan

    Jika fitur instant image cache dinonaktifkan (Flash diatur ke false), hanya snapshot standar yang akan dibuat saat image cache sedang dibuat.

    7
    FlashCopyCount

    integer

    No

    Jumlah replika snapshot lokal. Secara default, satu snapshot dibuat untuk satu image cache. Jika image cache digunakan untuk membuat beberapa instance ECI secara batch, konfigurasikan parameter ini untuk membuat beberapa replika snapshot. Kami merekomendasikan untuk membuat satu replika snapshot untuk setiap 1.000 instance ECI.

    Catatan

    Jika fitur instant image cache diaktifkan (Flash diatur ke true), sistem akan membuat snapshot lokal terlebih dahulu. Setelah snapshot lokal dibuat, sistem mulai membuat snapshot standar. Setelah snapshot standar dibuat, snapshot lokal akan dihapus secara otomatis.

    7
    EliminationStrategy

    string

    No

    Kebijakan eviction untuk image cache. Secara default, image cache tidak pernah di-evict.

    Atur parameter ini ke `LRU` untuk mengizinkan penghapusan otomatis. Jika Anda mengatur kebijakan ke `LRU`, ketika jumlah image cache mencapai kuota, sistem akan secara otomatis menghapus cache yang paling jarang digunakan.

    LRU

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID dari permintaan.

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

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 Account.Arrearage Your account has an outstanding payment. Your account has an outstanding payment.
    400 DryRunOperation Request validation has been passed with DryRun flag set. Request validation has been passed with DryRun flag set.
    400 InvalidParameter.CPU.Memory The specified cpu and memory are not allowed
    400 IncorrectStatus %s
    400 ServiceNotEnabled %s The service on which this request depends has not been activated. Please activate and try again.
    400 DiskVolume.NotSupport The disk volume is not supported. Disk volume does not support your structure. If you want to enable this function, contact us.
    400 RamRole.NotSupport The RAM role is not supported. The RAM role is not supported.
    400 ImageCache.IncorrectStatus %s
    400 ImageCacheNotSupport Image cache is not available for all users. If you want to enable this function, contact us. Container image cache is currently not available to all users. Submit a ticket if you need to use the feature.
    400 OperationConflict Request was denied due to conflict with a previous request. Request was denied due to conflict with a previous request.
    400 NoNeedUpdate There are no changes to be updated for current resource. 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.
    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. The RAM user is not authorized to assume a RAM role.
    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. Please make sure the account has ram:CreateServiceLinkedRole permission.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.