ResetDisk - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengembalikan disk ke status sebelumnya dengan menggunakan snapshot disk.

Deskripsi operasi

Sebelum memanggil operasi ini, baca Mengembalikan disk dengan menggunakan snapshot.

Saat memanggil operasi ini, perhatikan hal-hal berikut:

Disk harus berada dalam status In Use (In_use) atau Available (Available).
Instans tempat disk terpasang harus berada dalam status Stopped (Stopped). Anda dapat memanggil StopInstances untuk menghentikan instans.
Parameter SnapshotId yang ditentukan harus berupa snapshot historis yang dibuat dari disk yang ditentukan oleh DiskId.
Saat memanggil DescribeInstances untuk mengkueri informasi Instance ECS, jika tanggapan berisi {"OperationLocks": {"LockReason" : "security"}}, semua operasi pada instans dilarang.

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:ResetDisk

update

*Disk.

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

*Snapshot.

acs:ecs:{#regionId}:{#accountId}:snapshot/{#snapshotId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
DiskId	string	Yes	ID disk yang akan dikembalikan.	d-bp199lyny9b3****
SnapshotId	string	Yes	ID snapshot yang digunakan untuk mengembalikan disk.	s-bp199lyny9b3****
DryRun	boolean	No	Apakah akan menjalankan dry run. Nilai valid: true: menjalankan dry run tanpa benar-benar mengembalikan disk. Sistem memeriksa apakah parameter wajib telah ditentukan, apakah format permintaan valid, dan apakah batasan status Sumber daya terpenuhi. Jika pemeriksaan gagal, pesan kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan `DryRunOperation` akan dikembalikan. false: menjalankan dry run dan mengirimkan permintaan. Jika pemeriksaan berhasil, operasi pengembalian disk akan dimulai. Nilai default: false.	false

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	F3CD6886-D8D0-4FEE-B93E-1B732396****

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

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.	Tipe disk saat ini tidak mendukung operasi ini.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	Pemeriksaan DryRun berhasil. Permintaan Anda telah divalidasi.
400	InternalError	The requested services is not available now. Please try again later.	Terjadi error internal. Coba lagi.
500	InternalError	The request processing has failed due to some unknown error.
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	InstanceLockedForSecurity	The instance is locked due to security.	Instans tempat disk tersambung terkunci karena alasan keamanan.
403	InvalidParameter.Mismatch	The specified snapshot is not created from the specified disk.
403	InvalidSnapshot.TooOld	The snapshot was created before 2013-07-15 and cannot be restored since the disk was first detached.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	OperationDenied	The specified snapshot dees not support ResetDisk.
403	InvalidSnapshotId.NotReady	The specified snapshot has not completed yet.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	Layanan snapshot tidak diaktifkan. Operasi tidak dapat dilakukan.
403	Operation.Conflict	The operation may conflict with others. Please retry later.
403	UserNotInTheWhiteList	The user is not in disk white list.	Pengguna tidak berada dalam daftar putih Shared Block Storage. Ajukan tiket untuk mendaftar ke daftar putih.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK has not authorized the ECS service to perform the KMS TagResource and UntagResource operations. Please verify the authorization and try again.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
403	IncorrectDiskStatus.HasUnfinishedSnapshot	The current disk has unfinished snapshot.	Disk saat ini memiliki snapshot yang belum selesai.
403	InvalidOperation.DiskResetInProgress	The operation cannot be performed because the disk has an ongoing reset task. Please try again later.
404	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Disk yang ditentukan tidak ada. Periksa apakah ID disk sudah benar.
404	Disk.NotFound	The specified disk does not exist.	Disk yang ditentukan tidak ada. Periksa apakah disk sudah benar.
404	InvalidSnapshotId.NotFound	The specified SnapshotId does not exist.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Instans yang ditentukan tidak ada. Periksa apakah ID instans sudah benar.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.