Mengganti sistem operasi instans Elastic Compute Service (ECS). Setelah penggantian sistem operasi dilakukan, disk asli akan dilepas dan disk sistem baru dibuat, sehingga ID disk sistem berubah.
Catatan penggunaan
Perhatikan hal-hal berikut:
Kategori disk sistem tidak dapat diubah.
Metode penagihan disk sistem tidak dapat diubah.
Instans harus dalam status
Stopped.CatatanPersyaratan ini hanya berlaku untuk instans yang berada di virtual private cloud (VPC). Jika instans merupakan instans pay-as-you-go dan mode hemat diaktifkan secara default, Anda harus menonaktifkan mode hemat serta mengaktifkan mode standar saat menghentikan instans. Tindakan ini mencegah instans gagal direstart akibat sumber daya ECS yang tidak mencukupi setelah penggantian disk sistem. Untuk informasi selengkapnya, lihat StopInstance.
Jika respons berisi
{"OperationLocks":{"LockReason" : "security"}}, instans dikunci karena alasan keamanan dan tidak dapat menjalankan operasi apa pun. Untuk informasi selengkapnya, lihat API behavior when an instance is locked for security reasons.Tidak boleh terdapat pesanan belum dibayar yang terkait dengan instans tersebut.
Anda dapat mengonfigurasi parameter
SystemDisk.Sizeuntuk menentukan kapasitas disk sistem baru.
Setelah memanggil operasi ini, Anda dapat menggunakan salah satu metode berikut untuk memverifikasi apakah disk sistem telah berhasil diganti:
Panggil operasi DescribeDisks untuk memeriksa status disk sistem baru. Jika disk sistem baru berstatus In_use, berarti penggantian disk sistem telah berhasil.
Panggil operasi DescribeInstances untuk memeriksa status instans yang disk sistemnya diganti. Jika parameter respons
OperationLockskosong, berarti penggantian disk sistem telah berhasil.
Debugging
Parameter permintaan
Parameter | Tipe | Diperlukan | Contoh | Deskripsi |
Action | String | Ya | ReplaceSystemDisk | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ReplaceSystemDisk. |
InstanceId | String | Ya | i-bp67acfmxazb4ph**** | ID instans. |
ImageId | String | Tidak | m-bp67acfmxazb4ph**** | ID gambar yang digunakan untuk mengganti disk sistem. Jika Anda tidak mengonfigurasi parameter |
SystemDisk.Size | Integer | Tidak | 80 | Kapasitas disk sistem baru. Satuan: GiB. Nilai valid:
Nilai default: Max{40, Ukuran gambar yang ditentukan oleh parameter ImageId}. Catatan Jika kapasitas disk sistem baru melebihi |
ClientToken | String | Tidak | 123e4567-e89b-12d3-a456-426655440000 | Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh lebih dari 64 karakter. Untuk informasi selengkapnya, lihat How to ensure idempotence. |
UseAdditionalService | Boolean | Tidak | true | Menentukan apakah akan menggunakan konfigurasi sistem untuk mesin virtual yang disediakan oleh Alibaba Cloud. Konfigurasi sistem untuk Windows: NTP dan KMS. Konfigurasi sistem untuk Linux: NTP dan YUM. Catatan Parameter ini hanya berlaku jika Anda menyambungkan disk sistem dengan nama perangkat /dev/xvda. |
Password | String | Tidak | EcsV587! | Menentukan apakah akan mengatur ulang password untuk instans. Password harus terdiri dari 8 hingga 30 karakter dan harus mengandung minimal tiga jenis karakter berikut: huruf kapital, huruf kecil, angka, dan karakter khusus. Karakter khusus yang diperbolehkan: Password instans Windows tidak boleh dimulai dengan garis miring (/). Parameter ini kosong secara default, yang berarti password saat ini tetap tidak berubah. Catatan Untuk alasan keamanan, kami menyarankan agar Anda menggunakan HTTPS untuk mengirim permintaan jika parameter |
PasswordInherit | Boolean | Tidak | false | Menentukan apakah akan menggunakan password yang telah ditetapkan sebelumnya dalam gambar. Nilai default: false. Catatan Jika Anda mengonfigurasi parameter PasswordInherit, Anda harus membiarkan parameter Password kosong dan memastikan bahwa gambar yang dipilih memiliki password yang telah ditetapkan sebelumnya. |
KeyPairName | String | Tidak | testKeyPairName | Nama pasangan kunci. Catatan Parameter ini hanya berlaku untuk instans Linux. Anda dapat mengikat pasangan kunci SSH ke instans sebagai kredensial logon. Setelah pasangan kunci SSH diikat, metode logon username-password dinonaktifkan untuk instans tersebut. |
DiskId | String | Tidak | d-bp67acfmxazb4ph**** | Catatan Parameter ini sudah tidak digunakan lagi. Kami menyarankan agar Anda menggunakan parameter |
Platform | String | Tidak | CentOS | Catatan Parameter ini sudah tidak digunakan lagi. |
Architecture | String | Tidak | i386 | Catatan Parameter ini sudah tidak digunakan lagi. |
SecurityEnhancementStrategy | String | Tidak | Active | Menentukan apakah akan menggunakan Security Center secara gratis setelah disk sistem diganti. Nilai valid:
Nilai default: Nonaktif. |
Encrypted | Boolean | Tidak | false | Menentukan apakah akan mengenkripsi disk sistem baru. Nilai valid:
Nilai default: false. |
KMSKeyId | String | Tidak | e522b26d-abf6-4e0d-b5da-04b7******3c | ID kunci Key Management Service (KMS) yang akan digunakan untuk disk sistem. |
EncryptAlgorithm | String | Tidak | hide | Catatan Parameter ini tidak tersedia untuk umum. |
Arn.N.RoleType | String | Tidak | null | Catatan Parameter ini tidak tersedia untuk umum. |
Arn.N.Rolearn | String | Tidak | null | Catatan Parameter ini tidak tersedia untuk umum. |
Arn.N.AssumeRoleFor | Long | Tidak | 0 | Catatan Parameter ini tidak tersedia untuk umum. |
Parameter respons
Parameter | Tipe | Contoh | Deskripsi |
DiskId | String | d-bp67acfmxazb4ph**** | ID disk sistem baru. |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E | ID permintaan. |
Contoh
Permintaan contoh
http(s)://ecs.aliyuncs.com/?Action=ReplaceSystemDisk
&InstanceId=i-bp67acfmxazb4ph****
&ImageId=m-bp67acfmxazb4ph****
&SystemDisk.Size=80
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&UseAdditionalService=true
&Password=EcsV587!
&PasswordInherit=false
&KeyPairName=testKeyPairName
&SecurityEnhancementStrategy=Active
&<Common request parameters>Respons sukses contoh
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<ReplaceSystemDiskResponse>
<DiskId>d-bp67acfmxazb4ph****</DiskId>
<RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ReplaceSystemDiskResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "337568C5-64F3-4B76-8CDD-D3D8C57B5B8C",
"DiskId" : "d-bp67acfmxazb4ph****"
}Kode kesalahan
Kode status HTTP | Kode kesalahan | Pesan kesalahan | Deskripsi |
400 | LoginAsNonRoot.ImageNotSupport | The specified image does not support login as non-root. | Gambar tersebut tidak mendukung logon pengguna non-root. |
400 | InvalidSystemDiskSize.ValueNotSupported | The specified parameter SystemDisk.Size is invalid. | Nilai SystemDisk.Size tidak valid. |
400 | InvalidParameter.Conflict | The specified image does not support the specified instance type. | Gambar tersebut tidak dapat digunakan untuk instans dengan tipe instans tersebut. |
400 | InvalidSystemDiskSize.ImageNotSupportResize | The specified image does not support resize. | Gambar yang ditentukan tidak mendukung pengubahan ukuran. |
400 | InvalidSystemDiskSize | The specified parameter SystemDisk.Size is invalid. | Nilai SystemDisk.Size tidak valid. |
400 | InvalidPasswordParam.Mismatch | The input password should be null when passwdInherit is true. | Password tidak dibiarkan kosong ketika PasswdInherit diatur ke true. |
400 | OperationDenied | The specified image contains the snapshot of the data disk,does not support this operation. | Operasi tidak diizinkan ketika gambar yang ditentukan berisi snapshot disk data. |
400 | InvalidParameter.Conflict | %s | Nilai parameter tidak valid. Periksa apakah terdapat konflik parameter. %s adalah variabel. Pesan kesalahan dikembalikan secara dinamis berdasarkan kondisi pemanggilan. |
400 | InvalidSystemDiskSize.ValueNotSupported | %s | Nilai SystemDisk.Size tidak valid. |
400 | OperationDenied | %s | Operasi ditolak. |
400 | InvalidKeyPairName.NotFound | The specified KeyPairName does not exist. | KeyPairName tidak ditemukan. |
400 | DependencyViolation.IoOptimize | The specified parameter InstanceId is not valid. | Konfigurasi optimasi I/O instans tidak valid. |
400 | MissingParameter.Architecture | Architecture should not be null. | Architecture wajib diisi. |
400 | InvalidArchitecture.Malformed | Architecture is not valid. | Nilai Architecture tidak valid. |
400 | MissingParameter.Platform | Platform should not be null. | Platform diperlukan. |
400 | InvalidPlatform.Malformed | Platform is not valid. | Nilai Platform tidak valid. |
400 | InvalidParameter.AllEmpty | %s | Parameter yang diperlukan tidak ditentukan. |
400 | InvalidDiskId.NotFound | The specified disk do not exist. | DiskId tidak ditemukan. |
400 | InvalidDatadisk.DiskStatusViolation | The operation is not permitted due to status of the Datadisk. | Disk data dalam status saat ini tidak mendukung operasi ini. |
400 | InvalidDatadisk.DiskCategoryViolation | The operation is not permitted due to category of the Datadisk. | Disk data dengan kategori tersebut tidak mendukung operasi ini. |
400 | InvalidSystemDiskSize.ValueNotSupported | The specified SystemDiskSize is not valid. | Nilai SystemDisk.Size tidak valid. |
400 | InvalidInstance.NotFoundSystemDisk | The specified instance has no system disk. | Instans yang ditentukan tidak memiliki disk sistem yang terpasang. Pastikan instans yang ditentukan memiliki disk sistem yang terpasang. Anda dapat memanggil operasi DescribeInstances untuk menanyakan detail instans tersebut. |
400 | InvalidStorageClusterId.CapacityNotEnough | The remaining capacity of the current dedicated storage cluster is less than the size of disk. | Kapasitas sisa kluster penyimpanan blok khusus tempat disk tersebut berada tidak mencukupi. |
400 | QuotaExceed.DiskCapacity | The used capacity of disk type has exceeded the quota in the zone, %s. | Kapasitas yang digunakan oleh disk dengan kategori tertentu melebihi batas kuota untuk zona tersebut. Anda dapat membuka Pusat Kuota untuk melihat dan menambah kuota kapasitas disk. |
403 | InvalidSystemDiskStatus.IsTransfering | The current status of the resource does not support this operation, system disk is transfering. | Sumber daya dalam status saat ini tidak mendukung operasi ini. Coba lagi setelah transmisi data disk sistem selesai. |
403 | IncorrectDiskStatus | The current disk status does not support this operation. | Operasi ini tidak dapat dilakukan pada disk dalam status saat ini. Pastikan disk tersedia dan Anda tidak memiliki pembayaran tertunda untuk disk tersebut. |
403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | Sumber daya dalam status saat ini tidak mendukung operasi ini. |
403 | InstanceLockedForSecurity | The instance is locked due to security. | Operasi tidak diizinkan ketika sumber daya dikunci karena alasan keamanan. |
403 | ImageNotSubscribed | The specified image has not be subscribed. | Anda belum berlangganan gambar tersebut di Alibaba Cloud Marketplace. |
403 | ImageRemovedInMarket | The specified market image is not available, Or the specified user defined image includes product code because it is based on an image subscribed from marketplace, and that image in marketplace includeing exact the same product code has been removed. | Gambar Alibaba Cloud Marketplace tidak tersedia, atau gambar kustom berisi kode produk dari gambar Alibaba Cloud Marketplace yang menjadi dasar pembuatan gambar kustom tersebut, dan gambar Alibaba Cloud Marketplace tersebut telah dihapus dari Alibaba Cloud Marketplace. |
403 | InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | Instans telah kedaluwarsa atau memiliki pembayaran tertunda. Perpanjang atau lunasi pembayaran instans tersebut dan coba lagi. |
403 | ChargeTypeViolation | The operation is not permitted due to charge type of the instance. | Operasi ini tidak dapat dilakukan pada instans yang menggunakan metode penagihan saat ini. |
403 | DiskCreatingSnapshot | The operation is denied due to a snapshot of the specified disk is not completed yet. | Snapshot sedang dibuat untuk disk yang ditentukan. |
403 | IoOptimized.NotSupported | The specified image is not support IoOptimized Instance. | Gambar tersebut tidak mendukung instans I/O teroptimasi. |
403 | ImageNotSupportInstanceType | The specified image don not support the InstanceType instance. | Gambar yang ditentukan tidak mendukung tipe instans tersebut. |
403 | QuotaExceed.BuyImage | The specified image is from the image market,You have not bought it or your quota has been exceeded. | Anda belum membeli gambar Alibaba Cloud Marketplace yang ditentukan atau kuota gambar Anda telah habis. |
403 | INST_HAS_UNPAID_ORDER | The instance has unpaid order. | Akun Anda memiliki pesanan belum dibayar untuk instans tersebut. |
403 | OperationDenied.InstanceCreating | The specified instance is creating. | Instans yang ditentukan sedang dalam proses pembuatan. |
403 | InvalidParameter.NotMatch | %s | Nilai parameter tidak valid. Periksa apakah terdapat konflik parameter. |
403 | ResourcesNotInSameZone | The specified instance and disk are not in the same zone. | Instans dan disk tidak berada di zona yang sama. |
403 | ImageNotSupportInstanceType | The specified instanceType is not supported by instance with marketplace image. | Gambar Alibaba Cloud Marketplace yang ditentukan tidak mendukung tipe instans tersebut. |
403 | OperationDenied.UnpaidOrder | The specified instance has unpaid order. | Anda memiliki pesanan belum dibayar untuk instans tersebut. Anda dapat login ke Konsol ECS untuk melunasi pesanan tersebut. |
403 | OperationDenied.ImageNotValid | %s | Gambar tersebut tidak mendukung operasi ini. |
403 | HibernationConfigured.InstanceOperationForbidden | The operation is not permitted due to limit of the hibernation configured instance. | Operasi tidak diizinkan karena batasan instans yang telah diaktifkan fitur hibernasi instans. |
403 | InvalidOperation.MultiAttachDisk | Multi attach disk does not support this operation. | Disk yang telah diaktifkan fitur multi-attach tidak mendukung operasi ini. |
403 | InvalidParameter.KmsNotEnabled | The specified operation need enable KMS. | Anda harus mengaktifkan KMS. |
403 | InvalidParameter.KMSKeyId.NotFound | The specified KMSKeyId does not exist. | KMSKeyId tidak ditemukan. |
403 | InvalidParameter.KMSKeyId.CMKNotEnabled | The CMK needs to be enabled. | CMK tidak diaktifkan saat ID CMK ditentukan untuk disk. Anda dapat memanggil operasi DescribeKey milik KMS untuk menanyakan informasi tentang CMK yang ditentukan. |
403 | InvalidParameter.KMSKeyId.KMSUnauthorized | ECS service have no right to access your KMS. | ECS tidak memiliki otorisasi untuk mengakses sumber daya KMS Anda. |
404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | InstanceId tidak ditemukan. |
404 | InvalidInstanceId.NotFound | The specified instance does not exist. | Instans tidak ditemukan. Periksa apakah ID instans sudah benar. |
404 | InvalidImageId.NotFound | The specified ImageId does not exist. | Gambar tidak ditemukan di akun ini. Periksa apakah ID gambar sudah benar. |
404 | InvalidSystemDiskSize.MoreThanMaxSize | The specified SystemDisk.Size parameter exceeds the maximum size. | Ukuran maksimum disk sistem telah terlampaui. |
404 | InvalidSystemDiskSize.LessThanImageSize | The specified parameter SystemDisk.Size is less than the image size. | Ukuran disk sistem lebih kecil daripada ukuran gambar. |
404 | InvalidSystemDiskSize.LessThanMinSize | The specified parameter SystemDisk.Size is less than the min size. | Ukuran disk sistem yang ditentukan lebih kecil daripada ukuran minimum yang diizinkan. |
404 | NoSuchResource | The specified resource is not found. | Sumber daya yang ditentukan tidak ditemukan. |
500 | OperationDenied | Internal Error. | Terjadi kesalahan internal. |
500 | InternalError | The request processing has failed due to some unknown error. | Terjadi kesalahan internal. Coba lagi nanti. |
500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | Terjadi kesalahan internal. Coba lagi nanti. |
Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.