ModifyImageAttribute - - Alibaba Cloud Documentation Center

Memodifikasi nama, deskripsi, status, atau image family dari custom image.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyImageAttribute	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyImageAttribute.
RegionId	String	Yes	cn-hangzhou	ID wilayah dari custom image. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
ImageId	String	Yes	m-bp18ygjuqnwhechc****	ID dari custom image.
ImageName	String	No	testImageName	Nama baru untuk custom image. Nama harus terdiri dari 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan acs: atau aliyun. Nama tidak boleh mengandung http:// atau https://. Nama dapat berisi huruf, angka, titik (.), titik dua (:), garis bawah (_), dan tanda hubung (-). Parameter ini kosong secara default, yang berarti nama asli dipertahankan.
Status	String	No	Deprecated	Status baru untuk custom image. Nilai yang valid: Deprecated: menempatkan image ke dalam status Deprecated. Jika custom image tersebut dibagikan, Anda harus berhenti membagikannya sebelum menetapkannya ke status Deprecated. Image dalam status Deprecated tidak dapat dibagikan atau disalin, tetapi masih dapat digunakan untuk membuat instans atau mengganti disk sistem. Available: menempatkan image ke dalam status Available. Anda dapat memulihkan image dari status Deprecated kembali ke status Available. Catatan Jika Anda ingin melakukan rollback custom image dalam image family ke versi sebelumnya, Anda dapat menetapkan custom image terbaru yang tersedia ke status Deprecated. Image family yang tidak memiliki custom image dalam status Available tidak dapat digunakan untuk membuat instans. Lakukan tindakan ini dengan hati-hati jika hanya satu custom image dalam image family yang berada dalam status Available.
ImageFamily	String	No	hangzhou-daily-update	Nama baru untuk image family. Nama harus terdiri dari 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan acs: atau aliyun. Nama tidak boleh mengandung http:// atau https://. Nama dapat berisi huruf, angka, titik (.), titik dua (:), garis bawah (_), dan tanda hubung (-). Parameter ini kosong secara default.
BootMode	String	No	BIOS	Mode boot baru untuk image. Nilai yang valid: BIOS UEFI Catatan Jika Anda membuat instans dari image setelah mode boot image diubah, instans baru akan menggunakan mode boot image yang baru. Untuk memastikan instans dapat dinyalakan sesuai harapan, pastikan mode boot yang ditentukan didukung oleh image tersebut. Jika Anda tidak tahu mode boot mana yang didukung oleh image, kami menyarankan Anda menggunakan fitur pemeriksaan image untuk melakukan pengecekan. Untuk informasi selengkapnya tentang fitur pemeriksaan image, lihat Overview of image check.
LicenseType	String	No	BYOL	Tipe lisensi yang digunakan untuk mengaktifkan sistem operasi setelah source image diimpor. Tetapkan nilainya ke BYOL. BYOL: Lisensi yang menyertai sistem operasi sumber digunakan. Dalam hal ini, pastikan kunci lisensi Anda dapat digunakan di Alibaba Cloud.
Description	String	No	testDescription	Deskripsi baru untuk custom image. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://. Parameter ini kosong secara default, yang berarti deskripsi asli dipertahankan.
Features.NvmeSupport	String	No	supported	Menentukan apakah protokol Non-Volatile Memory Express (NVMe) didukung. Nilai yang valid: supported: Image mendukung NVMe. Instans yang dibuat dari image ini mendukung protokol NVMe. unsupported: Image tidak mendukung NVMe. Instans yang dibuat dari image ini tidak mendukung protokol NVMe.

Response parameters

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	ID permintaan.

Examples

Contoh permintaan

http(s)://ecs.aliyuncs.com/?Action=ModifyImageAttribute
&RegionId=cn-hangzhou
&ImageId=m-bp18ygjuqnwhechc****
&ImageName=testImageName
&Status=Deprecated
&ImageFamily=hangzhou-daily-update
&BootMode=BIOS
&Description=testDescription
&Features={"NvmeSupport":"supported"}
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyImageAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyImageAttributeResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

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

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidImageName.Malformed	The specified Image name is wrongly formed.	Format ImageName tidak valid. Nama harus terdiri dari 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan acs: atau aliyun. Nama tidak boleh mengandung http:// atau https://. Nama dapat berisi huruf, angka, titik (.), titik dua (:), garis bawah (_), dan tanda hubung (-).
400	InvalidImageName.Duplicated	The specified Image name has already bean used.	Nama image yang ditentukan sudah ada.
400	InvalidDescription.Malformed	The specified description is wrongly formed.	Format Description tidak valid. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.
403	ImageStatus.NotAvailable	The specified image status is not available.	Image yang ditentukan tidak berada dalam status Available.
403	ImageStatus.NotDeprecated	The specified image status is not deprecated.	Image yang ditentukan tidak berada dalam status Deprecated.
403	OperationDeined.ImageUsingByInstance	The boot mode of the image cannot be modified because it has associated instances.	Mode boot image tidak dapat diubah selama image tersebut memiliki instans terkait.
404	InvalidImageId.NotFound	The specified ImageId does not exist.	Image yang ditentukan tidak ditemukan dalam akun ini. Periksa apakah ID image sudah benar.

Untuk daftar kode kesalahan, lihat Service error codes.