全部產品
Search
文件中心

Elastic Compute Service:DescribeLensMonitorDisks

更新時間:Aug 24, 2026

查詢一個或多個您已建立的區塊儲存雲端硬碟。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ebs:DescribeLensMonitorDisks

list

*All Resource

*

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

地域 ID。您可以呼叫 DescribeRegions 查詢區塊儲存資料洞察支援的地域清單。

cn-hangzhou

DiskIds

array

指定雲端硬碟 ID 清單。

['d-1', 'd-2']

string

雲端硬碟 ID。

d-cd40hxfu0v*****

DiskCategory

string

雲端硬碟類型。取值範圍:

  • cloud:普通雲端硬碟。

  • cloud_efficiency:高效能雲端硬碟。

  • cloud_ssd:SSD 雲端硬碟。

  • cloud_essd:ESSD 雲端硬碟。

  • cloud_auto:ESSD AutoPL 雲端硬碟。

  • cloud_essd_entry:ESSD Entry 雲端硬碟。

cloud_auto

LensTags

array

雲端硬碟事件標籤清單,用於篩選 24 小時內發生過這些事件類型的雲端硬碟。取值範圍:

  • NoSnapshot:資料保護

  • BurstIOTriggered:突發 IO

  • CostOptimizationNeeded:成本最佳化

  • DiskSpecNotMatchedWithInstance:執行個體與雲端硬碟規格不匹配

  • DiskIONo4kAligned:非 4K 對齊讀寫

  • DiskIOHang:雲端硬碟發生 IO Hang

  • InstanceIOPSExceedInstanceMaxLimit:執行個體 IOPS 達到上限

  • InstanceBPSExceedInstanceMaxLimit:執行個體 BPS 達到上限

  • DiskIOPSExceedInstanceMaxLimit:雲端硬碟 IOPS 達到執行個體上限

  • DiskBPSExceedInstanceMaxLimit:雲端硬碟 BPS 達到執行個體上限

  • DiskIOPSExceedDiskMaxLimit:雲端硬碟 IOPS 達到磁碟上限

  • DiskBPSExceedDiskMaxLimit:雲端硬碟 BPS 達到磁碟上限

string

雲端硬碟事件標籤。

NoSnapshot

NextToken

string

查詢憑證(Token),取值為上一次 API 呼叫返回的 NextToken 參數值。

caeba0bbb2be03f84eb48b699f0a****

MaxResults

integer

分頁查詢時每頁列數。最大值為 100。 預設值:

  • 預設值為 10。

  • 當設定的值大於 100 時,預設值為 100。

10

DiskIdPattern

string

使用正則表達式模糊查詢篩選雲端硬碟 ID。

d-cd40hxfu0v*

返回參數

名稱

類型

描述

樣本值

object

DescribeLensMonitorDisksResponse

DiskInfos

array<object>

雲端硬碟資訊清單。

array<object>

雲端硬碟資訊。

DiskId

string

雲端硬碟 ID。

d-cd401****

DiskName

string

雲端硬碟名稱。

disk-28c6b****

DiskType

string

雲端硬碟類型。可能值:

  • system:系統磁碟。

  • data:資料磁碟。

system

DiskStatus

string

雲端硬碟狀態。可能值:

  • Available:使用中。

  • Deleted:已刪除。

Available

RegionId

string

地域 ID。

cn-hangzhou

DiskCategory

string

雲端硬碟類型。取值範圍:

  • cloud:普通雲端硬碟。

  • cloud_efficiency:高效能雲端硬碟。

  • cloud_ssd:SSD 雲端硬碟。

  • cloud_essd:ESSD 雲端硬碟。

  • cloud_auto:ESSD AutoPL 雲端硬碟。

  • cloud_essd_entry:ESSD Entry 雲端硬碟。

cloud_essd

PerformanceLevel

string

ESSD 雲端硬碟的效能等級。可能值:

  • PL0:單顆磁碟最高隨機讀寫 IOPS 1 萬。

  • PL1:單顆磁碟最高隨機讀寫 IOPS 5 萬。

  • PL2:單顆磁碟最高隨機讀寫 IOPS 10 萬。

  • PL3:單顆磁碟最高隨機讀寫 IOPS 100 萬。

PL0

Tags

array<object>

雲端硬碟的標籤集合。

object

雲端硬碟的標籤。

TagValue

string

標籤值。

user

TagKey

string

標籤鍵。

tag1

ZoneId

string

雲端硬碟所屬的可用區 ID。

cn-hangzhou-j

Size

integer

雲端硬碟大小,單位為 GiB。

64

Iops

integer

每秒讀寫(I/O)操作的次數上限,單位:次/秒。

4000

Bps

integer

每秒讀寫(I/O)成功傳輸的資料量上限,單位:MB/s。

300

ProvisionedIops

integer

ESSD AutoPL 雲端硬碟預先配置的讀寫 IOPS。可能值:0~min{50000, 1000*容量-基準效能}。

基準效能=min{1,800+50*容量, 50,000}。

DiskCategory 取值為 cloud_auto 時才支援設定此參數。更多資訊,請參見 ESSD AutoPL 雲端硬碟

4000

BurstingEnabled

boolean

是否開啟 Burst(效能突發)。可能值:

  • true:是。

  • false:否。

DiskCategory 取值為 cloud_auto 時才支援設定此參數。更多資訊,請參見 ESSD AutoPL 雲端硬碟

true

LensTags

array

雲端硬碟的事件標籤集合。事件標籤顯示雲端硬碟 24 小時內發生過的事件,相較於實際事件有 1 小時內的延遲。

string

雲端硬碟的事件標籤。

["NoSnapshot", "DiskIOHang"]

SharingEnabled

string

是否為共用磁碟。

true

NextToken

string

查詢憑證(Token),取值為上一次 API 呼叫返回的 NextToken 參數值。

caeba0bbb2be03f84eb48b699f0a****

TotalCount

integer

查詢結果總筆數。

6

RequestId

string

請求 ID。無論呼叫介面成功與否,我們都會返回請求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

樣本

正常返回樣本

JSON格式

{
  "DiskInfos": [
    {
      "DiskId": "d-cd401****",
      "DiskName": "disk-28c6b****",
      "DiskType": "system",
      "DiskStatus": "Available",
      "RegionId": "cn-hangzhou",
      "DiskCategory": "cloud_essd",
      "PerformanceLevel": "PL0",
      "Tags": [
        {
          "TagValue": "user",
          "TagKey": "tag1"
        }
      ],
      "ZoneId": "cn-hangzhou-j",
      "Size": 64,
      "Iops": 4000,
      "Bps": 300,
      "ProvisionedIops": 4000,
      "BurstingEnabled": true,
      "LensTags": [
        "[\"NoSnapshot\", \"DiskIOHang\"]"
      ],
      "SharingEnabled": "true"
    }
  ],
  "NextToken": "caeba0bbb2be03f84eb48b699f0a****",
  "TotalCount": 6,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 InvalidParameter The parameter %s is invalid.
400 InvalidParameter.Conflict The specified parameter %s and %s are not blank at the same time.
400 InvalidParameter.Format Specified parameter format is not valid.
400 MissingParameter The input parameter %s that is mandatory for processing this request is not supplied.
500 InternalError The request processing has failed due to some unknown error, exception or failure.
403 Forbidden User is not authorized to operate.
403 Forbidden.Action User is not authorized to operate this action.
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance.
403 LastTokenProcessing The last token request is processing.
403 NoPermission.SLR The RAM user does not have the permission to create service linked role: AliyunServiceLinkedRoleForEBS.
403 OperationDenied The operation is not allowed.
404 InvalidApi.NotFound Specified api is not found, please check your url and method.
404 NoSuchResource The specified resource does not exist.
504 RequestTimeout The request is timeout, please try again later.
429 BLOCK.LimitedRequest Request was denied due to user flow control.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情