DescribeInstancesFullStatus - 查询实例的全状态信息

调用DescribeInstancesFullStatus查询一台或多台ECS实例的全状态信息。全状态信息包括实例状态和实例系统事件状态,其中,实例状态为实例的生命周期状态,实例系统事件为维护事件的健康状态。

接口说明

返回结果包括实例状态和待执行(Scheduled)状态的实例系统事件。

如果指定一个时间段,则根据时间段筛选事件。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ecs:DescribeInstancesFullStatuslist
*全部资源
*

请求参数

名称类型必填描述示例值
RegionIdstring

实例所在地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
Statusstring

指定实例的生命周期状态。取值范围:

  • Starting:启动中。
  • Running:运行中。
  • Stopped:已停止。
Running
HealthStatusstring

指定实例的健康状态。取值范围:

  • OK:正常。
  • Impaired:服务损坏。
  • Initializing:初始化中。
  • InsufficientData:数据不足。
  • NotApplicable:不适用。

以上参数取值均区分大小写。

OK
EventTypestring

一个事件的类型。EventType 参数只在未指定 InstanceEventType.N 参数时有效。取值范围:

  • SystemMaintenance.Reboot:因系统维护实例重启。
  • SystemFailure.Reboot:因系统错误实例重启。
  • InstanceFailure.Reboot:因实例错误实例重启。
  • InstanceExpiration.Stop:因包年包月期限到期,实例停止。
  • InstanceExpiration.Delete:因包年包月期限到期,实例释放。
  • AccountUnbalanced.Stop:因账号欠费,按量付费实例停止。
  • AccountUnbalanced.Delete:因账号欠费,按量付费实例释放。
InstanceExpiration.Stop
NotBefore.Startstring

查询事件计划执行时间的开始时间。按照ISO 8601标准表示,并需要使用 UTC 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。

2017-12-07T00:00:00Z
NotBefore.Endstring

查询事件计划执行时间的结束时间。按照ISO 8601标准表示,并需要使用 UTC 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。

2017-11-30T00:00:00Z
EventPublishTime.Startstring

查询事件发布时间的开始时间。按照ISO 8601标准表示,并需要使用 UTC 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。

2017-11-30T00:00:00Z
EventPublishTime.Endstring

查询事件发布时间的结束时间。按照ISO 8601标准表示,并需要使用 UTC 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。

2017-12-07T00:00:00Z
PageNumberinteger

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

默认值:1。

1
PageSizeinteger

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

默认值:10。

10
InstanceIdarray

实例 ID 列表。可输入最大 100 个实例 ID。

string

实例 ID。

i-bp67acfmxazb4p****
EventIdarray

事件 ID 列表。可输入最多 100 个事件 ID。

string

事件 ID。

e-bp1hygp5b04o56l0****
InstanceEventTypearray

实例事件的类型列表。可输入最大 30 个实例事件的类型。

string

实例系统事件的类型。取值范围:

  • SystemMaintenance.Reboot:因系统维护实例重启。
  • SystemMaintenance.Redeploy:因系统维护实例重新部署。
  • SystemFailure.Reboot:因系统错误实例重启。
  • SystemFailure.Redeploy:因系统错误实例重新部署。
  • SystemFailure.Delete:因实例创建失败实例释放。
  • InstanceFailure.Reboot:因实例错误实例重启。
  • InstanceExpiration.Stop:因包年包月期限到期,实例停止。
  • InstanceExpiration.Delete:因包年包月期限到期,实例释放。
  • AccountUnbalanced.Stop:因账号欠费,按量付费实例停止。
  • AccountUnbalanced.Delete:因账号欠费,按量付费实例释放。
说明 事件类型说明请参见系统事件概述。该参数的取值只能是实例系统事件,不能是磁盘系统事件。
SystemMaintenance.Reboot

返回参数

名称类型描述示例值
object
PageSizeinteger

每页大小。

1
RequestIdstring

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
PageNumberinteger

页码。

1
TotalCountinteger

总条数。

2
InstanceFullStatusSetarray<object>

实例全状态数组。

说明 当实例不存在时该数据为空。
InstanceFullStatusTypeobject
InstanceIdstring

实例 ID。

i-bp67acfmxazb4p****
ScheduledSystemEventSetarray<object>

当前状态为 Scheduled 或 Inquiring 的系统事件数组。

ScheduledSystemEventTypeobject
EventPublishTimestring

事件的发布时间,使用 UTC+0 时间。

2017-11-30T06:32:31Z
EventIdstring

实例事件 ID。

e-bp1hygp5b04o56l0****
NotBeforestring

事件的计划执行时间,使用 UTC+0 时间。

2017-12-07T00:00:00Z
ImpactLevelstring

影响级别。

说明 不在白名单的用户,该参数为空。
100
Reasonstring

系统事件的计划原因。

说明 当阿里云没有判断出异常原因时,该参数为空。
A simulated event.
EventCycleStatusobject

事件状态。

Namestring

事件状态名称。

Scheduled
Codeinteger

事件状态代码。

24
EventTypeobject

事件类型。

Namestring

事件类型名称。

SystemMaintenance.Reboot
Codeinteger

事件类型代码。

1
ExtendedAttributeobject

本地盘实例系统事件拓展属性。

不同事件类型,返回值有所不同。

当事件类型不在以下列表中时,该数据为空。

  • SystemMaintenance.StopAndRepair
  • SystemMaintenance.CleanInactiveDisks
  • SecurityPunish.Locked
  • SecurityPunish.WebsiteBanned
  • SystemUpgrade.Migrate
  • SystemMaintenance.RebootAndIsolateErrorDisk
  • SystemMaintenance.RebootAndReInitErrorDisk
  • SystemMaintenance.ReInitErrorDisk
  • SystemMaintenance.IsolateErrorDisk
Devicestring

本地盘设备名。

/dev/vdb
DiskIdstring

本地盘磁盘 ID。

d-bp67acfmxazb4p****
InactiveDisksarray<object>

已释放但需要清理的非活跃云盘或本地盘信息。

InactiveDiskobject
CreationTimestring

云盘或本地盘的创建时间。按照ISO 8601标准表示,使用 UTC 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。

2018-07-27T13:53:25Z
DeviceSizestring

云盘或本地盘大小,单位 GiB。

80
DeviceCategorystring

云盘或本地盘种类。可能值:

  • cloud:普通云盘
  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD 盘
  • cloud_essd:ESSD 云盘
  • local_ssd_pro:I/O 密集型本地盘
  • local_hdd_pro:吞吐密集型本地盘
  • ephemeral:(已停售)本地盘
  • ephemeral_ssd:(已停售)本地 SSD 盘
cloud_ssd
DeviceTypestring

云盘或本地盘类型。可能值:

  • system:系统盘
  • data:数据盘
system
ReleaseTimestring

云盘或本地盘的释放时间。按照ISO 8601标准表示,使用 UTC 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。

2019-07-27T13:53:25Z
Statusobject

实例生命周期状态。

Namestring

实例生命周期状态名称。

Running
Codeinteger

实例生命周期状态代码。

1
HealthStatusobject

实例的健康状态。

Namestring

健康状态名称。

Warning
Codeinteger

健康状态代码。

64

示例

正常返回示例

JSON格式

{
  "PageSize": 1,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber": 1,
  "TotalCount": 2,
  "InstanceFullStatusSet": {
    "InstanceFullStatusType": [
      {
        "InstanceId": "i-bp67acfmxazb4p****",
        "ScheduledSystemEventSet": {
          "ScheduledSystemEventType": [
            {
              "EventPublishTime": "2017-11-30T06:32:31Z",
              "EventId": "e-bp1hygp5b04o56l0****",
              "NotBefore": "2017-12-07T00:00:00Z",
              "ImpactLevel": "100",
              "Reason": "A simulated event.",
              "EventCycleStatus": {
                "Name": "Scheduled",
                "Code": 24
              },
              "EventType": {
                "Name": "SystemMaintenance.Reboot",
                "Code": 1
              },
              "ExtendedAttribute": {
                "Device": "/dev/vdb",
                "DiskId": "d-bp67acfmxazb4p****",
                "InactiveDisks": {
                  "InactiveDisk": [
                    {
                      "CreationTime": "2018-07-27T13:53:25Z",
                      "DeviceSize": "80",
                      "DeviceCategory": "cloud_ssd",
                      "DeviceType": "system",
                      "ReleaseTime": "2019-07-27T13:53:25Z"
                    }
                  ]
                }
              }
            }
          ]
        },
        "Status": {
          "Name": "Running",
          "Code": 1
        },
        "HealthStatus": {
          "Name": "Warning",
          "Code": 64
        }
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
403InvalidParameter%s无效的参数。
403InvalidParameter.TimeEndBeforeStart%s您输入的参数无效,请确认结束时间是否早于开始时间。
403OperationDenied.NotInWhiteList%s该操作无效,请先加入白名单。
403InstanceIdLimitExceeded%s指定的 InstanceId 个数不能超过 100 个。
403EventIdLimitExceeded%s一次最多能指定100个模拟事件ID。
404MissingParameter%s缺失参数,请检查参数是否完整。

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

变更历史

变更时间变更内容概要操作
2024-12-03OpenAPI 错误码发生变更查看变更详情