DetachDisk - Elastic Compute Service - Alibaba Cloud Documentation Center

Melepas disk data atau disk sistem pay-as-you-go dari Instance ECS.

Deskripsi operasi

Perhatikan hal-hal berikut saat memanggil operasi ini:

Operasi ini bersifat asinkron. Setelah pemanggilan operasi berhasil, diperlukan waktu sekitar satu menit hingga pelepasan selesai.
Saat instans yang menyambungkan berada di bawah kontrol keamanan, status kunci "LockReason" : "security" tidak dapat ditandai di OperationLocks.
Setelah disk ephemeral elastis dilepas, disk tersebut hanya dapat menyambungkan kembali ke instans aslinya.

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

update

*Disk

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

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID Instance ECS tempat disk yang akan dilepas menyambungkan.	i-bp67acfmxazb4p****
DiskId	string	Yes	ID disk yang akan dilepas. Disk harus menyambungkan ke instans dan berada dalam status Sedang Digunakan (`In_use`). Saat Anda melepas disk data, instans tempat disk menyambungkan harus berada dalam status Berjalan (`Running`) atau Berhenti (`Stopped`). Saat Anda melepas disk sistem, instans tempat disk menyambungkan harus berada dalam status Berhenti (`Stopped`).	d-bp67acfmxazb4p****
DeleteWithInstance	boolean	No	Menentukan atribut rilis otomatis saat Anda melepas disk sistem atau disk data. Atribut ini menunjukkan apakah akan merilis disk sistem atau disk data bersama dengan Instance ECS terkait saat Instance ECS dirilis. true: Merilis disk. false: Tidak merilis disk. Disk dikonversi menjadi disk data pay-as-you-go dan dipertahankan. Nilai default: true Perhatikan hal-hal berikut: Parameter ini tidak dapat diatur untuk disk yang memiliki fitur multi-attach diaktifkan. Jika disk yang akan dilepas adalah disk data, nilai defaultnya adalah `false`. Jika disk target yang akan dilepas adalah `disk ephemeral elastis`, parameter `DeleteWithInstance` harus diatur ke `true`.	false

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
400	InvalidParameter	The input parameter is mandatory for processing this request is empty.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.
400	InvalidOperation.InstanceTypeNotSupport	The instance type of the specified instance does not support hot detach disk.
400	DisksDetachingOnEcsExceeded	The number of disks detaching on the instance exceeds the limit.
400	InvalidInstanceId.Malformed	The specified parameter InstanceId is not valid.
500	InternalError	The request processing has failed due to some unknown error.
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	DiskNotPortable	The specified disk is not a portable disk.
403	InstanceLockedForSecurity	The instance is locked due to security.
403	DependencyViolation	The specified disk has not been attached on the specified instance.
403	DiskTypeViolation	The specified disk is a system disk and cannot support the operation.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	UserNotInTheWhiteList	The user is not in disk white list.
403	InvalidInstance.ImageCategory	The image category of the specified instance does not support detaching system disk.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.
403	InvalidOperation.DiskCategoryUnsupported	The DetachDisk operation is not supported for elastic ephemeral disk.
403	InvalidParameter.DeleteWithInstance	The DeleteWithInstance for the elastic ephemeral disk must be set to true.
403	InvalidOperation.DiskDetachingFromThisEcs	The specified disk is detaching from this ecs.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.
404	InvalidDiskId.NotFound	The specified disk does not exist.
404	InvalidDisk.AlreadyDetached	The specified disk has been detached.
404	InvalidDiskId.OperationNotSupported	The operation is not supported due to base image not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.