ModifyImageAttribute - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengubah atribut gambar kustom, seperti keluarga gambar, nama, mode boot, status, dan dukungan NVMe.

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

ecs:ModifyImageAttribute

update

*Image.

acs:ecs:{#regionId}:{#accountId}:image/{#imageId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah gambar kustom. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
ImageId	string	Yes	ID gambar kustom.	m-bp18ygjuqnwhechc****
ImageName	string	No	Nama gambar kustom. Panjang nama harus antara 2 hingga 128 karakter. Nama harus dimulai dengan huruf atau karakter Tionghoa dan tidak boleh dimulai dengan `aliyun` atau `acs:`. Nama tidak boleh mengandung `http://` atau `https://`. Nama dapat berisi angka, titik (.), titik dua (:), garis bawah (_), atau tanda hubung (-). Nilai default: null, yang menunjukkan bahwa nama asli dipertahankan.	testImageName
Status	string	No	Status gambar. Nilai valid: Deprecated: Mengatur gambar ke status deprecated. Jika Anda telah membagikan gambar kustom, Anda harus membatalkan pembagian sebelum mengaturnya ke status deprecated. Gambar yang deprecated tidak dapat dibagikan atau disalin. Namun, Anda dapat menggunakan gambar tersebut untuk membuat Instance ECS atau mengganti disk sistem. Available: Mengatur gambar ke status available. Anda dapat memulihkan gambar deprecated ke status available. Catatan Untuk mengembalikan gambar kustom dalam keluarga gambar ke versi sebelumnya, Anda dapat mengatur gambar kustom available terbaru ke status deprecated. Namun, jika gambar tersebut adalah satu-satunya gambar kustom available dalam keluarga gambar, keluarga gambar tersebut tidak akan memiliki gambar kustom available untuk membuat Instance ECS setelah gambar dideprecated. Lakukan dengan hati-hati.	Deprecated
ImageFamily	string	No	Nama keluarga gambar. Panjang nama harus antara 2 hingga 128 karakter. Nama harus dimulai dengan huruf atau karakter Tionghoa dan tidak boleh dimulai dengan `aliyun` atau `acs:`. Nama tidak boleh mengandung `http://` atau `https://`. Nama dapat berisi angka, titik (.), titik dua (:), garis bawah (_), atau tanda hubung (-). Nilai default: null.	hangzhou-daily-update
BootMode	string	No	Mode boot gambar. Nilai valid: BIOS: Mode boot Basic Input/Output System (BIOS). UEFI: Mode boot Unified Extensible Firmware Interface (UEFI). UEFI-Preferred: Mode boot ganda. Penting Untuk mencegah kegagalan start Instans akibat mode boot yang tidak didukung, pastikan Anda memahami mode boot yang didukung oleh gambar sebelum mengubah parameter ini. Untuk informasi lebih lanjut tentang mode boot gambar, lihat Mode boot gambar. Valid values: BIOS : BIOS. UEFI : UEFI. UEFI-Preferred : UEFI-Preferred.	BIOS
LicenseType	string	No	Tipe lisensi yang digunakan untuk mengaktifkan sistem operasi setelah gambar diimpor. Saat ini, hanya BYOL yang didukung. BYOL: Lisensi yang disertakan dengan sistem operasi sumber. Saat menggunakan BYOL, pastikan kunci lisensi Anda mendukung penggunaan di Alibaba Cloud.	BYOL
Description	string	No	Deskripsi gambar kustom. Panjang deskripsi harus antara 2 hingga 256 karakter dan tidak boleh dimulai dengan `http://` atau `https://`. Nilai default: null, yang menunjukkan bahwa deskripsi asli dipertahankan.	testDescription
Features	object	No	Atribut fitur gambar.
NvmeSupport	string	No	Mengubah atribut dukungan NVMe gambar. Jika parameter ini tidak ditentukan, nilai saat ini dipertahankan. Penting Sebelum mengaktifkan fitur ini, pastikan driver NVMe sudah terinstal sebelumnya di sistem operasi. Prosedur yang direkomendasikan: instal driver pada instans, buat gambar kustom, lalu panggil operasi ini. Mengaktifkan fitur ini secara paksa tanpa driver akan menyebabkan kegagalan start instans.	supported
ImdsSupport	string	No	Mode akses metadata gambar. Nilai valid: v1: Saat Anda membuat Instance ECS dari gambar ini, Anda tidak dapat mengatur mode akses metadata hanya ke IMDSv2 (mode hardened). v2: Saat Anda membuat Instance ECS dari gambar ini, Anda dapat mengatur mode akses metadata hanya ke IMDSv2 (mode hardened). Penting ImdsSupport tidak dapat diubah dari v2 ke v1. Jika Anda perlu mengubahnya, buat gambar baru dari snapshot yang terkait dengan gambar ini dan atur nilainya ke v1.	v2
DryRun	boolean	No

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidImageName.Malformed	Image names must be between 2 and 128 characters long, using either English or Chinese characters. The name must start with a letter or a Chinese character, and can include numbers, colons, underscores and hyphens.	Panjang nama image harus 2 hingga 128 karakter. Nama harus dimulai dengan huruf atau karakter Tionghoa, dan dapat berisi angka, titik dua (:), garis bawah (_), atau tanda hubung (-).
400	MissingParameter	The input parameter "RegionId" that is mandatory for processing this request is not supplied.
400	InvalidImageName.Duplicated	The specified Image name has already bean used.	Nama image yang ditentukan sudah digunakan.
400	InvalidDescription.Malformed	The specified description is wrongly formed.	Parameter description yang ditentukan tidak valid.
400	ImageQuotaFull.ImageFamily	The specified image family has exceeded max number of images for one image family.
400	InvalidImageFamily.Malformed	The specified parameter "ImageFamily" is malformed.
400	ImageFamilyQuotaFull	The specified region has exceeded max number of image family.
400	InvalidBootMode.NotSupport	The specified parameter BootMode is not supported.
400	InvalidLicenseType.NotSupported	The specified parameter LicenseType is not supported.
400	InvalidParameter.FeaturesImdsSupport	The specified parameter Features.ImdsSupport is not supported.	Parameter Features.ImdsSupport yang ditentukan tidak didukung.
403	ImageStatus.NotAvailable	The specified image status is not available.	Status image yang ditentukan bukan Available.
403	ImageStatus.NotDeprecated	The specified image status is not deprecated.	Status image yang ditentukan bukan Deprecated.
403	ImageUseShared	The specified image has been shared to others, please remove shared accounts first.
403	OperationDeined.ImageUsingByInstance	The boot mode of the image cannot be modified because it has associated instances.	Atribut mode boot image tidak dapat diubah ketika image memiliki Instansi terkait.
403	InvalidOperation.FeaturesImdsSupportNotMatch	The specified parameter Features.ImdsSupport can not be set to v1 from v2.	Parameter Features.ImdsSupport yang ditentukan tidak dapat diubah dari v2 ke v1.
403	InvalidStatus.ImageIsCreating	The operation cannot be performed because the image is creating. Please wait until the creation is complete and try again.	Image masih sedang dibuat. Operasi ini tidak dapat dilakukan. Tunggu hingga image selesai dibuat, lalu coba lagi.
403	InvalidOperation.PublicImageUnsupported	The community image's publisher is not the current account. Modification is not permitted.	Penerbit gambar komunitas bukan akun saat ini. Modifikasi tidak diizinkan.
403	InvalidDescription.Malformed	The specified parameter description is not valid.	Parameter description yang ditentukan tidak valid.
403	InvalidBootMode.SecureBootUnsupported	Secure Boot requires UEFI or UEFI-Preferred boot mode. Please check the BootMode and try again.	Secure boot memerlukan mode boot UEFI atau UEFI-Preferred. Periksa mode boot dan coba lagi.
404	InvalidImageId.NotFound	The specified ImageId does not exist.	Image yang ditentukan tidak ditemukan. Pastikan image ada di wilayah saat ini dan statusnya tersedia.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.