Mengubah nama, deskripsi, apakah akan dilepaskan bersama instans, apakah akan menghapus snapshot otomatis saat disk dihapus, apakah akan mengaktifkan kebijakan snapshot otomatis, apakah akan mengaktifkan fitur performance burst, dan atribut lainnya dari perangkat block storage.
Deskripsi operasi
Anda dapat menggunakan parameter DiskId untuk mengubah nama, deskripsi, apakah akan dilepaskan bersama instans, dan atribut lainnya dari perangkat block storage.
Coba sekarang
Test
RAM authorization
Sintaks permintaan
POST HTTP/1.1Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
ID region. Anda dapat memanggil DescribeRegions untuk menanyakan daftar region terbaru. |
cn-hangzhou |
| DiskId |
string |
Yes |
ID disk yang atributnya ingin Anda ubah. |
rcd-wz9c8isqly8637zw**** |
| DiskName |
string |
No |
Nama disk. Nama harus memiliki panjang 2 hingga 128 karakter dan mendukung karakter yang diklasifikasikan sebagai huruf dalam Unicode (termasuk huruf Inggris, karakter Tionghoa, dan angka). Nama dapat berisi titik dua (:), garis bawah (_), titik (.), dan tanda hubung (-). |
testDisk |
| Description |
string |
No |
Deskripsi disk. Deskripsi harus memiliki panjang 2 hingga 256 karakter dalam bahasa Inggris atau Tionghoa, dan tidak boleh diawali dengan http:// atau https://. |
test |
| DeleteWithInstance |
boolean |
No |
Menentukan apakah akan melepaskan disk bersama dengan instans terkait. Nilai default: none. None menunjukkan bahwa nilai saat ini tidak diubah. Parameter ini tidak dapat diatur untuk cloud disk yang memiliki fitur multi-attach diaktifkan. Dalam dua kasus berikut, error akan dikembalikan ketika Anda mengatur parameter DeleteWithInstance ke false: Ketika kategori disk adalah local disk (ephemeral). Ketika kategori disk adalah basic disk (cloud) dan disk tidak dapat dilepas (Portable=false). Peringatan Jika Anda mengatur DeleteWithInstance=false, setelah instans ECS yang dilampirkan disk dikunci karena alasan keamanan dan OperationLocks berisi status kunci yang ditandai dengan "LockReason" : "security", atribut DeleteWithInstance pada disk akan diabaikan dan disk dilepaskan bersama dengan instans. |
false |
| BurstingEnabled |
boolean |
No |
Menentukan apakah akan mengaktifkan fitur Burst (performance burst) untuk disk yang mendukung fitur ini. Nilai yang valid: true: ya. false: tidak. Catatan Untuk disk yang tidak mendukung fitur Burst, memberikan nilai apa pun akan mengembalikan error. |
false |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Skema Respons |
||
| RequestId |
string |
Id permintaan |
1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC |
Contoh
Respons sukses
JSONformat
{
"RequestId": "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC"
}Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidRegionId.MalFormed | The specified parameter RegionId is not valid. | |
| 400 | InvalidDiskName.Malformed | The specified disk name is wrongly formed. | |
| 400 | NoAttributeToModify | No attribute to be modified in this request. | |
| 400 | IncompleteParamter | Some fields can not be null in this request. | |
| 400 | MissingParameter.DiskIdOrDiskIds | Specified parameter DiskId or DiskIds is missing. | |
| 400 | BurstingEnabledForDiskCategoryUnsupported | The specified disk category does not support bursting enabled. | |
| 400 | BurstingEnabledForMultiAttachDiskUnsupported | The multi attach disk does not support bursting enabled. | |
| 400 | BurstingEnabledForModifyingDiskUnsupported | The modifying disk does not support bursting enabled. | |
| 400 | InvalidBurstingEnabled.DiskSizeTooSmall | The disk size must be greater than 3 GiB to enable burst. | |
| 403 | QuotaExceed.Snapshot | The snapshot quota exceeds. | |
| 403 | DiskNotPortable | The specified disk is not a portable disk. | |
| 403 | IncorrectDiskStatus | The operation is not supported in this status. | |
| 403 | UserNotInTheWhiteList | The user is not in disk white list. | |
| 403 | DeleteWithInstance.Conflict | Multi attach disk cannot be set to DeleteWithInstance attribute. | |
| 404 | InvalidDiskId.NotFound | The specified disk does not exist. | |
| 404 | InvalidDescription.Malformed | The specified description is wrongly formed. | |
| 404 | InvalidInstanceId.NotFound | Specified attached instance does not exist. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.