调用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

指定块存储的生命周期状态,详情请参见云盘状态表。取值范围:

  • In_use:使用中
  • Available:待挂载
  • Attaching:挂载中
  • Detaching:卸载中
  • Creating:创建中
  • ReIniting:初始化中
HealthStatus String Warning

指定块存储的健康状态。取值范围:

  • Impaired:暂时性不可读写
  • Warning:服务降级
  • Initializing:初始化中
  • InsufficientData:数据不足
  • NotApplicable:不适用
EventType String Stalled

指定块存储的事件类型。取值范围:

  • Degraded:块存储性能降级。
  • SeverelyDegraded:块存储性能严重降级。
  • Stalled:块存储性能受到严重影响。
EventTime.Start String 2018-05-06T02:43:10Z

查询事件发生时间的开始时间。

按照ISO8601标准表示,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ

EventTime.End String 2018-05-08T02:48:52Z

查询事件发生时间的结束时间。

按照ISO8601标准表示,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ

PageNumber Integer 1

查询结果的页码。取值范围:正整数

默认值:1

PageSize Integer 10

查询结果的分页大小。取值范围:1~100

默认值:10

返回数据

名称 类型 示例值 描述
DiskFullStatusSet Array of DiskFullStatusType

块存储全状态数组。

DiskFullStatusType
Device String null

块存储挂载于实例上的设备名,例如/dev/xvdb。

该参数仅在Status参数值为In_use时有值,其他状态时为空。

说明 该参数即将停止使用,为提高代码兼容性,建议您尽量不要使用该参数。
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的请求过多,请稍后重试。

访问错误中心查看更多错误码。