Menampilkan informasi perangkat penyimpanan blok yang telah Anda buat, termasuk cloud disk dan local disk.
Catatan penggunaan
Anda dapat mengonfigurasi beberapa parameter permintaan—seperti
RegionId,ZoneId,DiskIds, danInstanceId—sebagai filter. Parameter yang dikonfigurasi dievaluasi menggunakan operator "AND". Jika Anda menentukan lebih dari satu filter, hanya catatan yang memenuhi semua filter tersebut yang akan dikembalikan.Nilai parameter
DiskIdsberupa array JSON. Jika parameter ini tidak dikonfigurasi, maka tidak digunakan sebagai filter. Namun, jika diatur ke array JSON kosong, parameter tersebut dianggap sebagai filter yang valid dan respons kosong akan dikembalikan.Anda dapat menggunakan salah satu metode berikut untuk memeriksa tanggapan:
Metode 1: Gunakan
NextTokenuntuk menentukan token kueri. Atur nilainya keNextTokenyang dikembalikan dalam pemanggilan sebelumnya ke operasi DescribeDisks, lalu gunakanMaxResultsuntuk menentukan jumlah maksimum entri yang dikembalikan per halaman.Metode 2: Konfigurasikan parameter
PageSizeuntuk menentukan jumlah entri per halaman danPageNumberuntuk menentukan nomor halaman yang dikembalikan.Anda hanya dapat menggunakan salah satu metode di atas. Untuk jumlah entri yang besar, kami menyarankan Metode 1. Jika parameter
NextTokendikonfigurasi, parameterPageSizedanPageNumbertidak berlaku, dan nilaiTotalCountdalam respons tidak valid.
Cloud disk yang memiliki fitur multi-attach diaktifkan dapat disambungkan ke beberapa instans. Informasi penyambungan cloud disk tersebut dapat dilihat berdasarkan nilai
Attachmentdalam respons.
Saat memanggil operasi API menggunakan Alibaba Cloud CLI, pastikan Anda menentukan nilai parameter permintaan sesuai dengan format tipe data yang diperlukan. Untuk informasi selengkapnya, lihat Ikhtisar format parameter.
Debugging
Parameter permintaan
Parameter | Tipe | Diperlukan | Contoh | Deskripsi |
Action | String | Ya | DescribeDisks | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeDisks. |
RegionId | String | Ya | cn-hangzhou | ID wilayah perangkat penyimpanan blok. Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar wilayah terbaru. |
ZoneId | String | Tidak | cn-hangzhou-g | ID zona. |
DiskIds | String | Tidak | ["d-bp67acfmxazb4p****", "d-bp67acfmxazb4g****", … "d-bp67acfmxazb4d****"] | ID disk. Nilainya adalah array JSON yang terdiri dari maksimal 100 ID disk. Pisahkan ID disk dengan koma (,). |
InstanceId | String | Tidak | i-bp67acfmxazb4q**** | ID instans tempat disk disambungkan. |
DiskType | String | Tidak | all | Tipe disk. Nilai yang valid:
Nilai default: all. |
Category | String | Tidak | all | Kategori disk. Nilai yang valid:
Nilai default: all. |
Status | String | Tidak | All | Status cloud disk. Untuk informasi selengkapnya, lihat Status disk. Nilai yang valid:
Nilai default: All. |
SnapshotId | String | Tidak | s-bp67acfmxazb4p**** | ID snapshot yang digunakan untuk membuat cloud disk. |
Portable | Boolean | Tidak | false | Menentukan apakah disk dapat dilepas. Nilai yang valid:
Atribut
|
DeleteWithInstance | Boolean | Tidak | false | Menentukan apakah cloud disk akan dilepas saat instans terkaitnya dilepas. Nilai yang valid:
Nilai default: false. |
DeleteAutoSnapshot | Boolean | Tidak | false | Menentukan apakah snapshot otomatis cloud disk akan dihapus saat cloud disk dilepas.
Nilai default: false. |
PageNumber | Integer | Tidak | 1 | Nomor halaman. Halaman dimulai dari halaman 1. Nilai default: 1. |
PageSize | Integer | Tidak | 10 | Jumlah entri per halaman. Nilai maksimum: 100. Nilai default: 10. |
NextToken | String | Tidak | AAAAAdDWBF2**** | Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Anda harus menentukan token yang diperoleh dari kueri sebelumnya sebagai nilai Untuk informasi tentang cara memeriksa respons yang dikembalikan oleh operasi ini, lihat bagian "Catatan penggunaan" dalam topik ini. |
MaxResults | Integer | Tidak | 50 | Jumlah entri per halaman. Nilai yang valid: 10 hingga 500. Perhatikan hal-hal berikut:
|
DiskName | String | Tidak | testDiskName | Nama disk. |
AutoSnapshotPolicyId | String | Tidak | sp-m5e2w2jutw8bv31**** | ID kebijakan snapshot otomatis yang diterapkan pada cloud disk. |
EnableAutoSnapshot | Boolean | Tidak | true | Menentukan apakah fitur kebijakan snapshot otomatis diaktifkan untuk cloud disk. Nilai yang valid:
Catatan Secara default, fitur kebijakan snapshot otomatis diaktifkan untuk cloud disk yang dibuat. Anda hanya perlu menerapkan kebijakan snapshot otomatis pada cloud disk sebelum dapat menggunakannya. |
EnableAutomatedSnapshotPolicy | Boolean | Tidak | false | Menentukan apakah kebijakan snapshot otomatis diterapkan pada cloud disk. Nilai yang valid:
Nilai default: false. |
DiskChargeType | String | Tidak | PostPaid | Metode penagihan disk. Nilai yang valid:
|
LockReason | String | Tidak | recycling | Alasan mengapa disk dikunci. Nilai yang valid:
|
Filter.1.Key | String | Tidak | CreationStartTime | Kunci filter 1 yang digunakan untuk menanyakan resource. Tetapkan nilainya ke |
Filter.2.Key | String | Tidak | CreationEndTime | Kunci filter 2 yang digunakan untuk menanyakan resource. Tetapkan nilainya ke |
Filter.1.Value | String | Tidak | 2017-12-05T22:40Z | Nilai filter 1 yang digunakan untuk menanyakan resource. Jika Anda mengonfigurasi parameter ini, Anda juga harus mengonfigurasi parameter |
Filter.2.Value | String | Tidak | 2017-12-06T22:40Z | Nilai filter 2 yang digunakan untuk menanyakan resource. Jika Anda mengonfigurasi parameter ini, Anda juga harus mengonfigurasi parameter |
ResourceGroupId | String | Tidak | rg-bp67acfmxazb4p**** | ID kelompok sumber daya tempat disk berada. Jika Anda menggunakan parameter ini untuk memfilter resource, jumlah resource dalam kelompok sumber daya yang ditentukan tidak boleh melebihi 1.000. Catatan Resource dalam kelompok sumber daya default tidak dapat difilter. |
EnableShared | Boolean | Tidak | false | Menentukan apakah disk merupakan perangkat Shared Block Storage. |
Encrypted | Boolean | Tidak | false | Menentukan apakah hanya cloud disk terenkripsi yang akan ditanyakan. Nilai yang valid:
Nilai default: false. |
DryRun | Boolean | Tidak | false | Menentukan apakah hanya menjalankan dry run tanpa melakukan permintaan aktual. Nilai yang valid:
Nilai default: false. |
KMSKeyId | String | Tidak | 0e478b7a-4262-4802-b8cb-00d3fb40**** | ID kunci Key Management Service (KMS) yang digunakan oleh cloud disk. |
MultiAttach | String | Tidak | Disabled | Menentukan apakah fitur multi-attach diaktifkan. Nilai yang valid:
Fitur multi-attach sedang dalam pratinjau undangan. Untuk menggunakannya, kirim tiket. |
Tag.N.key | String | Tidak | null | Kunci tag N dari disk. Catatan Kami menyarankan Anda menggunakan parameter Tag.N.Key lainnya untuk memastikan kompatibilitas. |
Tag.N.Key | String | Tidak | TestKey | Kunci tag N dari disk. Nilai N yang valid: 1 hingga 20. Jika satu tag ditentukan untuk menanyakan resource, hingga 1.000 resource yang memiliki tag ini akan dikembalikan. Jika beberapa tag ditentukan untuk menanyakan resource, hingga 1.000 resource yang memiliki semua tag ini akan dikembalikan. Untuk menanyakan lebih dari 1.000 resource dengan tag yang ditentukan, panggil operasi ListTagResources. |
Tag.N.Value | String | Tidak | TestValue | Nilai tag N dari disk. Nilai N yang valid: 1 hingga 20. |
Tag.N.value | String | Tidak | null | Nilai tag N dari disk. Catatan Kami menyarankan Anda menggunakan parameter Tag.N.Value lainnya untuk memastikan kompatibilitas. |
AdditionalAttributes.N | String | Tidak | IOPS | Nilai atribut N. Tetapkan nilainya ke IOPS, yang menunjukkan jumlah maksimum operasi input/output per detik (IOPS) dari disk. |
Parameter respons
Parameter | Tipe | Contoh | Deskripsi |
NextToken | String | AAAAAdDWBF2**** | Token kueri yang dikembalikan dalam pemanggilan ini. |
PageSize | Integer | 1 | Jumlah entri per halaman. |
PageNumber | Integer | 1 | Nomor halaman. |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E | ID permintaan. |
TotalCount | Integer | 15 | Jumlah total entri yang dikembalikan. |
Disks | Array of Disk | Detail tentang disk. | |
Disk | |||
SerialNumber | String | bp18um4r4f2fve2**** | Nomor seri disk. |
CreationTime | String | 2021-06-07T06:08:54Z | Waktu saat disk dibuat. |
Status | String | In_use | Status cloud disk. Nilai yang valid:
|
Type | String | system | Tipe disk. Nilai yang valid:
|
PerformanceLevel | String | PL0 | Tingkat kinerja ESSD. Nilai yang valid:
|
BdfId | String | null | Parameter ini sedang dalam pratinjau undangan dan tidak tersedia untuk umum. |
EnableAutoSnapshot | Boolean | false | Menunjukkan apakah fitur kebijakan snapshot otomatis diaktifkan untuk cloud disk. |
StorageSetId | String | ss-i-bp1j4i2jdf3owlhe**** | ID storage set. |
StorageSetPartitionNumber | Integer | 11 | Jumlah maksimum partisi dalam storage set. |
DiskId | String | d-bp18um4r4f2fve24**** | ID disk. |
DeleteAutoSnapshot | Boolean | false | Menunjukkan apakah snapshot otomatis cloud disk dihapus saat cloud disk dilepas. Nilai yang valid:
Snapshot yang dibuat di Konsol ECS atau dengan memanggil operasi CreateSnapshot dipertahankan dan tidak terpengaruh oleh parameter ini. |
StorageClusterId | String | dbsc-j5e1sf2vaf5he8m2**** | ID kluster penyimpanan blok khusus tempat cloud disk berada. Jika cloud disk Anda berada di kluster penyimpanan blok publik, nilai kosong akan dikembalikan. |
Encrypted | Boolean | false | Menunjukkan apakah cloud disk dienkripsi. |
IOPSRead | Integer | 2000 | Jumlah maksimum operasi baca I/O per detik. |
MountInstanceNum | Integer | 1 | Jumlah instans tempat perangkat Shared Block Storage disambungkan. |
Description | String | testDescription | Deskripsi disk. |
Device | String | /dev/xvdb | Nama perangkat disk pada instans terkaitnya. Contoh: /dev/xvdb. Perhatikan hal-hal berikut:
Catatan Parameter ini akan ditinggalkan. Kami menyarankan Anda menggunakan parameter lain untuk memastikan kompatibilitas. |
DiskName | String | testDiskName | Nama disk. |
Portable | Boolean | false | Menunjukkan apakah disk dapat dilepas. |
ImageId | String | m-bp13aqm171qynt3u*** | ID image yang digunakan untuk membuat instans. Parameter ini kosong kecuali cloud disk dibuat dari image. Nilai parameter ini tetap tidak berubah sepanjang siklus hidup cloud disk. |
KMSKeyId | String | 0e478b7a-4262-4802-b8cb-00d3fb408*** | ID kunci KMS yang digunakan oleh cloud disk. |
DeleteWithInstance | Boolean | true | Menunjukkan apakah cloud disk dilepas saat instans terkaitnya dilepas. Nilai yang valid:
|
DetachedTime | String | 2021-06-07T21:01:22Z | Waktu saat cloud disk terakhir dilepas. |
SourceSnapshotId | String | s-bp67acfmxazb4p**** | ID snapshot yang digunakan untuk membuat cloud disk. Parameter ini dibiarkan kosong kecuali cloud disk dibuat dari snapshot. Nilai parameter ini tetap tidak berubah sepanjang siklus hidup cloud disk. |
AutoSnapshotPolicyId | String | sp-bp67acfmxazb4p**** | ID kebijakan snapshot otomatis yang diterapkan pada cloud disk. |
EnableAutomatedSnapshotPolicy | Boolean | false | Menunjukkan apakah kebijakan snapshot otomatis diterapkan pada cloud disk. |
IOPSWrite | Integer | 2000 | Jumlah maksimum operasi tulis per detik. |
InstanceId | String | i-bp67acfmxazb4q**** | ID instans tempat disk disambungkan. Perhatikan hal-hal berikut:
|
IOPS | Integer | 4000 | Jumlah maksimum IOPS. |
RegionId | String | cn-hangzhou | ID wilayah disk. |
ExpiredTime | String | 2021-07-07T16:00Z | Waktu saat cloud disk subscription berakhir. |
Size | Integer | 60 | Ukuran disk. Satuan: GiB. |
ResourceGroupId | String | rg-bp67acfmxazb4p**** | ID kelompok sumber daya tempat disk berada. |
DiskChargeType | String | PrePaid | Metode penagihan disk. Nilai yang valid:
|
ZoneId | String | cn-hangzhou-i | ID zona disk. |
AttachedTime | String | 2021-06-07T06:08:56Z | Waktu saat cloud disk terakhir disambungkan. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddThh:mmZ. Waktu ditampilkan dalam UTC. |
Category | String | cloud_ssd | Kategori disk. Nilai yang valid:
|
ProductCode | String | jxsc000204 | Kode produk di Alibaba Cloud Marketplace. |
MultiAttach | String | Disabled | Menunjukkan apakah fitur multi-attach diaktifkan untuk cloud disk. |
OperationLocks | Array of OperationLock | Alasan mengapa disk dikunci. | |
OperationLock | |||
LockReason | String | security | Alasan keamanan mengapa disk dikunci. |
MountInstances | Array of MountInstance | Informasi penyambungan perangkat Shared Block Storage. | |
MountInstance | |||
AttachedTime | String | 2017-12-05T2340:00Z | Waktu penyambungan. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC. |
InstanceId | String | i-bp1j4i2jdf3owlhe**** | ID instans tempat disk disambungkan. |
Device | String | /dev/xvda | Titik pemasangan disk. |
Tags | Array of Tag | Tag disk. | |
Tag | |||
TagValue | String | TestValue | Nilai tag disk. |
TagKey | String | TestKey | Kunci tag disk. |
Attachments | Array of Attachment | Informasi penyambungan tentang cloud disk. Nilainya adalah array yang terdiri dari nilai | |
Attachment | |||
InstanceId | String | i-bp67acfmxazb4q**** | ID instans tempat disk disambungkan. |
Device | String | /dev/xvda | Nama perangkat disk. |
AttachedTime | String | 2021-06-07T06:08:56Z | Waktu penyambungan. Waktu ditampilkan dalam UTC. |
ProvisionedIops | Long | 40000 | IOPS baca/tulis yang disediakan untuk ESSD AutoPL disk. Nilai yang valid: 0 hingga min{50.000, 1.000 × Kapasitas - IOPS Baseline}. Kinerja baseline = min{1.800 + 50 × Kapasitas, 50.000} Parameter ini hanya didukung jika parameter |
BurstingEnabled | Boolean | false | Menunjukkan apakah fitur lonjakan performa diaktifkan. Nilai yang valid:
Parameter ini hanya didukung jika parameter |
Throughput | Integer | 100 | Jumlah data yang ditransfer per detik. Satuan: MB/s. |
ThroughputRead | Integer | 100 | Jumlah data yang dibaca oleh sistem per detik. Satuan: MB/s. |
ThroughputWrite | Integer | 100 | Jumlah data yang ditulis oleh sistem per detik. Satuan: MB/s. |
Contoh
Permintaan contoh
https://ecs.aliyuncs.com/?Action=DescribeDisks
&RegionId=cn-hangzhou
&PageNumber=1
&PageSize=1
&<Common request parameters>Respons sukses contoh
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeDisksResponse>
<TotalCount>15</TotalCount>
<NextToken>AAAAAdDWBF2****</NextToken>
<PageSize>1</PageSize>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<PageNumber>1</PageNumber>
<Disks>
<Disk>
<DetachedTime/>
<Category>cloud_ssd</Category>
<Description>testDescription</Description>
<KMSKeyId/>
<ResourceGroupId/>
<DedicatedBlockStorageClusterId/>
<Encrypted>false</Encrypted>
<Size>40</Size>
<DeleteAutoSnapshot>false</DeleteAutoSnapshot>
<DiskChargeType>PrePaid</DiskChargeType>
<MultiAttach>Disabled</MultiAttach>
<Attachments>
<Attachment>
<AttachedTime>2021-06-07T06:08:56Z</AttachedTime>
<InstanceId>i-bp67acfmxazb4q****</InstanceId>
<Device>/dev/xvda</Device>
</Attachment>
</Attachments>
<ExpiredTime>2021-07-07T16:00Z</ExpiredTime>
<ImageId>m-bp13aqm171qynt3u***</ImageId>
<StorageSetId/>
<Tags>
</Tags>
<Status>In_use</Status>
<AttachedTime>2021-06-07T06:08:56Z</AttachedTime>
<StorageClusterId>dbsc-j5e1sf2vaf5he8m2****</StorageClusterId>
<ZoneId>cn-hangzhou-i</ZoneId>
<InstanceId>i-bp67acfmxazb4q****</InstanceId>
<SourceSnapshotId/>
<ProductCode/>
<PerformanceLevel>PL0</PerformanceLevel>
<Device>/dev/xvdb</Device>
<DeleteWithInstance>true</DeleteWithInstance>
<EnableAutomatedSnapshotPolicy>false</EnableAutomatedSnapshotPolicy>
<EnableAutoSnapshot>false</EnableAutoSnapshot>
<AutoSnapshotPolicyId>sp-bp67acfmxazb4p****</AutoSnapshotPolicyId>
<DiskName>testDiskName</DiskName>
<OperationLocks>
</OperationLocks>
<BdfId/>
<Portable>false</Portable>
<Type>system</Type>
<SerialNumber>bp18um4r4f2fve2****</SerialNumber>
<CreationTime>2021-06-07T06:08:54Z</CreationTime>
<RegionId>cn-hangzhou</RegionId>
<DiskId>d-bp18um4r4f2fve24****</DiskId>
</Disk>
</Disks>
</DescribeDisksResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"TotalCount" : 15,
"NextToken" : "AAAAAdDWBF2****",
"PageSize" : 1,
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"PageNumber" : 1,
"Disks" : {
"Disk" : [ {
"DetachedTime" : "",
"Category" : "cloud_ssd",
"Description" : "testDescription",
"KMSKeyId" : "",
"ResourceGroupId" : "",
"DedicatedBlockStorageClusterId" : "",
"Encrypted" : false,
"Size" : 40,
"DeleteAutoSnapshot" : false,
"DiskChargeType" : "PrePaid",
"MultiAttach" : "Disabled",
"Attachments" : {
"Attachment" : [ {
"AttachedTime" : "2021-06-07T06:08:56Z",
"InstanceId" : "i-bp67acfmxazb4q****",
"Device" : "/dev/xvda"
} ]
},
"ExpiredTime" : "2021-07-07T16:00Z",
"ImageId" : "m-bp13aqm171qynt3u***",
"StorageSetId" : "",
"Tags" : {
"Tag" : [ ]
},
"Status" : "In_use",
"AttachedTime" : "2021-06-07T06:08:56Z",
"StorageClusterId" : "dbsc-j5e1sf2vaf5he8m2****",
"ZoneId" : "cn-hangzhou-i",
"InstanceId" : "i-bp67acfmxazb4q****",
"SourceSnapshotId" : "",
"ProductCode" : "",
"PerformanceLevel" : "PL0",
"Device" : "/dev/xvdb",
"DeleteWithInstance" : true,
"EnableAutomatedSnapshotPolicy" : false,
"EnableAutoSnapshot" : false,
"AutoSnapshotPolicyId" : "sp-bp67acfmxazb4p****",
"DiskName" : "testDiskName",
"OperationLocks" : {
"OperationLock" : [ ]
},
"BdfId" : "",
"Portable" : false,
"Type" : "system",
"SerialNumber" : "bp18um4r4f2fve2****",
"CreationTime" : "2021-06-07T06:08:54Z",
"RegionId" : "cn-hangzhou",
"DiskId" : "d-bp18um4r4f2fve24****"
} ]
}
}Kode kesalahan
Kode status HTTP | Kode kesalahan | Pesan kesalahan | Deskripsi |
400 | InvalidDiskType.ValueNotSupported | The specified disk type is not supported. | Tipe disk tidak valid. |
400 | InvalidCategory.ValueNotSupported | The specified disk category is not supported. | Kategori disk tidak valid. |
400 | InvalidStatus.ValueNotSupported | The specified disk status is not supported. | Operasi ini tidak dapat dilakukan pada disk dalam status saat ini. |
400 | InvalidTag.Mismatch | The specified Tag.n.Key and Tag.n.Value are not match. | Parameter Tag.N.Key dan Tag.N.Value yang ditentukan tidak saling sesuai. |
400 | InvalidTagCount | The specified tags are beyond the permitted range. | Jumlah maksimum tag telah terlampaui. |
400 | InvalidRegion.NotFound | The specified parameter RegionId is not valid. | Nilai RegionId tidak valid. |
400 | InvalidZoneId.NotFound | The zoneId provided does not exist in our records. | ID zona yang ditentukan tidak ditemukan. |
400 | MissingParamter.RegionId | The regionId should not be null. | RegionId wajib diisi. |
400 | InvalidParameter.DiskIds | The specified parameter diskIds is not valid. | Nilai DiskIds tidak valid. |
400 | IncompleteParamter | Some fields can not be null in this request. | Parameter yang diperlukan tidak ditentukan. |
400 | InvalidParamter | Some parameters are invalid in this request. | Permintaan berisi parameter yang tidak valid. |
400 | InvalidSnapshot.NotFound | The specified parameter SnapshotId is not valid. | Nilai SnapshotId tidak valid. |
403 | InvalidDiskIds.Malformed | The amount of specified disk Ids exceeds the limit. | Nilai DiskIds tidak valid. |
403 | UserNotInTheWhiteList | The user is not in volume white list. | Anda tidak berwenang untuk mengelola perangkat Shared Block Storage. Kirim tiket untuk mengajukan izin. |
403 | InvalidParameter.MultiAttachAndEnableSharedNotMatch | The parameter MultiAttach and EnableShared are not match. | Parameter MultiAttach dan EnableShared yang ditentukan tidak cocok. |
403 | InvalidParameter.MultiAttach | The specified param MultiAttach is not valid. | Nilai MultiAttach tidak valid. |
404 | InvalidDiskChargeType.NotFound | The DiskChargeType does not exist in our records | DiskChargeType tidak ditemukan. |
404 | InvalidLockReason.NotFound | The specified LockReason is not found | LockReason tidak ditemukan. |
500 | InternalError | The request processing has failed due to some unknown error. | Terjadi kesalahan internal. Coba lagi nanti. |
Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.