DetachDisk - - Alibaba Cloud Documentation Center

Melepas disk data pay-as-you-go atau disk sistem dari instans Elastic Compute Service (ECS).

Description

Saat memanggil operasi ini, perhatikan batasan berikut:

Disk harus telah disambungkan ke instans ECS dan berada dalam status In Use (In_Use).
Instans tempat Anda melepas disk data harus berada dalam status Running (Running) atau Stopped (Stopped).
Instans tempat Anda melepas disk sistem harus berada dalam status Stopped (Stopped).
Jika OperationLocks dalam respons berisi "LockReason" : "security" saat Anda mengkueri informasi instans, instans tersebut dikunci karena alasan keamanan dan tidak dapat menjalankan operasi apa pun.
DetachDisk adalah operasi asinkron. Diperlukan waktu sekitar 1 menit agar disk dilepas dari instans setelah operasi dipanggil.

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

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	DetachDisk	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DetachDisk.
DiskId	String	Yes	d-bp67acfmxazb4p****	ID disk yang akan dilepas.
InstanceId	String	Yes	i-bp67acfmxazb4p****	ID instans ECS tempat disk akan dilepas.
DeleteWithInstance	Boolean	No	false	Menentukan apakah sistem disk akan secara otomatis direlease saat instans tempat sistem disk tersebut dilepas juga direlease. Nilai yang valid: true: Sistem disk direlease saat instans direlease. false: Sistem disk tidak direlease saat instans direlease. Sistem disk tetap tersimpan sebagai data disk pay-as-you-go. Nilai default: true. Perhatikan hal-hal berikut: Parameter ini tidak dapat diatur untuk disk yang telah mengaktifkan fitur multi-attach. Jika data disk yang akan dilepas, nilai default-nya adalah `false`.

Response parameters

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.

Examples

Contoh permintaan

https://ecs.aliyuncs.com/?Action=DetachDisk
&DiskId=d-bp67acfmxazb4p****
&InstanceId=i-bp67acfmxazb4p****
&<Common request parameters>

Contoh respons sukses

XML format

<DetachDiskResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DetachDiskResponse>

JSON format

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

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParameter	The input parameter is mandatory for processing this request is empty.	Pesan kesalahan yang dikembalikan karena parameter yang diperlukan tidak diatur.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid	Pesan kesalahan yang dikembalikan karena parameter RegionId yang ditentukan tidak valid.
400	InvalidOperation.InstanceTypeNotSupport	The instance type of the specified instance does not support hot detach disk.	Pesan kesalahan yang dikembalikan karena instans tempat disk disambungkan tidak mendukung hot swap disk.
403	IncorrectDiskStatus	The current disk status does not support this operation.	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat disk berada dalam status saat ini. Pastikan disk dapat digunakan dan Anda tidak memiliki pembayaran tertunda untuk disk tersebut.
403	DiskNotPortable	The specified disk is not a portable disk.	Pesan kesalahan yang dikembalikan karena disk yang ditentukan tidak dapat dilepas.
403	InstanceLockedForSecurity	The instance is locked due to security.	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat instans dikunci karena alasan keamanan.
403	DependencyViolation	The specified disk has not been attached on the specified instance.	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat resource memiliki dependensi lain. Misalnya, disk yang ditentukan belum disambungkan ke instans yang ditentukan, atau security group yang ditentukan tidak dapat dihapus selama masih berisi instans. Hapus dependensinya dan coba lagi.
403	DiskTypeViolation	The specified disk is a system disk and cannot support the operation.	Pesan kesalahan yang dikembalikan karena disk yang ditentukan adalah sistem disk dan tidak dapat dilepas dari instans tempat disk tersebut disambungkan.
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	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	InvalidInstance.ImageCategory	The image category of the specified instance does not support detaching system disk.	Pesan kesalahan yang dikembalikan karena sistem disk yang ditentukan tidak dapat dilepas dari instans yang ditentukan saat image instans berada dalam status saat ini. Kemungkinan penyebab: Image yang digunakan untuk membuat instans telah dihapus.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	Pesan kesalahan yang dikembalikan karena atribut DeleteWithInstance tidak valid untuk disk yang telah mengaktifkan fitur multi-attach.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Pesan kesalahan yang dikembalikan karena parameter InstanceId yang ditentukan tidak valid.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Pesan kesalahan yang dikembalikan karena disk yang ditentukan tidak ada. Periksa apakah ID disk sudah benar.
404	InvalidDisk.AlreadyDetached	The specified disk has been detached.	Pesan kesalahan yang dikembalikan karena disk yang ditentukan telah dilepas dari instans.
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.

For a list of error codes, visit the API Error Center.