DescribeDiskMonitorData_云服务器 ECS_API文档-阿里云OpenAPI开发者门户

接口说明

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

只能查询状态为使用中（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", //设置数据精度

流控信息

请求速率为100/60(s)。更多流控信息，请前往配额中心查看

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

ecs:DescribeDiskMonitorData	Get	Disk acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}	无	无

请求参数

字段名称	字段详情
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

返回示例

错误返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	InvalidStartTime.Malformed	The specified parameter "StartTime" is not valid.	诊断
400	InvalidEndTime.Malformed	The specified parameter "EndTime" is not valid.	诊断
400	InvalidPeriod.ValueNotSupported	The specified parameter "Period" is not valid.	诊断
400	InvalidStartTime.TooEarly	The specified parameter "StartTime" is too early.	诊断
400	InvalidParameter.TooManyDataQueried	Too many data queried.	诊断
400	Throttling	Request was denied due to request throttling.	诊断
400	InvalidInstanceType.NotSupportCredit	The InstanceType of the specified instance does not support credit.	诊断
400	InvalidParameter.EndTime	The specified parameter EndTime is earlier than StartTime.	诊断
404	InvalidDiskId.NotFound	The DiskId provided does not exist in our records.	诊断
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	诊断

变更历史

	变更时间	变更内容概要	操作
	2023-05-06	删除返回参数