调用DescribeDisksFullStatus查询一块或多块块存储的全部状态信息。

接口说明

  • 块存储的全部状态信息包含块存储生命周期(Status)、块存储健康状态(HealthStatus)和块存储事件类型(EventType)。
  • 由于块存储相关事件的发布时间、事件的计划执行时间以及事件的实际执行时间相同,如果指定一段时间(EventTime.Start~EventTime.End),则可以查询这段时间中发生过的所有历史事件。目前,您最多可以查询最近一周的历史事件。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
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 +0时间,格式为yyyy-MM-ddTHH:mm:ssZ。

EventTime.Start String 2018-05-06T02:43:10Z

查询事件发生时间的开始时间。按照ISO8601标准表示,并使用UTC +0时间,格式为yyyy-MM-ddTHH:mm:ssZ。

EventType String Stalled

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

  • Degraded:块存储性能降级
  • SeverelyDegraded:块存储性能严重降级
  • Stalled:块存储性能受到严重影响
HealthStatus String Warning

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

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

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

默认值:1

PageSize Integer 10

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

默认值:10

Status String Available

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

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

返回数据

名称 类型 示例值 描述
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

实例总个数。

示例

请求示例

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 结束时间不得早于开始时间。
403 OperationDenied.NotInWhiteList %s 无权限执行此操作。
403 TooManyDiskEvent.DiskIdRequired %s 磁盘事件过多,请指定DiskId进行查询。

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