Memodifikasi nama, deskripsi, apakah akan dilepaskan bersama instance, apakah akan menghapus snapshot otomatisnya saat disk dihapus, apakah akan mengaktifkan kebijakan snapshot otomatis, dan apakah akan mengaktifkan fitur performance burst dari perangkat block storage.
Deskripsi operasi
Anda dapat memanggil parameter DiskId untuk memodifikasi nama, deskripsi, apakah akan dilepaskan bersama instance, 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 memperolehnya. |
cn-hangzhou |
| DiskId |
string |
Yes |
ID disk yang atributnya akan dimodifikasi. |
rcd-wz9c8isqly8637zw**** |
| DiskName |
string |
No |
Nama disk. Nama harus terdiri dari 2 hingga 128 karakter dan mendukung karakter dalam kategori letter Unicode (termasuk huruf Inggris, karakter Tionghoa, dan angka, dsb.). Dapat berisi titik dua (:), garis bawah (_), titik (.), atau tanda hubung (-). |
testDisk |
| Description |
string |
No |
Deskripsi disk. Deskripsi harus terdiri dari 2 hingga 256 karakter, dalam bahasa Inggris atau Tionghoa, dan tidak boleh diawali dengan http:// atau https://. |
test |
| DeleteWithInstance |
boolean |
No |
Menentukan apakah disk dilepaskan bersamaan dengan instance. Nilai default: none. None menunjukkan bahwa nilai saat ini tidak berubah. Parameter ini tidak dapat diatur untuk cloud disk dengan fitur multi-attach diaktifkan. Pada dua skenario berikut, mengatur parameter DeleteWithInstance menjadi false akan menyebabkan error. Ketika kategori disk adalah local disk (ephemeral). Ketika kategori disk adalah basic cloud disk (cloud) dan tidak dapat dilepas (Portable=false). Peringatan Jika Anda mengatur disk untuk tidak dilepaskan bersama instance (DeleteWithInstance=false), setelah instance ECS yang melampirkan disk tersebut terkunci secara keamanan dan OperationLocks berisi status kunci yang ditandai dengan "LockReason" : "security", disk akan tetap dilepaskan bersama instance, mengabaikan atribut DeleteWithInstance. |
false |
| BurstingEnabled |
boolean |
No |
Menentukan apakah akan mengaktifkan fitur Burst (performance burst) untuk disk yang mendukungnya. Nilai yang valid: true: Ya. false: Tidak. Catatan Untuk disk yang tidak mendukung fitur Burst, memasukkan nilai apa pun akan menyebabkan 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.