查询一块或多块磁盘的全部状态信息。
描述
- 磁盘的全部状态信息包含磁盘生命周期(Status),磁盘健康状态(HealthStatus)和磁盘事件类型(EventType)。
- 由于磁盘相关事件的发布时间、事件的计划执行时间以及事件的实际执行时间相同,如果指定一段时间 EventTime.Start~EventTime.End,则可以查询这段时间中发生过的所有历史事件。目前,您最多可以查询最近一周的历史事件。
调试
前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
RegionId | String | 是 | cn-hangzhou |
磁盘所在地域ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 |
Action | String | 否 | DescribeDisksFullStatus |
系统规定参数。取值:DescribeDisksFullStatus |
DiskId.N | RepeatList | 否 | d-disk1 |
磁盘ID,N的取值范围:1~100。 |
EventId.N | RepeatList | 否 | e-event1 |
事件ID,N的取值范围:1~100。 |
EventTime.End | String | 否 | 2018-05-08T02:48:52Z |
查询事件发生时间的结束时间。按照 ISO8601 标准表示,并需要使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ。 |
EventTime.Start | String | 否 | 2018-05-06T02:43:10Z |
查询事件发生时间的开始时间。按照 ISO8601 标准表示,并需要使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ。 |
EventType | String | 否 | Stalled |
指定磁盘的事件类型。取值范围:
|
HealthStatus | String | 否 | Warning |
指定磁盘的健康状态。取值范围:
|
OwnerAccount | String | 否 | ECSforCloud@Alibaba.com |
RAM 用户的账号登录名称。 |
PageNumber | Integer | 否 | 1 |
查询结果的页码。取值范围:正整数 默认值:1 |
PageSize | Integer | 否 | 10 |
查询结果的分页大小。取值范围:1~100 默认值:10 |
Status | String | 否 | Available |
指定磁盘的生命周期状态,参阅 云盘状态表。取值范围:
|
返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DiskFullStatusSet |
磁盘全状态数组。 |
||
└Device | String | /dev/xvdb |
磁盘挂载于实例上的设备名,例如 /dev/xvdb。只有在Status为In_use时才有值,其他状态为空。 |
└DiskEventSet |
磁盘事件数组。 |
||
└EventEndTime | String | 2018-05-06T02:48:52Z |
事件结束时间。 |
└EventId | String | e-event1 |
磁盘事件ID。 |
└EventTime | String | 2018-05-08T02:43:10Z |
事件发生时间。 |
└EventType |
事件类型。 |
||
└Code | Integer | 7 |
事件类型代码。 |
└Name | String | Stalled |
事件类型名称。 |
└DiskId | String | d-disk1 |
磁盘ID。 |
└HealthStatus |
磁盘健康状态。 |
||
└Code | Integer | 128 |
磁盘健康状态代码。 |
└Name | String | Impaired |
磁盘健康状态名称。 |
└InstanceId | String | i-instance1 |
实例ID。 |
└Status |
磁盘生命周期状态。 |
||
└Code | Integer | 129 |
磁盘生命周期状态代码。 |
└Name | String | Available |
磁盘生命周期状态名称。 |
PageNumber | Integer | 1 |
ECS实例列表页码。 |
PageSize | Integer | 10 |
每页大小。 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求 ID。 |
TotalCount | Integer | 2 |
ECS实例状态总个数。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeDisksFullStatus
&RegionId=cn-hangzhou
&DiskId.1=d-disk1
&EventId.1=e-event1
&Status=Available
&HealthStatus=Warning
&EventType=Stalled
&EventTime.Start=2018-05-06T02:43:10Z
&EventTime.End=2018-05-08T02:48:52Z
&PageNumber=1
&PageSize=10
&<公共请求参数>
正常返回示例
XML
格式
<DescribeDisksFullStatusResponse>
<DiskFullStatusSet>
<DiskFullStatusType>
<DiskEventSet>
<DiskEventType>
<EventId>e-event1</EventId>
<EventType>
<Code>7</Code>
<Name>Stalled</Name>
</EventType>
<EventTime>2018-05-08T02:43:10Z</EventTime>
</DiskEventType>
</DiskEventSet>
<DiskId>d-disk1</DiskId>
<InstanceId>i-instance1</InstanceId>
<Device>/dev/xvda</Device>
<HealthStatus>
<Code>128</Code>
<Name>Impaired</Name>
</HealthStatus>
<Status>
<Code>129</Code>
<Name>Available</Name>
</Status>
</DiskFullStatusType>
<DiskFullStatusType>
<DiskEventSet>
<DiskEventType>
<EventId>e-event2</EventId>
<EventType>
<Code>1</Code>
<Name>Degraded</Name>
</EventType>
<EventTime>2018-05-06T02:43:10Z</EventTime>
<EventEndTime>2018-05-06T02:48:52Z</EventEndTime>
</DiskEventType>
</DiskEventSet>
<DiskId>d-disk2</DiskId>
<InstanceId>i-instance2</InstanceId>
<Device>/dev/xvdb</Device>
<HealthStatus>
<Code>64</Code>
<Name>Warning</Name>
</HealthStatus>
<Status>
<Code>0</Code>
<Name>Ok</Name>
</Status>
</DiskFullStatusType>
</DiskFullStatusSet>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<RequestId>1A8B4B27-8B2D-XXXX-XXXX-0F64DBE4C211</RequestId>
<TotalCount>2</TotalCount>
</DescribeDisksFullStatusResponse>
JSON
格式
{
"PageNumber":1,
"TotalCount":2,
"PageSize":10,
"RequestId":"1A8B4B27-8B2D-XXXX-XXXX-0F64DBE4C211",
"DiskFullStatusSet":{
"DiskFullStatusType":[
{
"Status":{
"Name":"Available",
"Code":129
},
"Device":"/dev/xvda",
"HealthStatus":{
"Name":"Impaired",
"Code":128
},
"InstanceId":"i-instance1",
"DiskEventSet":{
"DiskEventType":[
{
"EventTime":"2018-05-08T02:43:10Z",
"EventId":"e-event1",
"EventType":{
"Name":"Stalled",
"Code":"7"
}
}
]
},
"DiskId":"d-disk1"
},
{
"Status":{
"Name":"Available",
"Code":129
},
"Device":"/dev/xvdb",
"HealthStatus":{
"Name":"Ok",
"Code":0
},
"InstanceId":"i-instance2",
"DiskEventSet":{
"DiskEventType":[
{
"EventTime":"2018-05-06T02:43:10Z",
"EventId":"e-event2",
"EventType":{
"Name":"Degraded",
"Code":"1"
},
"EventEndTime":"2018-05-06T02:48:52Z"
}
]
},
"DiskId":"d-disk2"
}
]
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | MissingParameter | %s | 缺失必需参数。 |
403 | InvalidParameter | %s | 参数格式不正确。 |
403 | DiskIdLimitExceeded | %s | 指定的DiskId个数不得超过100个。 |
403 | EventIdLimitExceeded | %s | 一次最多能指定100个模拟事件ID。 |
403 | InvalidParameter.TimeEndBeforeStart | %s | 结束时间不得早于开始时间。 |
查看本产品错误码
发布者:佚, 佚名,转转请注明出处:https://www.cms2.cn/aliyun/1871.html