All Products
Search
Document Center

Elastic Compute Service:ReInitDisk

Last Updated:Oct 09, 2026

Menginisialisasi ulang cloud disk ke kondisi awalnya saat pembuatan.

Deskripsi operasi

Saat memanggil operasi ini, perhatikan hal-hal berikut:

  • Disk harus berada dalam status In Use (In_use), dan Instans ECS tempat disk menyambungkan harus berada dalam status Stopped (Stopped).

  • Anda tidak dapat menginisialisasi ulang disk yang menyambungkan ke Instans sebelum Instans dimulai untuk pertama kalinya.

  • Anda tidak dapat menginisialisasi ulang disk yang memiliki snapshot lokal.

  • Untuk disk sistem, disk diinisialisasi ulang ke kondisi awal image. Jika image sumber tempat disk dibuat dihapus, disk tidak dapat diinisialisasi ulang.

  • Untuk disk data yang dibuat secara langsung, disk diinisialisasi ulang ke kondisi kosong. Untuk disk data yang dibuat dari snapshot, disk diinisialisasi ulang ke kondisi snapshot. Jika snapshot sumber dihapus, disk tidak dapat diinisialisasi ulang dan error akan dikembalikan.

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

update

*Disk.

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

  • ecs:PasswordCustomized
None

Parameter permintaan

Parameter

Type

Required

Description

Example

DiskId

string

Yes

ID disk yang akan diinisialisasi ulang. Instans tempat disk menyambungkan harus telah dimulai setidaknya satu kali dan harus berada dalam status Stopped.

d-bp67acfmxazb4ph****

Password

string

No

Apakah akan mengatur ulang kata sandi logon Instans ECS saat Anda menginisialisasi ulang cloud disk sistem. Kata sandi harus memiliki panjang 8 hingga 30 karakter dan harus mengandung setidaknya tiga dari jenis karakter berikut: huruf besar, huruf kecil, angka, dan karakter khusus. Karakter khusus dapat berupa:

()`~!@#$%^&*-_+=|{}[]:;'<>,.?/

Untuk Instans Windows, kata sandi tidak boleh diawali dengan garis miring (/).

Catatan

Jika Anda menentukan parameter Password, gunakan HTTPS untuk mengirim permintaan guna mencegah kebocoran kata sandi.

EcsV587!

KeyPairName

string

No

Nama pasangan kunci.

Catatan

Parameter ini hanya berlaku untuk Instans Linux. Saat Anda menginisialisasi ulang disk sistem, Anda dapat mengaitkan pasangan kunci SSH ke Instans ECS sebagai kredensial logon. Setelah pasangan kunci SSH digunakan, metode logon kata sandi akan dinonaktifkan.

testKeyPairName

AutoStartInstance

boolean

No

Apakah akan memulai instans secara otomatis setelah disk diinisialisasi ulang. Nilai valid:

  • true: Memulai instans secara otomatis.

  • false: Tidak memulai instans secara otomatis.

Nilai default: false.

true

SecurityEnhancementStrategy

string

No

Apakah akan menggunakan Pusat Keamanan secara gratis setelah disk sistem yang ditentukan diinisialisasi ulang. Nilai valid:

  • Active: Menggunakan Pusat Keamanan. Nilai ini hanya didukung untuk image publik.

  • Deactive: Tidak menggunakan Pusat Keamanan. Nilai ini didukung untuk semua image.

Nilai default: Deactive.

Active

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 LoginAsNonRoot.ImageNotSupport The specified image does not support login as non-root. Image ini tidak mendukung logon non-root.
400 DiskHasSnapshotsWithInstantAccessEnabled.OperationNotSupported The operation is not supported to the specified disk that have snapshots with InstantAccess enabled.
400 InvalidPassword.Malformed The specified parameter "Password" is not valid. Parameter Password yang ditentukan tidak valid.
400 InvalidKeyPairName.NotFound The specified KeyPairName does not exist. KeyPairName yang ditentukan tidak ada.
400 DependencyViolation.IoOptimize The specified parameter InstanceId is not valid. ID instans yang ditentukan tidak valid, atau konfigurasi optimasi I/O instans yang ditentukan tidak valid.
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.
500 InternalError The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
403 LoginAsNonRoot.RegionNotSupport The specified region does not support login as non-root.
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 menyambungkan terkunci karena alasan keamanan.
403 InvalidSnapshot.TooOld The disk was created from a snapshot taken before 2013-07-15 and can no longer be reinitialized.
403 OperationDenied The snapshot which is used to create the specified disk has been deleted.
403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403 DiskCreatingSnapshot The operation is denied due to a snapshot of the specified disk is not completed yet.
403 SharedImageDeleted The specified image by others shared is deleted.
403 DependencyViolation.WindowsInstance The instance runs Windows and does not support SSH key pair login.
403 InvalidDisk.DiskFromClonedNotSupport The specified disk %s was cloned from source disk %s. Reinitialization is not supported for cloned disks.
403 UserNotInTheWhiteList The user is not in volume white list.
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 HibernationConfigured.InstanceOperationForbidden The operation is not permitted due to limit of the hibernation configured instance. Operasi tidak diizinkan karena instans tidak memenuhi persyaratan untuk mengaktifkan opsi hibernasi.
403 InvalidOperation.MultiAttachDisk Multi attach disk does not support this operation. Disk dengan menyambungkan multi diaktifkan tidak mendukung operasi ini.
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 InvalidSourceSnapshot The source snapshot of the disk has been deleted and cannot support the current operation. Snapshot sumber dari disk yang ditentukan telah dihapus. Disk tidak dapat diinisialisasi ulang.
403 InvalidOperation.ReInitUnsupported The specified disk does not support reInit. Disk yang ditentukan tidak mendukung inisialisasi ulang.
404 InvalidDiskId.NotFound The specified disk does not exist. Disk yang ditentukan tidak ada. Periksa apakah ID disk sudah benar.
404 InvalidImageId.NotFound The specified ImageId does not exist. Image yang ditentukan tidak ada di bawah akun ini. Periksa apakah ID image benar.
404 InvalidDiskId.OperationNotSupported The operation is not supported due to image not exist. Image yang ditentukan tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.