DescribeDisksFullStatus - 查询一块或多块块存储的全部状态信息 - 云服务器 ECS

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

接口说明

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ecs:DescribeDisksFullStatus

list

Disk

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

Disk

acs:ecs:{#regionId}:{#accountId}:disk/*

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	块存储所在地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
RegionId	string	是	块存储所在地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
Status	string	否	指定块存储的生命周期状态，详情请参见云盘状态表。取值范围： In_use：使用中。 Available：待挂载。 Attaching：挂载中。 Detaching：卸载中。 Creating：创建中。 ReIniting：初始化中。	Available
HealthStatus	string	否	指定块存储的健康状态。取值范围： Impaired：暂时性不可读写。 Warning：服务降级。 Initializing：初始化中。 InsufficientData：数据不足。 NotApplicable：不适用。	Warning
EventType	string	否	指定块存储的事件类型。取值范围： Degraded：块存储性能降级。 SeverelyDegraded：块存储性能严重降级。 Stalled：块存储性能受到严重影响。 ErrorDetected：本地盘出现损坏。	Stalled
EventTime.Start	string	否	查询事件发生时间的开始时间。按照 ISO8601 标准表示，并使用 UTC+0 时间，格式为`yyyy-MM-ddTHH:mm:ssZ`。	2018-05-06T02:43:10Z
EventTime.End	string	否	查询事件发生时间的结束时间。按照 ISO8601 标准表示，并使用 UTC+0 时间，格式为`yyyy-MM-ddTHH:mm:ssZ`。	2018-05-08T02:48:52Z
PageNumber	integer	否	查询结果的页码。取值范围：正整数。默认值：1 。	1
PageSize	integer	否	查询结果的分页大小。取值范围：1~100。默认值：10 。	10
DiskId	array	否	块存储 ID。N 的取值范围：1~100。	d-bp67acfmxazb4p****
	string	否	块存储 ID。N 的取值范围：1~100。	d-bp67acfmxazb4p****
EventId	array	否	事件 ID。N 的取值范围：1~100。	e-bp67acfmxazb4p****
	string	否	事件 ID。N 的取值范围：1~100。	e-bp67acfmxazb4p****
ResourceGroupId	string	否	块存储资源所属的资源组 ID。使用该参数过滤资源时，资源数量不能超过 1000 个。	rg-aek2kkmhmhs****
Tag	array<object>	否	标签列表。
	object	否	标签列表。
Key	string	否	块存储资源绑定的标签键。N 表示可以设置一个或多个标签键，且 N 的数值和`Tag.N.Value`参数中的 N 对应，构成键值对。N 的取值范围：1~20。使用一个标签过滤资源，查询到该标签下的资源数量不能超过 1000 个；使用多个标签过滤资源，查询到同时绑定了多个标签的资源数量不能超过 1000 个。	TestKey
Value	string	否	块存储资源绑定的标签值。N 表示可以设置一个或多个标签值，且 N 的数值和`Tag.N.Key`参数中的 N 对应，构成键值对。N 的取值范围：1~20。	TestValue

返回参数

名称	类型	描述	示例值
	object
PageSize	integer	每页大小。	10
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PageNumber	integer	列表页码。	1
TotalCount	integer	全状态总数。	2
DiskFullStatusSet	object
DiskFullStatusType	array<object>	块存储全状态数组。
	array<object>
DiskId	string	块存储 ID。	d-bp67acfmxazb4p****
InstanceId	string	实例 ID。	i-bp67acfmxazb4p****
Device	string	块存储挂载于实例上的设备名，例如/dev/xvdb。该参数仅在`Status`参数值为`In_use`时有值，其他状态时为空。说明该参数即将停止使用，为提高代码兼容性，建议您尽量不要使用该参数。	null
DiskEventSet	object
DiskEventType	array<object>	块存储事件数组。
	array<object>
EventId	string	块存储事件 ID。	e-bp67acfmxazb4p****
EventEndTime	string	事件结束时间。	2018-05-06T02:48:52Z
EventTime	string	事件发生时间。	2018-05-08T02:43:10Z
ImpactLevel	string	影响级别。	100
EventType	object	事件类型。
Name	string	事件类型名称。可能值： Degraded：块存储性能降级。 SeverelyDegraded：块存储性能严重降级。 Stalled：块存储性能受到严重影响。 ErrorDetected：本地盘出现损坏。	Stalled
Code	integer	事件类型代码。	7
Status	object	块存储生命周期状态。
Name	string	块存储生命周期状态名称。	Available
Code	integer	块存储生命周期状态代码。	129
HealthStatus	object	块存储健康状态。
Name	string	块存储健康状态名称。	Impaired
Code	integer	块存储健康状态代码。	128

示例

正常返回示例

JSON格式

{
  "PageSize": 10,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber": 1,
  "TotalCount": 2,
  "DiskFullStatusSet": {
    "DiskFullStatusType": [
      {
        "DiskId": "d-bp67acfmxazb4p****",
        "InstanceId": "i-bp67acfmxazb4p****",
        "Device": "null",
        "DiskEventSet": {
          "DiskEventType": [
            {
              "EventId": "e-bp67acfmxazb4p****",
              "EventEndTime": "2018-05-06T02:48:52Z",
              "EventTime": "2018-05-08T02:43:10Z",
              "ImpactLevel": "100",
              "EventType": {
                "Name": "Stalled",
                "Code": 7
              }
            }
          ]
        },
        "Status": {
          "Name": "Available",
          "Code": 129
        },
        "HealthStatus": {
          "Name": "Impaired",
          "Code": 128
        }
      }
    ]
  }
}

异常返回示例

JSON格式

{
    "DiskFullStatusSet": {
        "DiskFullStatusType": [
            {
                "DiskEventSet": {
                    "DiskEventType": [
                        {
                            "EventId": "e-event1",
                            "EventType": {
                                "Code": "7",
                                "Name": "Stalled"
                            },
                            "EventTime": "2018-05-08T02:43:10Z"
                        }
                    ]
                },
                "DiskId": "d-disk1",
                "InstanceId": "i-instance1",
                "Device": "/dev/xvda",
                "HealthStatus": {
                    "Code": 128,
                    "Name": "Impaired"
                },
                "Status": {
                    "Code": 129,
                    "Name": "Available"
                }
            },
            {
                "DiskEventSet": {
                    "DiskEventType": [
                        {
                            "EventId": "e-event2",
                            "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
}

错误码

HTTP status code	错误码	错误信息	描述
403	InvalidParameter	%s
403	DiskIdLimitExceeded	%s	指定的 DiskId 个数不能超过 100 个。
403	EventIdLimitExceeded	%s
403	InvalidParameter.TimeEndBeforeStart	%s	您输入的参数无效，请确认结束时间是否早于开始时间。
403	OperationDenied.NotInWhiteList	%s	该操作无效，请先加入白名单。
403	TooManyDiskEvent.DiskIdRequired	%s	对此资源 ID 的请求过多，请稍后重试。
404	MissingParameter	%s

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

变更历史

更多信息，参考变更详情。