DescribeDiskMonitorData
查询一块云盘在指定时间内的使用信息，例如，云盘读IOPS、写IOPS、读带宽（B/s）、写带宽（B/s）、读时延（μs）以及写时延（μs）
服务地址：
华东1 金融云
输入参数
只看必填
DiskId待查询的云盘ID
StartTime数据的起始时间
EndTime数据的结束时间
Period数据的精度
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

调用该接口时，您需要注意以下限制：

  • 只能查询状态为使用中（In_use）的云盘使用信息。更多详情，请参见普通云盘状态表。

    说明 若查询的信息中出现内容缺失，是因为无法获取该段时间的使用信息，即云盘状态不是使用中（In_use）。

  • 一次最多返回 400 条数据，需满足（EndTime–StartTime）/Period小于等于 400 的条件限制，即返回参数TotalCount不能超过 400，否则将返回InvalidParameter.TooManyDataQueried的错误提示。

  • 一次最多能查询近 30 天内的监控信息，即指定的参数StartTime距今不能超过 30 天。

请求示例

假设您需要查询华东 1（杭州）地域下 ID 为d-bp14emm68wx98vjk****的磁盘，在2025-02-17T00:00:00Z至2025-02-18T10:00:00Z期间，每 600 秒内的使用信息。相关配置请求参数如下：

RegionId:"cn-hangzhou", //设置华东 1（杭州）地域
DiskId:"d-bp14emm68wx98vjk****", //设置磁盘 ID
StartTime:"2025-02-15T00:00:00Z", //设置查询起始时间
EndTime:"2025-02-17T00:00:00Z", //设置查询结束时间
Period:"600", //设置数据精度

请求参数

字段名称字段详情
DiskIdstring

待查询的云盘 ID。

示例值:d-bp1bq5g3dxxo1x4o****参考取值来源:
    CreateDisk
    DescribeDisks
StartTimestring

数据的起始时间。按照ISO 8601标准表示，并使用 UTC +0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。如果秒（ss）不是 00，则自动取为下一分钟开始时。展开详情

示例值:2014-07-23T12:07:00Z
EndTimestring

数据的结束时间。按照ISO 8601标准表示，并使用 UTC +0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。如果秒（ss）不是 00，则自动取为下一分钟开始时。

示例值:2014-07-23T12:09:00Z
Periodinteger<int32>

数据的精度，单位为秒。取值范围：展开详情

示例值:60枚举值:606003600

返回参数

字段名称字段详情
TotalCountinteger<int32>

云盘使用信息的返回条目数量，即周期数。

示例值:3
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
MonitorDataobject
变更历史
变更时间变更内容概要操作
2023-05-06
删除返回参数