调用DescribeDisksFullStatus查询一块或多块块存储的全部状态信息。
接口说明
- 块存储的全部状态信息包含块存储生命周期(
Status
)、块存储健康状态(HealthStatus
)和块存储事件类型(EventType
)。 - 由于块存储相关事件的发布时间、事件的计划执行时间以及事件的实际执行时间相同,如果指定一段时间(
EventTime.Start
~EventTime.End
),则可以查询这段时间中发生过的所有历史事件。目前,您最多可以查询最近一周的历史事件。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDisksFullStatus |
系统规定参数。取值:DescribeDisksFullStatus |
RegionId | String | 是 | cn-hangzhou |
块存储所在地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
DiskId.N | RepeatList | 否 | d-bp67acfmxazb4p**** |
块存储ID。N的取值范围:1~100 |
EventId.N | RepeatList | 否 | e-bp67acfmxazb4p**** |
事件ID。N的取值范围:1~100 |
Status | String | 否 | Available |
指定块存储的生命周期状态,详情请参见云盘状态表。取值范围:
|
HealthStatus | String | 否 | Warning |
指定块存储的健康状态。取值范围:
|
EventType | String | 否 | Stalled |
指定块存储的事件类型。取值范围:
|
EventTime.Start | String | 否 | 2018-05-06T02:43:10Z |
查询事件发生时间的开始时间。 按照ISO8601标准表示,并使用UTC+0时间,格式为 |
EventTime.End | String | 否 | 2018-05-08T02:48:52Z |
查询事件发生时间的结束时间。 按照ISO8601标准表示,并使用UTC+0时间,格式为 |
PageNumber | Integer | 否 | 1 |
查询结果的页码。取值范围:正整数 默认值:1 |
PageSize | Integer | 否 | 10 |
查询结果的分页大小。取值范围:1~100 默认值:10 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DiskFullStatusSet | Array of DiskFullStatusType |
块存储全状态数组。 |
|
DiskFullStatusType | |||
Device | String | null |
块存储挂载于实例上的设备名,例如/dev/xvdb。 该参数仅在 说明 该参数即将停止使用,为提高代码兼容性,建议您尽量不要使用该参数。
|
DiskEventSet | Array of DiskEventType |
块存储事件数组。 |
|
DiskEventType | |||
EventEndTime | String | 2018-05-06T02:48:52Z |
事件结束时间。 |
EventId | String | e-bp67acfmxazb4p**** |
块存储事件ID。 |
EventTime | String | 2018-05-08T02:43:10Z |
事件发生时间。 |
EventType | Struct |
事件类型。 |
|
Code | Integer | 7 |
事件类型代码。 |
Name | String | Stalled |
事件类型名称。可能值:
|
ImpactLevel | String | 100 |
影响级别。 |
DiskId | String | d-bp67acfmxazb4p**** |
块存储ID。 |
HealthStatus | Struct |
块存储健康状态。 |
|
Code | Integer | 128 |
块存储健康状态代码。 |
Name | String | Impaired |
块存储健康状态名称。 |
InstanceId | String | i-bp67acfmxazb4p**** |
实例ID。 |
Status | Struct |
块存储生命周期状态。 |
|
Code | Integer | 129 |
块存储生命周期状态代码。 |
Name | String | Available |
块存储生命周期状态名称。 |
PageNumber | Integer | 1 |
列表页码。 |
PageSize | Integer | 10 |
每页大小。 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求ID。 |
TotalCount | Integer | 2 |
全状态总数。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeDisksFullStatus
&RegionId=cn-hangzhou
&DiskId.1=d-bp13pl2v34qj0xg0****
&EventId.1=e-uf64yvznlao4jl2c****
&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-bp67acfmxazb4p****</EventId>
<EventType>
<Code>7</Code>
<Name>Stalled</Name>
</EventType>
<EventTime>2018-05-08T02:43:10Z</EventTime>
</DiskEventType>
</DiskEventSet>
<DiskId>d-bp67acfmxazb4p****</DiskId>
<InstanceId>i-bp67acfmxazb4p****</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-bp67acfmxazb4p****</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
格式
{
"DiskFullStatusSet": {
"DiskFullStatusType": [
{
"DiskEventSet": {
"DiskEventType": [
{
"EventId": "e-bp67acfmxazb4p****",
"EventType": {
"Code": "7",
"Name": "Stalled"
},
"EventTime": "2018-05-08T02:43:10Z"
}
]
},
"DiskId": "d-bp67acfmxazb4p****",
"InstanceId": "i-bp67acfmxazb4p****",
"Device": "/dev/xvda",
"HealthStatus": {
"Code": 128,
"Name": "Impaired"
},
"Status": {
"Code": 129,
"Name": "Available"
}
},
{
"DiskEventSet": {
"DiskEventType": [
{
"EventId": "e-bp67acfmxazb4p****",
"EventType": {
"Code": "1",
"Name": "Degraded"
},
"EventTime": "2018-05-06T02:43:10Z",
"EventEndTime": "2018-05-06T02:48:52Z"
}
]
},
"DiskId": "d-disk2",
"InstanceId": "i-instance2",
"Device": "/dev/xvdb",
"HealthStatus": {
"Code": 0,
"Name": "Ok"
},
"Status": {
"Code": 129,
"Name": "Available"
}
}
]
},
"PageNumber": 1,
"PageSize": 10,
"RequestId": "1A8B4B27-8B2D-XXXX-XXXX-0F64DBE4C211",
"TotalCount": 2
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | MissingParameter | %s | 缺失参数,请检查参数是否完整。 |
403 | InvalidParameter | %s | 无效的参数。 |
403 | DiskIdLimitExceeded | %s | 指定的DiskId个数不能超过100个。 |
403 | EventIdLimitExceeded | %s | 一次最多能指定100个模拟事件ID。 |
403 | InvalidParameter.TimeEndBeforeStart | %s | 您输入的参数无效,请确认结束时间是否早于开始时间。 |
403 | OperationDenied.NotInWhiteList | %s | 该操作无效,请先加入白名单。 |
403 | TooManyDiskEvent.DiskIdRequired | %s | 对此资源ID的请求过多,请稍后重试。 |
访问错误中心查看更多错误码。