ModifyDiskAttribute - - Alibaba Cloud Documentation Center

Memodifikasi atribut perangkat penyimpanan blok, termasuk nama, deskripsi, dan apakah perangkat tersebut akan dilepas bersama instans terkaitnya.

Catatan Penggunaan

Saat memanggil operasi ini untuk memodifikasi atribut disk, jika Anda mengatur DeleteWithInstance ke false dan instans tempat disk tersebut terpasang dikunci karena alasan keamanan, pengaturan DeleteWithInstance akan diabaikan dan disk tetap dilepas bersama instans tersebut. Jika respons kueri informasi instans menampilkan "LockReason" : "security", berarti instans tersebut dikunci karena alasan keamanan.
Anda dapat menggunakan parameter DiskIds.N untuk menentukan beberapa perangkat penyimpanan blok sekaligus, sehingga atributnya—termasuk nama, deskripsi, dan status pelepasan bersama instans—dapat dimodifikasi dalam satu permintaan.

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

Parameter Permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyDiskAttribute	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyDiskAttribute.
DiskId	String	No	d-bp1famypsnar20bv****	ID disk. Catatan `DiskId` dan `DiskIds.N` saling eksklusif. Tentukan salah satu parameter sesuai kebutuhan bisnis Anda.
DiskName	String	No	MyDiskName	Nama disk. Nama harus terdiri dari 2 hingga 128 karakter. Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan `http://` atau `https://`. Nama dapat berisi huruf, angka, titik dua (:), garis bawah (_), dan tanda hubung (-).
Description	String	No	TestDescription	Deskripsi disk. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai dengan `http://` atau `https://`.
DeleteWithInstance	Boolean	No	false	Menentukan apakah disk akan dilepas bersama dengan instans terkaitnya. Parameter ini kosong secara default, yang berarti nilai saat ini tetap tidak berubah. Kesalahan akan dikembalikan jika Anda mengatur `DeleteWithInstance` ke `false` dalam salah satu kondisi berikut: Disk tersebut adalah local disk. Disk tersebut adalah basic disk dan tidak dapat dilepas. Jika atribut Portable pada disk diatur ke false, maka disk tersebut tidak dapat dilepas.
DeleteAutoSnapshot	Boolean	No	false	Menentukan apakah snapshot otomatis disk akan dihapus saat disk dilepas. Parameter ini kosong secara default, yang berarti nilai saat ini tetap tidak berubah.
EnableAutoSnapshot	Boolean	No	true	Menentukan apakah fitur kebijakan snapshot otomatis diaktifkan untuk cloud disk. Nilai yang valid: true false Parameter ini kosong secara default, yang berarti nilai saat ini tetap tidak berubah. Catatan Secara default, fitur kebijakan snapshot otomatis diaktifkan untuk cloud disk. Anda hanya perlu mengasosiasikan kebijakan snapshot otomatis dengan cloud disk sebelum dapat menggunakannya.
RegionId	String	Yes	cn-hangzhou	ID Wilayah disk. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.
DiskIds.N	String	No	d-bp1famypsnar20bv****	ID disk ke-N. Nilai N yang valid: 0 hingga 100. Catatan `DiskId` dan `DiskIds.N` saling eksklusif. Tentukan salah satu parameter sesuai kebutuhan bisnis Anda.
BurstingEnabled	Boolean	No	false	Menentukan apakah fitur lonjakan performa diaktifkan. Nilai yang valid: true false

Parameter Respons

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

Contoh

Contoh permintaan

https://ecs.aliyuncs.com/?Action=ModifyDiskAttribute
&RegionId=cn-hangzhou
&DiskId=d-bp1famypsnar20bv****
&DiskName=MyDiskName
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

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

Kode Kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidDiskName.Malformed	The specified disk name is wrongly formed.	Format DiskName tidak valid. Nama harus terdiri dari 2 hingga 128 karakter dan dapat berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-). Nama harus dimulai dengan huruf dan tidak boleh dimulai dengan http:// atau https://.
400	NoAttributeToModify	No attribute to be modified in this request.	Tidak ada atribut perangkat penyimpanan blok yang dimodifikasi.
400	IncompleteParamter	Some fields can not be null in this request.	Beberapa parameter yang diperlukan belum ditentukan.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.	Nilai RegionId tidak valid.
400	BurstingEnabledForDiskCategoryUnsupported	The specified disk category does not support bursting enabled.	Kategori disk tidak mendukung fitur lonjakan performa.
400	BurstingEnabledForMultiAttachDiskUnsupported	The multi attach disk does not support bursting enabled.	Disk yang telah mengaktifkan fitur multi-attach tidak mendukung fitur lonjakan performa.
400	BurstingEnabledForModifyingDiskUnsupported	The modifying disk does not support bursting enabled.	Anda tidak dapat memodifikasi fitur lonjakan performa untuk disk yang konfigurasinya sedang diubah.
403	QuotaExceed.Snapshot	The snapshot quota exceeds.	Jumlah maksimum snapshot telah tercapai. Untuk menyimpan snapshot baru, hapus snapshot yang tidak lagi Anda perlukan.
403	DiskNotPortable	The specified disk is not a portable disk.	Disk yang ditentukan tidak dapat dilepas.
403	IncorrectDiskStatus	The operation is not supported in this status.	Operasi ini tidak dapat dilakukan pada disk dalam status saat ini. Pastikan disk tersedia dan Anda tidak memiliki pembayaran tertunda untuk disk tersebut.
403	UserNotInTheWhiteList	The user is not in disk white list.	Anda tidak memiliki otorisasi untuk mengelola disk tersebut. Coba lagi setelah Anda diberi otorisasi.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	Disk yang telah mengaktifkan fitur multi-attach tidak mendukung atribut DeleteWithInstance.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Disk ini tidak ditemukan. Periksa apakah ID disk valid.
404	InvalidDescription.Malformed	The specified description is wrongly formed.	Format Description tidak valid. Deskripsi harus terdiri dari 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.
404	InvalidInstanceId.NotFound	Specified attached instance does not exist.	Instans yang ditentukan tidak ditemukan. Periksa apakah ID instans benar.

Untuk daftar lengkap kode kesalahan, lihat Kode kesalahan layanan.