ResetDisk - - Alibaba Cloud Documentation Center

Memulihkan disk dari snapshot-nya.

Description

Saat memanggil operasi ini, perhatikan hal-hal berikut:

Disk harus berada dalam status In Use (In_Use) atau Unattached (Available).
Instans Elastic Compute Service (ECS) yang terhubung dengan disk tersebut harus berada dalam status Stopped. Anda dapat memanggil operasi StopInstances untuk menghentikan instans.
Snapshot yang ditentukan oleh parameter SnapshotId harus dibuat dari disk yang ditentukan oleh parameter DiskId.
Saat Anda memanggil operasi DescribeInstances untuk mengkueri informasi instans, jika respons berisi {"OperationLocks": {"LockReason" : "security"}} untuk suatu instans, maka instans tersebut dikunci karena alasan keamanan dan tidak dapat menjalankan operasi apa pun.

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 ini untuk berbagai SDK.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	ResetDisk	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ResetDisk.
DiskId	String	Yes	d-bp199lyny9b3****	ID disk yang ingin Anda pulihkan.
SnapshotId	String	Yes	s-bp199lyny9b3****	ID snapshot yang ingin Anda gunakan untuk memulihkan disk.
DryRun	Boolean	No	false	Menentukan apakah akan memeriksa validitas permintaan tanpa benar-benar melakukan permintaan tersebut. Nilai yang valid: true: Validitas permintaan diperiksa tetapi permintaan tidak dilakukan. Item yang diperiksa mencakup parameter yang diperlukan, format permintaan, dan batasan status sumber daya. Jika pemeriksaan gagal, pesan kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan `DryRunOperation` akan dikembalikan. false: Validitas permintaan diperiksa. Jika pemeriksaan berhasil, permintaan akan dilakukan. Nilai default: false.

Response parameters

Parameter	Type	Example	Description
RequestId	String	F3CD6886-D8D0-4FEE-B93E-1B732396****	ID permintaan.

Examples

Contoh permintaan

http(s)://ecs.aliyuncs.com/?Action=ResetDisk
&DiskId=d-bp199lyny9b3****
&SnapshotId=s-bp199lyny9b3****
&<Common request parameters>

Contoh respons sukses

XML format

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

<ResetDiskResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B732396****</RequestId>
</ResetDiskResponse>

JSON format

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

{
  "RequestId" : "F3CD6886-D8D0-4FEE-B93E-1B732396****"
}

Error codes

HTTP status code	Error code	Error message	Description
400	DiskCategory.OperationNotSupported	The operation is not supported to the specified disk due to its disk category	Pesan kesalahan yang dikembalikan karena kategori disk yang ditentukan tidak mendukung operasi ini.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid	Pesan kesalahan yang dikembalikan karena parameter RegionId yang ditentukan tidak valid.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	Pesan kesalahan yang dikembalikan karena permintaan Anda dianggap valid saat parameter DryRun diatur ke true.
403	IncorrectDiskStatus	The current disk status does not support this operation.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat disk berada dalam status saat ini. Pastikan disk dapat digunakan dan Anda tidak memiliki pembayaran tertunda untuk disk tersebut.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat sumber daya berada dalam status saat ini.
403	InstanceLockedForSecurity	The instance is locked due to security.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat instans dikunci karena alasan keamanan.
403	InvalidParameter.Mismatch	The specified snapshot is not created from the specified disk.	Pesan kesalahan yang dikembalikan karena snapshot terenkripsi tidak dapat digunakan untuk memulihkan disk yang tidak terenkripsi.
403	InvalidSnapshot.TooOld	The snapshotId is created before 2013-07-15, it cannot be restored since the first time the disk detached.	Pesan kesalahan yang dikembalikan karena snapshot yang dibuat sebelum 15 Juli 2013 tidak mendukung operasi ini.
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 instans tersebut dan coba lagi.
403	OperationDenied	The specified snapshot dees not support ResetDisk.	Pesan kesalahan yang dikembalikan karena snapshot yang ditentukan tidak mendukung operasi ini.
403	InvalidSnapshotId.NotReady	The specified snapshot has not completed yet.	Pesan kesalahan yang dikembalikan karena snapshot yang ditentukan sedang dalam proses pembuatan.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Pesan kesalahan yang dikembalikan karena saldo akun Anda tidak mencukupi. Tambahkan dana ke akun Anda dan coba lagi.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat layanan snapshot belum diaktifkan.
403	Operation.Conflict	The operation may conflicts with others.	Pesan kesalahan yang dikembalikan karena operasi ini bertentangan dengan operasi lain.
403	UserNotInTheWhiteList	The user is not in disk white list.	Pesan kesalahan yang dikembalikan karena Anda tidak memiliki otorisasi untuk mengelola disk tersebut. Coba lagi setelah Anda mendapatkan otorisasi.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	Pesan kesalahan yang dikembalikan karena kunci master pelanggan (CMK) tidak diaktifkan saat ID kunci Key Management Service (KMS) ditentukan untuk disk tersebut. Anda dapat memanggil operasi DescribeKey milik KMS untuk mengkueri informasi tentang CMK yang ditentukan.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.	Pesan kesalahan yang dikembalikan karena ECS tidak memiliki otorisasi untuk mengakses sumber daya KMS Anda.
404	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist.	Pesan kesalahan yang dikembalikan karena ID kunci KMS yang ditentukan tidak ada.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Pesan kesalahan yang dikembalikan karena parameter DiskId yang ditentukan tidak ada. Periksa apakah ID disk tersebut benar.
404	Disk.NotFound	The specified disk does not exist.	Pesan kesalahan yang dikembalikan karena parameter DiskId yang ditentukan tidak ada. Periksa apakah ID disk tersebut benar.
404	InvalidSnapshotId.NotFound	The specified SnapshotId does not exist.	Pesan kesalahan yang dikembalikan karena parameter SnapshotId yang ditentukan tidak ada.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Pesan kesalahan yang dikembalikan karena instans yang ditentukan tidak ada. Periksa apakah ID instans tersebut benar.
500	InternalError	The request processing has failed due to some unknown error.	Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.

Untuk daftar kode kesalahan, kunjungi API Error Center.