Mengkueri informasi tentang satu atau beberapa perangkat penyimpanan blok yang dibuat, termasuk cloud disk, disk lokal, dan disk ephemeral elastis.
Deskripsi operasi
Parameter permintaan RegionId, ZoneId, DiskIds, dan InstanceId adalah filter. Parameter-parameter ini memiliki hubungan logika AND.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ecs:DescribeDisks |
list |
Disk
Disk
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
ID wilayah perangkat penyimpanan blok. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru. |
cn-hangzhou. |
| ZoneId |
string |
No |
ID zona. |
cn-hangzhou-g. |
| DiskIds |
string |
No |
ID cloud disk, disk lokal, atau disk ephemeral elastis. Nilainya adalah array JSON yang dapat berisi hingga 100 ID. Pisahkan ID dengan koma (,). |
["d-bp67acfmxazb4p****", "d-bp67acfmxazb4g****", … "d-bp67acfmxazb4d****"] |
| InstanceId |
string |
No |
ID instans tempat cloud disk, disk lokal, atau disk ephemeral elastis menyambungkan. |
i-bp67acfmxazb4q**** |
| DiskType |
string |
No |
Tipe cloud disk, disk lokal, atau disk ephemeral elastis yang akan dikueri. Nilai valid: |
all. |
| Category |
string |
No |
Kategori disk. Nilai valid: |
all. |
| Status |
string |
No |
Status disk. Untuk informasi lebih lanjut, lihat Status disk. Nilai valid: |
All. |
| SnapshotId |
string |
No |
ID snapshot yang digunakan untuk membuat cloud disk. |
s-bp67acfmxazb4p**** |
| Portable |
boolean |
No |
Apakah disk dapat dilepas. Nilai valid: |
false. |
| DeleteWithInstance |
boolean |
No |
Apakah disk diatur untuk dirilis bersama dengan instans. Nilai valid: |
false. |
| DeleteAutoSnapshot |
boolean |
No |
Apakah snapshot otomatis dirilis saat cloud disk dirilis. |
false. |
| PageNumber |
integer |
No |
Catatan
Parameter ini akan segera didepresiasi. Gunakan NextToken dan MaxResults untuk operasi paging. |
1 |
| PageSize |
integer |
No |
Catatan
Parameter ini akan segera didepresiasi. Gunakan NextToken dan MaxResults untuk operasi paging. |
10 |
| NextToken |
string |
No |
Token paginasi. Atur parameter ini ke nilai NextToken yang dikembalikan dalam panggilan API sebelumnya. |
AAAAAdDWBF2**** |
| MaxResults |
integer |
No |
Jumlah maksimum entri yang akan dikembalikan. Nilai valid: 10 hingga 500. |
50 |
| DiskName |
string |
No |
Nama disk. Panjang nama harus 2 hingga 128 karakter dan dapat berisi karakter Unicode dalam kategori huruf (termasuk huruf, angka, dan karakter dari bahasa lain). Nama dapat berisi titik dua (:), garis bawah (_), titik (.), dan tanda hubung (-). |
testDiskName. |
| AutoSnapshotPolicyId |
string |
No |
ID kebijakan snapshot otomatis yang digunakan untuk mengkueri cloud disk. |
sp-m5e2w2jutw8bv31**** |
| EnableAutoSnapshot |
boolean |
No |
Apakah fitur kebijakan snapshot otomatis diaktifkan untuk cloud disk. |
true. |
| EnableAutomatedSnapshotPolicy |
boolean |
No |
Apakah kebijakan snapshot otomatis diterapkan pada cloud disk. |
false. |
| DiskChargeType |
string |
No |
Metode penagihan disk. Nilai valid: |
PostPaid. |
| LockReason |
string |
No |
Alasan disk terkunci. Nilai valid: |
security. |
| Filter.1.Key |
string |
No |
Kunci filter yang digunakan untuk mengkueri Sumber daya. Atur nilainya ke |
CreationStartTime. |
| Filter.2.Key |
string |
No |
Kunci filter yang digunakan untuk mengkueri Sumber daya. Atur nilainya ke |
CreationEndTime. |
| Filter.1.Value |
string |
No |
Nilai filter yang digunakan untuk mengkueri Sumber daya. Saat Anda menentukan parameter ini, Anda juga harus menentukan Filter.1.Key. Tentukan pengatur waktu dalam format |
2017-12-05T22:40Z |
| Filter.2.Value |
string |
No |
Nilai filter yang digunakan untuk mengkueri Sumber daya. Saat Anda menentukan parameter ini, Anda juga harus menentukan Filter.2.Key. Tentukan pengatur waktu dalam format |
2017-12-06T22:40Z |
| ResourceGroupId |
string |
No |
ID kelompok sumber daya tempat disk berada. Saat Anda menggunakan parameter ini untuk memfilter resource, jumlah resource tidak boleh melebihi 1.000. |
rg-bp67acfmxazb4p**** |
| EnableShared |
boolean |
No |
Apakah disk adalah perangkat Shared Block Storage. |
false. |
| Encrypted |
boolean |
No |
Apakah hanya mengkueri cloud disk terenkripsi. |
false. |
| DryRun |
boolean |
No |
Apakah akan menjalankan dry run saja. Nilai valid: |
false. |
| KMSKeyId |
string |
No |
ID kunci Key Management Service (KMS) yang digunakan oleh cloud disk. |
0e478b7a-4262-4802-b8cb-00d3fb40**** |
| MultiAttach |
string |
No |
Apakah fitur multi-attach diaktifkan. Nilai valid: |
Disabled. |
| Tag |
array<object> |
No |
Daftar tag disk. |
|
|
object |
No |
Tag disk. |
||
| key |
string |
No |
Kunci tag disk. |
null. |
| Key |
string |
No |
Kunci tag disk. Nilai valid N: 1 hingga 20. |
TestKey. |
| Value |
string |
No |
Nilai tag disk. Nilai valid N: 1 hingga 20. |
TestValue. |
| value |
string |
No |
Nilai tag disk. |
null. |
| AdditionalAttributes |
array |
No |
Daftar nilai atribut tambahan. Satu-satunya nilai valid adalah |
IOPS. |
|
string |
No |
Nilai atribut tambahan. Satu-satunya nilai valid adalah Placement, yang mengkueri lokasi penyimpanan data disk. |
Placement. |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
|||
| NextToken |
string |
Token paginasi yang dikembalikan dalam panggilan ini. |
AAAAAdDWBF2**** |
| PageSize |
integer |
Catatan
Parameter ini akan segera didepresiasi. Gunakan NextToken dan MaxResults untuk operasi paging. |
1 |
| PageNumber |
integer |
Catatan
Parameter ini akan segera didepresiasi. Gunakan NextToken dan MaxResults untuk operasi paging. |
1 |
| RequestId |
string |
ID permintaan. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| TotalCount |
integer |
Jumlah total entri yang dikembalikan. |
15 |
| Disks |
object |
||
| Disk |
array<object> |
Koleksi informasi disk. |
|
|
array<object> |
Informasi disk. |
||
| SerialNumber |
string |
Nomor seri disk. |
bp18um4r4f2fve2**** |
| CreationTime |
string |
Waktu pembuatan. |
2021-06-07T06:08:54Z |
| Status |
string |
Status disk. Nilai valid:
|
In_use |
| Type |
string |
Tipe disk. Nilai valid:
|
system |
| PerformanceLevel |
string |
Tingkat kinerja (PL) ESSD. Nilai valid:
|
PL0 |
| BdfId |
string |
Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk umum. |
null |
| EnableAutoSnapshot |
boolean |
Menunjukkan apakah fitur kebijakan snapshot otomatis diaktifkan untuk disk. Catatan
Parameter ini sudah tidak digunakan lagi. Setelah disk dibuat, fitur kebijakan snapshot otomatis diaktifkan secara default. Anda hanya perlu mengaitkan kebijakan snapshot otomatis dengan disk. |
false |
| StorageSetId |
string |
ID storage set. |
ss-i-bp1j4i2jdf3owlhe**** |
| StorageSetPartitionNumber |
integer |
Jumlah partisi maksimum dalam storage set. |
11 |
| DiskId |
string |
ID disk. |
d-bp18um4r4f2fve24**** |
| DeleteAutoSnapshot |
boolean |
Menunjukkan apakah snapshot otomatis dihapus saat disk dirilis. Nilai valid:
Snapshot yang dibuat dengan memanggil CreateSnapshot atau menggunakan konsol tidak terpengaruh oleh parameter ini dan selalu dipertahankan. |
false |
| StorageClusterId |
string |
ID kluster penyimpanan blok khusus tempat disk berada. Jika disk berada di kluster penyimpanan blok publik, nilai ini kosong. |
dbsc-j5e1sf2vaf5he8m2**** |
| Encrypted |
boolean |
Menunjukkan apakah disk terenkripsi. |
false |
| IOPSRead |
integer |
Jumlah maksimum operasi baca per detik. Unit: operasi/detik. |
2000 |
| MountInstanceNum |
integer |
Jumlah instans tempat perangkat Shared Block Storage disambungkan. |
1 |
| Description |
string |
Deskripsi disk. |
testDescription |
| Device |
string |
Nama perangkat disk pada instans tempat disk disambungkan, seperti /dev/xvdb. Catatan:
Catatan
Parameter ini sedang dihentikan. Untuk meningkatkan kompatibilitas mundur, jangan gunakan parameter ini. |
/dev/xvdb |
| DiskName |
string |
Nama disk. |
testDiskName |
| Portable |
boolean |
Menunjukkan apakah disk dapat dipindahkan. |
false |
| ImageId |
string |
ID image yang digunakan untuk membuat Instans ECS. Parameter ini memiliki nilai hanya untuk disk yang dibuat dari image. Jika tidak, parameter ini kosong. Jika image yang digunakan untuk membuat disk dihapus, parameter ini kosong. |
m-bp13aqm171qynt3u*** |
| KMSKeyId |
string |
ID kunci Key Management Service (KMS) yang digunakan oleh disk. |
0e478b7a-4262-4802-b8cb-00d3fb408*** |
| DeleteWithInstance |
boolean |
Menunjukkan apakah disk dirilis saat Instansi terkait dirilis. Nilai valid:
|
true |
| DetachedTime |
string |
Waktu terakhir disk dilepaskan. |
2021-06-07T21:01:22Z |
| SourceSnapshotId |
string |
ID snapshot yang digunakan untuk membuat disk. Jika tidak ada snapshot yang ditentukan saat disk dibuat, parameter ini kosong. Jika snapshot yang digunakan untuk membuat disk dihapus, parameter ini kosong. |
s-bp67acfmxazb4p**** |
| AutoSnapshotPolicyId |
string |
ID kebijakan snapshot otomatis yang diterapkan ke disk. Catatan
Parameter ini sedang dihentikan. Jika beberapa kebijakan snapshot otomatis diterapkan ke disk, hanya satu ID kebijakan yang dikembalikan. Gunakan DescribeAutoSnapshotPolicyAssociations untuk mengkueri semua kebijakan snapshot otomatis yang diterapkan ke disk. |
sp-bp67acfmxazb4p**** |
| EnableAutomatedSnapshotPolicy |
boolean |
Menunjukkan apakah kebijakan snapshot otomatis diterapkan ke disk. |
false |
| IOPSWrite |
integer |
Jumlah maksimum operasi tulis per detik. Unit: operasi/detik. |
2000 |
| InstanceId |
string |
ID instans tempat disk disambungkan. Catatan:
|
i-bp67acfmxazb4q**** |
| IOPS |
integer |
Jumlah maksimum operasi baca/tulis (I/O) per detik. Unit: operasi/detik. |
4000 |
| RegionId |
string |
ID wilayah disk. |
cn-hangzhou |
| ExpiredTime |
string |
Waktu kedaluwarsa disk langganan. |
2021-07-07T16:00Z |
| Size |
integer |
Ukuran disk. Unit: GiB. |
60 |
| ResourceGroupId |
string |
ID kelompok sumber daya tempat disk berada. |
rg-bp67acfmxazb4p**** |
| DiskChargeType |
string |
Metode penagihan disk. Nilai valid:
|
PrePaid |
| ZoneId |
string |
ID zona disk. |
cn-hangzhou-i |
| AttachedTime |
string |
Waktu terakhir disk disambungkan. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddThh:mmZ. Waktu ditampilkan dalam UTC+0. |
2021-06-07T06:08:56Z |
| Category |
string |
Kategori disk. Nilai valid:
|
cloud_ssd |
| ProductCode |
string |
Kode produk image Alibaba Cloud Marketplace. |
jxsc000204 |
| MultiAttach |
string |
Menunjukkan apakah fitur multi-attach diaktifkan untuk disk. |
Disabled |
| OperationLocks |
object |
||
| OperationLock |
array<object> |
Daftar alasan disk terkunci. |
|
|
object |
Alasan disk terkunci. |
||
| LockReason |
string |
Alasan disk terkunci karena alasan keamanan. |
security |
| MountInstances |
object |
||
| MountInstance |
array<object> |
Koleksi informasi tentang instans tempat perangkat Shared Block Storage disambungkan. |
|
|
object |
Informasi tentang instans tempat perangkat Shared Block Storage disambungkan. |
||
| AttachedTime |
string |
Waktu disk disambungkan. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC+0. |
2017-12-05T2340:00Z |
| InstanceId |
string |
ID instans tempat disk disambungkan. |
i-bp1j4i2jdf3owlhe**** |
| Device |
string |
Titik memasang disk. |
/dev/xvda |
| Tags |
object |
||
| Tag |
array<object> |
Koleksi tag disk. |
|
|
object |
Tag disk. |
||
| TagValue |
string |
Nilai tag. |
TestValue |
| TagKey |
string |
Kunci tag. |
TestKey |
| Attachments |
object |
||
| Attachment |
array<object> |
Daftar informasi penyambungan disk, yang terdiri dari objek Attachment. Daftar ini tidak dikembalikan saat Anda mengkueri perangkat Shared Block Storage. |
|
|
object |
Informasi penyambungan disk. |
||
| InstanceId |
string |
ID instans yang disambungkan. |
i-bp67acfmxazb4q**** |
| Device |
string |
Nama perangkat. |
/dev/xvda |
| AttachedTime |
string |
Waktu disk disambungkan. Waktu ditampilkan dalam UTC+0. |
2021-06-07T06:08:56Z |
| ProvisionedIops |
integer |
IOPS baca/tulis yang disediakan dari disk ESSD AutoPL. Nilai valid: 0 hingga min{50000, 1000 × Kapasitas - Kinerja dasar}. Kinerja dasar = min{1800 + 50 × Kapasitas, 50000}. Parameter ini hanya didukung ketika DiskCategory diatur ke cloud_auto. Untuk informasi lebih lanjut, lihat Disk ESSD AutoPL. |
40000 |
| BurstingEnabled |
boolean |
Menunjukkan apakah fitur lonjakan performa diaktifkan. Nilai valid:
Parameter ini hanya didukung ketika DiskCategory diatur ke cloud_auto. Untuk informasi lebih lanjut, lihat Disk ESSD AutoPL. |
false |
| Throughput |
integer |
Jumlah data yang dapat ditransfer per unit waktu. Unit: MB/s. |
100 |
| ThroughputRead |
integer |
Jumlah data yang dapat dibaca sistem per unit waktu. Unit: MB/s. |
100 |
| ThroughputWrite |
integer |
Jumlah data yang dapat ditulis sistem per unit waktu. Unit: MB/s. |
100 |
| Placement |
object |
Koleksi lokasi penyimpanan data. Bidang ini hanya dikembalikan ketika AdditionalAttributes.N diatur ke Placement dalam permintaan. Catatan
Hanya disk ESSD regional (cloud_regional_disk_auto) yang memiliki nilai valid. |
|
| ZoneIds |
string |
Daftar zona tempat data disimpan. |
"["cn-hangzhou-b", "cn-hangzhou-j"]" |
| SourceDiskId |
string |
d-123********* |
|
| DataSource |
object |
||
| Id |
string |
||
| Type |
string |
Contoh
Respons sukses
JSONformat
{
"NextToken": "AAAAAdDWBF2****",
"PageSize": 1,
"PageNumber": 1,
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"TotalCount": 15,
"Disks": {
"Disk": [
{
"SerialNumber": "bp18um4r4f2fve2****",
"CreationTime": "2021-06-07T06:08:54Z",
"Status": "In_use",
"Type": "system",
"PerformanceLevel": "PL0",
"BdfId": "null",
"EnableAutoSnapshot": false,
"StorageSetId": "ss-i-bp1j4i2jdf3owlhe****",
"StorageSetPartitionNumber": 11,
"DiskId": "d-bp18um4r4f2fve24****",
"DeleteAutoSnapshot": false,
"StorageClusterId": "dbsc-j5e1sf2vaf5he8m2****",
"Encrypted": false,
"IOPSRead": 2000,
"MountInstanceNum": 1,
"Description": "testDescription",
"Device": "/dev/xvdb",
"DiskName": "testDiskName",
"Portable": false,
"ImageId": "m-bp13aqm171qynt3u***",
"KMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb408***",
"DeleteWithInstance": true,
"DetachedTime": "2021-06-07T21:01:22Z",
"SourceSnapshotId": "s-bp67acfmxazb4p****",
"AutoSnapshotPolicyId": "sp-bp67acfmxazb4p****",
"EnableAutomatedSnapshotPolicy": false,
"IOPSWrite": 2000,
"InstanceId": "i-bp67acfmxazb4q****",
"IOPS": 4000,
"RegionId": "cn-hangzhou",
"ExpiredTime": "2021-07-07T16:00Z",
"Size": 60,
"ResourceGroupId": "rg-bp67acfmxazb4p****",
"DiskChargeType": "PrePaid",
"ZoneId": "cn-hangzhou-i",
"AttachedTime": "2021-06-07T06:08:56Z",
"Category": "cloud_ssd",
"ProductCode": "jxsc000204",
"MultiAttach": "Disabled",
"OperationLocks": {
"OperationLock": [
{
"LockReason": "security"
}
]
},
"MountInstances": {
"MountInstance": [
{
"AttachedTime": "2017-12-05T2340:00Z",
"InstanceId": "i-bp1j4i2jdf3owlhe****",
"Device": "/dev/xvda"
}
]
},
"Tags": {
"Tag": [
{
"TagValue": "TestValue",
"TagKey": "TestKey"
}
]
},
"Attachments": {
"Attachment": [
{
"InstanceId": "i-bp67acfmxazb4q****",
"Device": "/dev/xvda",
"AttachedTime": "2021-06-07T06:08:56Z"
}
]
},
"ProvisionedIops": 40000,
"BurstingEnabled": false,
"Throughput": 100,
"ThroughputRead": 100,
"ThroughputWrite": 100,
"Placement": {
"ZoneIds": "\"[\"cn-hangzhou-b\",\n\"cn-hangzhou-j\"]\""
},
"SourceDiskId": "d-123*********",
"DataSource": {
"Id": "",
"Type": ""
}
}
]
}
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidDiskType.ValueNotSupported | The specified disk type is not supported. | Atribut disk yang ditentukan tidak didukung. |
| 400 | InvalidCategory.ValueNotSupported | The specified disk category is not supported. | Kategori disk yang ditentukan tidak didukung atau Anda tidak memiliki izin yang diperlukan. |
| 400 | InvalidStatus.ValueNotSupported | The specified disk status is not supported. | repairStatus dari masalah yang ditentukan tidak valid. Status yang diharapkan adalah kosong atau gagal. |
| 400 | InvalidTag.Mismatch | The specified Tag.n.Key and Tag.n.Value are not match. | Tag.N.Key dan Tag.N.Value yang ditentukan tidak cocok. |
| 400 | InvalidTagCount | The specified tags are beyond the permitted range. | Tag yang ditentukan berada di luar rentang valid. |
| 400 | InvalidRegion.NotFound | The specified parameter RegionId is not valid. | Wilayah yang ditentukan tidak ada. Periksa apakah parameter ini benar. |
| 400 | InvalidZoneId.NotFound | The zoneId provided does not exist in our records. | ID zona yang ditentukan tidak ada. |
| 400 | MissingParamter.RegionId | The regionId should not be null. | Parameter wilayah tidak ada. |
| 400 | InvalidParameter.DiskIds | The specified parameter diskIds is not valid. | Parameter diskIds yang ditentukan tidak valid. |
| 400 | IncompleteParamter | Some fields can not be null in this request. | Parameter yang diperlukan hilang dari permintaan. |
| 400 | InvalidParamter | Some parameters are invalid in this request. | Parameter input tidak valid. |
| 400 | InvalidSnapshot.NotFound | The specified parameter SnapshotId is not valid. | SnapshotId yang ditentukan tidak valid. |
| 500 | InternalError | The request processing has failed due to some unknown error. | |
| 403 | InvalidDiskIds.Malformed | The amount of specified disk Ids exceeds the limit. | |
| 403 | InvalidCategory.ValueNotSupported | The specified disk category is not supported. | |
| 403 | UserNotInTheWhiteList | The user is not in volume white list. | |
| 403 | InvalidParameter.MultiAttachAndEnableSharedNotMatch | The parameter MultiAttach and EnableShared are not match. | Nilai parameter MultiAttach dan parameter EnableShared tidak kompatibel. |
| 403 | InvalidParameter.MultiAttach | The specified param MultiAttach is not valid. | Nilai parameter MultiAttach tidak valid. |
| 404 | InvalidFilterKey.NotFound | The filter key is not found. | |
| 404 | InvalidFilterValue | The filter value is not valid. | |
| 404 | InvalidDiskIds.ValueNotSupported | The specified parameter "DiskIds" is not supported. | Nilai parameter DiskIds yang ditentukan tidak valid atau formatnya salah. |
| 404 | InvalidDiskChargeType.NotFound | The DiskChargeType does not exist in our records. | Metode penagihan disk yang ditentukan tidak ada. |
| 404 | InvalidLockReason.NotFound | The specified LockReason is not found. | Alasan penguncian yang ditentukan tidak ada. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.