全部产品
Search

搜索本产品

    Elastic Container Instance：UpdateImageCache

    文档中心

    Elastic Container Instance：UpdateImageCache

    更新时间：Dec 15, 2025

    Memperbarui cache gambar.

    Deskripsi operasi

    Anda hanya dapat memperbarui cache gambar yang berstatus 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 wilayah.

    cn-hangzhou

    RegionId

    string

    Yes

    ID wilayah.

    cn-hangzhou

    ImageCacheId

    string

    Yes

    ID cache gambar.

    imc-bp195erqe9o2pb09****

    SecurityGroupId

    string

    No

    ID security group.

    sg-uf66jeqopgqa9hdn****

    VSwitchId

    string

    No

    ID vSwitch.

    vsw-uf6h3rbwbm90urjwa****

    ImageCacheName

    string

    No

    Nama cache gambar.

    testcache
    EipInstanceId

    string

    No

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

    eip-2zedsm5mfl3uhdj2d****
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-aekzh43v*****

    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Hasilkan nilai yang unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

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

    integer

    No

    Ukuran cache gambar. Nilai default adalah 20 GiB.

    20
    RetentionDays

    integer

    No

    Periode retensi cache gambar dalam hari. Cache gambar akan kedaluwarsa dan dihapus setelah periode retensi berakhir. Secara default, cache gambar tidak pernah kedaluwarsa.

    Catatan

    Cache gambar yang gagal dibuat hanya disimpan selama satu hari.

    7
    AutoMatchImageCache

    boolean

    No

    Menentukan apakah akan mengaktifkan penggunaan ulang layer cache gambar. Jika fitur ini diaktifkan, sistem akan menggunakan ulang layer gambar dari cache gambar yang ada untuk mempercepat pembuatan cache gambar. Nilai yang valid:

    • true

    • false

    Nilai default: false.

    true
    ImageRegistryCredential

    array<object>

    No

    Kredensial repository gambar.

    object

    No

    Kredensial repository gambar.

    Password

    string

    No

    Password untuk repository gambar.

    password
    Server

    string

    No

    Alamat repository gambar. Jangan sertakan awalan http:// atau https://.

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

    string

    No

    Username untuk repository gambar.

    username
    Image

    array

    No

    Daftar container image yang digunakan untuk membuat cache gambar.

    Catatan

    Jika Anda ingin memicu peningkatan in-place cache gambar tanpa memperbarui daftar gambar, Anda tetap harus mengirimkan daftar gambar tersebut. Jika tidak, data gambar tidak akan diperbarui ke versi terbaru. Hanya metadata yang diperbarui.

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

    string

    No

    Container image yang digunakan untuk membuat cache gambar.

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

    array<object>

    No

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

    object

    No

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

    Key

    string

    No

    Kunci tag.

    imc
    Value

    string

    No

    Nilai tag.

    test
    Flash

    boolean

    No

    Menentukan apakah akan mengaktifkan fitur cache gambar instan. Fitur ini mempercepat pembuatan cache gambar. Nilai yang valid:

    • true

    • false

    Nilai default: false.

    true
    AcrRegistryInfo

    array<object>

    No

    Informasi tentang instans Container Registry (ACR) Edisi Perusahaan.

    object

    No

    Informasi tentang instans ACR Edisi Perusahaan.

    Domain

    array

    No

    Nama domain instans ACR Edisi Perusahaan. Secara default, semua nama domain instans digunakan. Anda dapat menentukan satu atau beberapa nama domain. Pisahkan beberapa nama domain dengan koma (,).

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

    string

    No

    Nama domain instans ACR Edisi Perusahaan. Secara default, semua nama domain instans digunakan. Anda dapat menentukan satu atau beberapa nama domain. Pisahkan beberapa nama domain dengan koma (,).

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

    string

    No

    Nama instans ACR Edisi Perusahaan.

    test****
    InstanceId

    string

    No

    ID instans ACR Edisi Perusahaan.

    cri-nwj395hgf6f3****

    RegionId

    string

    No

    Wilayah tempat instans ACR Edisi Perusahaan berada.

    cn-hangzhou
    StandardCopyCount

    integer

    No

    Jumlah replika snapshot standar. Secara default, satu snapshot dibuat untuk satu cache gambar. Jika cache gambar digunakan untuk membuat banyak instans ECI secara batch, konfigurasikan parameter ini untuk membuat beberapa replika snapshot. Kami menyarankan membuat satu replika snapshot untuk setiap 1.000 instans ECI.

    Catatan

    Jika fitur cache gambar instan dinonaktifkan (Flash diatur ke false), hanya snapshot standar yang dibuat saat cache gambar sedang dibuat.

    7
    FlashCopyCount

    integer

    No

    Jumlah replika snapshot lokal. Secara default, satu snapshot dibuat untuk satu cache gambar. Jika cache gambar digunakan untuk membuat banyak instans ECI secara batch, konfigurasikan parameter ini untuk membuat beberapa replika snapshot. Kami menyarankan membuat satu replika snapshot untuk setiap 1.000 instans ECI.

    Catatan

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

    7
    EliminationStrategy

    string

    No

    Kebijakan penggantian untuk cache gambar. Secara default, cache gambar tidak pernah diganti.

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

    LRU

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID 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.