RedeployInstance - - Alibaba Cloud Documentation Center

Anda dapat memanggil operasi ini untuk menerapkan ulang instance ECS saat instance menerima notifikasi event.

Description

RedeployInstance adalah operasi asinkron yang melakukan migrasi data sebelum me-restart instance. Setelah penerapan ulang, instance akan berada dalam status Running (Running). Jika penerapan ulang gagal, instance akan kembali ke server fisik asal dan status semula.

Saat memanggil operasi ini, perhatikan hal-hal berikut:

Instance harus berada dalam status Running atau Stopped. Setelah diterapkan ulang, status instance berubah sebagai berikut:
- Jika instance berada dalam status Running (Running), instance akan berpindah ke status Stopping (Stopping).
- Jika instance berada dalam status Stopped (Stopped), instance akan berpindah ke status Starting (Starting).
Instance pada dedicated host tidak dapat diterapkan ulang.
Jika OperationLocks dalam respons DescribeInstances berisi "LockReason": "security" untuk instance tersebut, instance dikunci karena alasan keamanan dan tidak dapat diterapkan ulang.
Jika instance menerima event simulasi yang dibuat dengan memanggil operasi CreateSimulatedSystemEvent, Anda tidak dapat menerapkan ulang instance tersebut melalui operasi RedeployInstance.
Saat menangani event sistem terkait disk lokal, jika disk lokal yang rusak telah diisolasi tetapi event SystemMaintenance.RebootAndReInitErrorDisk (instance restart dan re-inisialisasi disk rusak akibat maintenance sistem) belum dikirim, Anda tetap dapat memanggil operasi RedeployInstance untuk menerapkan ulang instance tersebut. Untuk informasi selengkapnya, lihat Ikhtisar event sistem pada instance ECS yang dilengkapi disk lokal.

Tabel berikut mencantumkan jenis dan status event yang dapat ditanggapi dengan memanggil operasi RedeployInstance.

System event	Status
Instance restart due to system maintenance (SystemMaintenance.Reboot)	Inquiring and Scheduled
Instance redeployment due to system maintenance (SystemMaintenance.Redeploy)	Inquiring and Scheduled
Instance restart and replacement of damaged disks due to system maintenance (SystemMaintenance.RebootAndIsolateErrorDisk)	Inquiring
Instance restart and re-initialization of damaged disks due to system maintenance (SystemMaintenance.RebootAndReInitErrorDisk)	Inquiring
Instance redeployment due to a system error (SystemFailure.Redeploy)	Inquiring and Scheduled
For instances equipped with local disks only: instance restart due to a system error (SystemFailure.Reboot)	Executing
Isolation of damaged disks due to system maintenance (SystemMaintenance.IsolateErrorDisk)	Inquiring
Re-initialization of damaged disks due to system maintenance (SystemMaintenance.ReInitErrorDisk)	Inquiring

Catatan Saat sistem menerapkan ulang instance yang dilengkapi disk lokal, disk lokal tersebut akan diinisialisasi ulang dan data di dalamnya akan dihapus.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan 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	RedeployInstance	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke RedeployInstance.
InstanceId	String	Yes	i-bp1azkttqpldxgted****	ID instans tersebut.
ForceStop	Boolean	No	false	Menentukan apakah akan memaksa menghentikan instans yang berada dalam status Running. Nilai default: false. Catatan Efek dari penghentian paksa sama seperti kegagalan daya. Data dalam sistem operasi instans yang belum ditulis ke disk lokal mungkin hilang. Kami menyarankan agar Anda melakukan redeploy instans saat berada dalam status Stopped.

Response parameters

Parameter

Type

Example

Description

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID dari permintaan.

TaskId

String

t-bp10e8orkp8x****

ID dari task redeployment.

Anda dapat memanggil operasi DescribeTasks untuk mengkueri hasil migrasi.

Examples

Contoh permintaan

https://ecs.aliyuncs.com/?Action=RedeployInstance
&InstanceId=i-bp1azkttqpldxgted****
&<Common request parameters>

Contoh respons sukses

XML format

<RedeployInstanceResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <TaskId>t-bp10e8orkp8x****</TaskId>
</RedeployInstanceResponse>

JSON format

{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "TaskId": "t-bp10e8orkp8x****"
}

Error codes

HTTP status code	Error code	Error message	Description
404	InvalidInstanceId.NotFound	The InstanceId provided does not exist in our records.	Pesan kesalahan yang dikembalikan karena parameter InstanceId yang ditentukan tidak ada. Periksa apakah ID instance sudah benar.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat resource berada dalam status saat ini.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat instance dikunci karena alasan keamanan.
403	DiskError	IncorrectDiskStatus.	Pesan kesalahan yang dikembalikan karena status disk yang ditentukan tidak valid.
500	InternalError	The request processing has failed due to some unknown error.	Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	Pesan kesalahan yang dikembalikan karena instansi langganan telah kedaluwarsa. Perpanjang masa berlaku instance dan coba lagi.
403	IncorrectInstanceStatus	%s	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat instance berada dalam status saat ini.
403	InvalidOperation.RedeployInstance	%s	Pesan kesalahan yang dikembalikan karena operasi tidak valid.

Untuk daftar kode kesalahan, kunjungi API Error Center.