Gunakan API CreateImageCache untuk membuat cache image - Elastic Container Instance - Alibaba Cloud - Elastic Container Instance

Membuat cache gambar untuk mempercepat penarikan gambar dan mengurangi pengatur waktu startup saat pembuatan instans Elastic Container Instance (ECI) berikutnya.

Deskripsi operasi

Perhatian

Pembuatan cache gambar dikenakan biaya sumber daya. Pelajari informasi penagihan terlebih dahulu. Untuk informasi lebih lanjut, lihat Penagihan cache gambar.
Sebelum membuat cache gambar, evaluasi total ukuran gambar yang akan di-cache. Jika total ukuran gambar melebihi ukuran cache yang dikonfigurasi, pembuatan akan gagal.
Saat membuat cache gambar, sistem secara otomatis membuat instans ECI dan cloud disk ESSD PL1 untuk pembuatan otomatis gambar perantara. Jangan menghapus instans ECI atau cloud disk selama proses pembuatan. Jika tidak, pembuatan otomatis gambar akan gagal.
Pembuatan cache gambar menghasilkan snapshot yang sesuai. Jangan menghapus snapshot tersebut. Jika tidak, cache gambar akan menjadi tidak valid.
Jika Anda menggunakan SDK, versi yang diperlukan adalah Java 1.0.10 atau lebih baru, atau Python 1.0.7 atau lebih baru.

Rekomendasi

Untuk gambar Container Registry Edisi Perusahaan yang menggunakan nama domain kustom, tentukan instans Container Registry (dengan mengatur parameter AcrRegistryInfo) untuk mengonfigurasi akses tanpa kata sandi. Saat mengatur parameter AcrRegistryInfo, Anda harus mengatur AcrRegistryInfo.N.InstanceId.
Jika cache gambar akan digunakan untuk membuat sejumlah besar instans ECI (lebih dari 1.000) secara batch, atur StandardCopyCount dan FlashCopyCount untuk mengaktifkan fitur snapshot multi-salinan. Snapshot multi-salinan ditagih berdasarkan data inkremental. Karena data salinan snapshot yang dibuat pada waktu yang sama identik, fitur snapshot multi-salinan tidak mengenakan biaya tambahan.

Catatan

Saat Anda memanggil CreateImageCache untuk membuat cache gambar, sistem secara otomatis membuat peran terkait layanan bernama AliyunServiceRoleForECI untuk mengakses layanan cloud terkait seperti ECS dan VPC. Untuk informasi lebih lanjut, lihat Peran terkait layanan Elastic Container Instance.

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:CreateImageCache

create

*ImageCache

acs:eci:{#regionId}:{#accountId}:imagecache/*

eci:tag

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah.	cn-hangzhou
RegionId	string	Yes	Zona.	cn-hangzhou-g
ZoneId	string	No	ID grup keamanan.	sg-uf66jeqopgqa9hdn****
SecurityGroupId	string	No	ID vSwitch. Anda dapat menentukan beberapa ID vSwitch (hingga 10 sekaligus), dipisahkan dengan koma (,). Contoh: `vsw-*,vsw-*`.	vsw-uf6h3rbwbm90urjwa****
VSwitchId	string	No	Nama cache gambar.	testcache
ImageCacheName	string	Yes	Elastic IP Address (EIP). Jika Anda perlu menarik gambar dari Internet, pastikan instans ECI dapat mengakses Internet. Anda dapat mengonfigurasi EIP atau gerbang NAT untuk mengaktifkan akses jaringan publik.	eip-2zedsm5mfl3uhdj2d****
EipInstanceId	string	No	ID kelompok sumber daya.	rg-aekzh43v*****
ResourceGroupId	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.	123e4567-xxx-xxx-xxxx-42665544xxxx
ClientToken	string	No	Ukuran cache gambar. Nilai default: 20 GiB.	20
ImageCacheSize	integer	No	Periode retensi cache gambar. Cache gambar akan dihapus setelah kedaluwarsa. Secara default, cache gambar tidak pernah kedaluwarsa. Catatan Cache gambar yang gagal dibuat hanya disimpan selama satu hari.	7
RetentionDays	integer	No	Apakah akan mengaktifkan penggunaan ulang cache gambar. Jika fitur ini diaktifkan, cache gambar yang baru dibuat dapat menggunakan kembali layer gambar dari cache gambar yang ada, yang mempercepat pembuatan cache gambar. Nilai valid: true: Mengaktifkan penggunaan ulang cache gambar. false: Menonaktifkan penggunaan ulang cache gambar. Nilai default: false.	true
AutoMatchImageCache	boolean	No	Informasi repository image.	true
ImageRegistryCredential	array<object>	No	Gambar kontainer yang digunakan untuk membuat cache gambar.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
	object	No	Gambar kontainer yang digunakan untuk membuat cache gambar.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
Password	string	No	The password for the image repository.	password
Server	string	No	The address of the image repository. Do not include the `http://` or `https://` prefix.	registry-vpc.cn-hangzhou.aliyuncs.com
UserName	string	No	The username for the image repository.	username
Image	array	Yes	Informasi tag cache gambar. Anda dapat menentukan hingga 20 tag.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
	string	No	Informasi tag cache gambar. Anda dapat menentukan hingga 20 tag.	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
Tag	array<object>	No	Apakah akan mengaktifkan fitur cache gambar instan, yang mempercepat pembuatan cache gambar. Nilai valid: true: Mengaktifkan fitur cache gambar instan. false: Menonaktifkan fitur cache gambar instan. Nilai default: false.	true
	object	No	The tags of the image cache. You can specify up to 20 tags.
Key	string	No	The key of the image cache tag.	imc
Value	string	No	The value of the image cache tag.	test
Flash	boolean	No	Informasi instans Container Registry. Untuk informasi lebih lanjut, lihat Menarik gambar dari Container Registry tanpa menggunakan kata sandi.	true
AcrRegistryInfo	array<object>	No	Annotasi. Parameter ini tidak tersedia untuk penggunaan publik.	hide
	object	No	The information about the ACR instance.
Domain	array	No	The domain names of the ACR Enterprise instance. By default, all domain names of the instance are specified. You can specify one or more domain names. Separate multiple domain names with commas (,).	test****-registry.cn-beijing.cr.aliyuncs.com
	string	No	The domain names of the ACR Enterprise instance. By default, all domain names of the instance are specified. You can specify one or more domain names. Separate multiple domain names with commas (,).	test****-registry.cn-beijing.cr.aliyuncs.com
InstanceName	string	No	The name of the ACR Enterprise instance.	test****
InstanceId	string	No	The ID of the ACR Enterprise instance.	cri-nwj395hgf6f3****
RegionId	string	No	The region where the ACR Enterprise instance resides.	cn-beijing
ArnService	string	No	The Alibaba Cloud Resource Name (ARN) of the RAM role that belongs to the account of the resource, such as an ECI instance.	acs:ram::1609982529******:role/role-assume
ArnUser	string	No	The ARN of the RAM role that belongs to the account of the ACR instance.	acs:ram::1298452580******:role/role-acr
Annotations	string	No	Alamat repository image tarik mandiri. Saat Anda membuat cache gambar menggunakan gambar dari repository image tarik mandiri yang menggunakan protokol HTTP, konfigurasikan parameter ini agar ECI menarik gambar melalui HTTP, sehingga mencegah kegagalan penarikan gambar yang disebabkan oleh ketidakcocokan protokol.	"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"
PlainHttpRegistry	string	No	Alamat repository image yang dikelola sendiri. Saat Anda membuat cache gambar menggunakan gambar dari repository image yang dikelola sendiri yang menggunakan sertifikat yang ditandatangani sendiri, konfigurasikan parameter ini untuk melewatkan otentikasi sertifikat, sehingga mencegah kegagalan penarikan gambar yang disebabkan oleh kegagalan otentikasi sertifikat.	"harbor*.pre.com,192.168.XX.XX:5000,reg*.test.com:80"
InsecureRegistry	string	No	Jumlah salinan Snapshot reguler. Secara default, satu cache gambar berkorespondensi dengan satu snapshot. Jika cache gambar akan digunakan untuk membuat beberapa instans ECI secara batch, konfigurasikan parameter ini untuk mengaktifkan fitur snapshot multi-salinan. Kami menyarankan Anda menambahkan satu salinan snapshot untuk setiap 1.000 instans ECI. Catatan Saat fitur cache gambar instan dinonaktifkan (Flash diatur ke false), hanya Snapshot reguler yang dihasilkan selama pembuatan cache gambar.	7
StandardCopyCount	integer	No	Jumlah salinan snapshot lokal. Secara default, satu cache gambar berkorespondensi dengan satu snapshot. Jika cache gambar akan digunakan untuk membuat beberapa instans ECI secara batch, konfigurasikan parameter ini untuk mengaktifkan fitur snapshot multi-salinan. Kami menyarankan Anda menambahkan satu salinan snapshot untuk setiap 1.000 instans ECI. Catatan Saat fitur cache gambar instan diaktifkan (Flash diatur ke true), snapshot lokal dibuat terlebih dahulu selama pembuatan cache gambar. Setelah snapshot lokal dibuat, Snapshot reguler mulai dibuat. Setelah Snapshot reguler dibuat, snapshot lokal akan dihapus secara otomatis.	7
FlashCopyCount	integer	No	Strategi eliminasi cache gambar. Nilai default kosong, yang menunjukkan bahwa cache gambar selalu dipertahankan. Anda dapat mengatur parameter ini ke LRU, yang menunjukkan bahwa cache gambar dapat dihapus secara otomatis. Ketika jumlah cache gambar mencapai batas kuota, sistem secara otomatis menghapus cache gambar yang paling jarang digunakan yang EliminationStrategy-nya diatur ke LRU.	LRU
EliminationStrategy	string	No	Sistem operasi gambar kontainer. Nilai valid: Linux (default) Windows Catatan Windows berada dalam pratinjau undangan. Untuk menggunakannya, kirimkan tiket.	Linux
OsType	string	No	Sistem operasi gambar kontainer. Nilai valid: Linux (default) Windows Catatan Windows berada dalam pratinjau undangan. Untuk menggunakan fitur ini, kirim Tiket.	Linux

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan, yang merupakan pengidentifikasi unik.	0E234675-3465-4CC3-9D0F-9A864BC391DD
ImageCacheId	string	ID cache gambar.	imc-2zebxkiifuyzzlhl****
ContainerGroupId	string	ID instans dari instans ECI yang digunakan untuk pembuatan cache gambar perantara.	eci-2zebxkiifuyzzlhl****

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	Account.Arrearage	Your account has an outstanding payment.	Akun memiliki pembayaran tertunda.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	Permintaan Pemeriksaan Awal dry run valid.
400	InvalidParameter.CPU.Memory	The specified cpu and memory are not allowed
400	IncorrectStatus	%s	Status instans yang ditentukan tidak valid.
400	ServiceNotEnabled	%s	Layanan yang diperlukan oleh permintaan ini belum diaktifkan. Aktifkan layanan tersebut dan coba lagi.
400	DiskVolume.NotSupport	The disk volume is not supported.	Volume cloud disk tidak didukung. Hubungi kami jika Anda memerlukan fitur ini.
400	RamRole.NotSupport	The RAM role is not supported.	Peran instans RAM tidak didukung.
400	ImageCache.IncorrectStatus	%s	Cache gambar tidak berada dalam status yang benar.
400	ImageCacheNotSupport	Image cache is not available for all users. If you want to enable this function, contact us.	Fitur cache gambar belum tersedia di semua wilayah. Hubungi kami jika Anda memerlukan fitur ini.
400	EipAddressPoolIpNotEnough	The ip address of specified PublicIpAddressPool is not enough.	Kolam alamat publik EIP yang ditentukan tidak memiliki Sumber daya alamat yang cukup.
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.	Zona tempat Anda ingin membuat instans tidak lagi tersedia untuk dibeli. Gunakan zona lain, atau vSwitch dari VPC yang ditentukan tidak dapat digunakan di zona ini.
403	Forbidden.RiskControl	This operation has been identified as an abnormal operation and cannot be processed.	Operasi ini teridentifikasi sebagai abnormal dan tidak dapat diproses.
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.	Operasi dilarang karena akun memiliki pembayaran tertunda. Isi ulang akun Anda dan coba lagi.
403	Forbidden.UserNotRealNameAuthentication	This operation is not allowed, because you have not passed the real-name verification.	Operasi dilarang karena pengguna belum menyelesaikan verifikasi nama asli.
403	InvalidUser.PassRoleForbidden	The RAM user is not authorized to assume a RAM role.	Pengguna RAM tidak memiliki izin untuk menggunakan peran instans 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.	Risiko keamanan terdeteksi pada kartu kredit atau debit default Anda. Verifikasi kartu Anda menggunakan tautan dalam email.
403	CreateServiceLinkedRole.Denied	Please make sure the account has ram:CreateServiceLinkedRole permission.	Pastikan akun memiliki izin ram:CreateServiceLinkedRole.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.