阿里云如何使用查詢磁盤接口

　　下面的參數(shù)中，RegionId，ZoneId，DiskIds，InstanceId，… 等參數(shù)都是過濾器的概念，參數(shù)間是邏輯與關(guān)系。其中 DiskIds 是一個(gè) Json 格式的 Json Array，格式如下。

　　如果參數(shù)為空，則過濾器不起作用，但是 DiskIds 如果是一個(gè)空 Json Array(即[])，則視為該過濾器有效，且返回空。

　　請(qǐng)求參數(shù)

名稱 類型 是否必須 描述
Action   String   是   系統(tǒng)規(guī)定參數(shù)，取值：DescribeDisks  
RegionId   String   是   磁盤所屬于的 Region ID  
ZoneId   String   否   默認(rèn)值為空，空代表查詢所有可用區(qū)下的磁盤。  
DiskIds   String   否   磁盤 ID
一個(gè)帶有格式的 Json Array：[“d-xxxxxxxxx”, ”d-yyyyyyyyy”, … “d-zzzzzzzzz”]，最多 100 個(gè) Id，用半角逗號(hào)字符隔開。  
InstanceId   String   否   實(shí)例 ID  
DiskType   String   否   all | system | data，默認(rèn)值為 all。  
Category   String   否   磁盤種類
all | cloud | cloud_efficiency | cloud_ssd | ephemeral | ephemeral_ssd。默認(rèn)值為all  
Status   String   否   磁盤狀態(tài)
In_use | Available | Attaching | Detaching | Creating | ReIniting | All，默認(rèn)值為 All。  
SnapshotId   String   否   創(chuàng)建磁盤使用的快照  
DiskName   String   否   磁盤名稱  
Portable   String   否   磁盤是否支持卸載：

true 代表是可卸載云盤，可以獨(dú)立存在且可以自由在可用區(qū)內(nèi)掛載和下載

false 代表不可卸載云盤，只能和實(shí)例同生同滅

用戶如果需要做 attach 和 detach 操作，必須先查詢一下這個(gè)屬性為 true 的磁盤才能操作。
本地磁盤，本地SSD盤 和 普通云盤，高效云盤和SSD云盤的系統(tǒng)盤 和 包月的普通云盤，高效云盤，SSD云盤，該屬性都為 false。
這個(gè)屬性用戶不能更改。  
DeleteWithInstance   String   否   磁盤是否隨實(shí)例釋放：

true 表示 Instance 釋放時(shí)，這塊磁盤隨 Instance 一起釋放

false 表示 Instance 釋放時(shí)，這塊磁盤保留不釋放

 
DeleteAutoSnapshot   String   否   刪除磁盤時(shí)，是否同時(shí)刪除自動(dòng)快照。

true 表示同時(shí)刪除自動(dòng)快照

false 表示保留自動(dòng)快照

 
EnableAutoSnapshot   String   否   磁盤是否執(zhí)行自動(dòng)快照策略（前提是用戶整體的自動(dòng)快照策略已經(jīng)開啟）：

true，表示這塊磁盤執(zhí)行自動(dòng)快照策略

false，表示這塊磁盤不執(zhí)行自動(dòng)快照策略

默認(rèn)值：無，表示不改變當(dāng)前的值  
DiskChargeType   String   否   磁盤的付費(fèi)方式。

PrePaid：預(yù)付費(fèi)，即包年包月

PostPaid：后付費(fèi)，即按量付費(fèi)

 
Tag.n.Key   String   否   標(biāo)簽 key，n 從 1 開始，最大為 5。
不允許為空字符串。  
Tag.n.Value   String   否   標(biāo)簽 value，n 從 1 開始，最大為 5。
允許為空字符串。  
PageNumber   Integer   否   磁盤狀態(tài)列表的頁碼，起始值為 1，默認(rèn)值為 1  
PageSize   Integer   否   分頁查詢時(shí)設(shè)置的每頁行數(shù)，最大值 100 行，默認(rèn)為 10  

　　返回參數(shù)

名稱 類型 描述
RegionId   String   鏡像所屬地域 Id  
TotalCount   Integer   磁盤總個(gè)數(shù)  
PageNumber   Integer   磁盤列表的頁碼  
PageSize   Integer   輸入時(shí)設(shè)置的每頁行數(shù)  
Disks   DiskItemType   磁盤信息 DiskItemType 組成的集合