文档首页/ 弹性云服务器 ECS/ API参考/ API/ 计划事件/ 查询计划事件列表
更新时间：2025-08-20 GMT+08:00
查看PDF
分享

查询计划事件列表

功能介绍

获取实例的事件列表。

URI

GET /v3/{project_id}/instance-scheduled-events

参数说明请参见表1。

表1 路径参数

参数

是否必选

描述

project_id

是

项目ID。

获取方法请参见获取项目ID。
表2 查询参数

参数

是否必选

参数类型

描述

limit

否

Integer

查询返回实例事件的数量限制。

取值范围：1-100

marker

否

String

取值为上一页数据的最后一条记录的唯一标识。

id

否

String

实例事件ID。

instance_id

否

String

实例ID

type

否

Array of strings

实例事件类型

state

否

Array of string

实例事件状态

publish_since

否

String

事件发布开始时间，按照时间范围过滤。

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

publish_until

否

String

事件发布结束时间，按照时间范围过滤。

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

请求消息

无

响应消息

响应参数如表3所示。

表3 响应参数

参数

参数类型

描述

events

Array of objects

实例事件列表，详情请参见表4。

page_info

Object

页标记，详情请参见表5。
表4 events参数信息

参数

参数类型

描述

id

String

事件ID。

type

String

事件类型。

state

String

事件状态。

  • 待授权（inquiring）：需要用户对事件操作进行授权， 授权时支持指定开始时间， 系统将会在一定时间内完成操作，详细内容请参见响应事件。
  • 待执行（scheduled）：等待系统资源调度中。
  • 执行中（executing）：系统已完成资源调度， 正在修复中。
  • 执行成功（completed）：系统已完成事件执行。 请验证业务受损情况， 如遇异常，请联系技术支持。
  • 执行失败（failed）：系统自动修复失败。
  • 取消（canceled）：该事件已被系统取消。

publish_time

String

事件发布时间。

start_time

String

事件开始时间。

finish_time

String

事件完成时间。

not_before

String

事件计划执行开始时间。

not_after

String

事件计划执行完成时间。

not_before_deadline

String

事件计划执行开始截止时间。

description

String

事件描述。

instance_id

String

实例ID。
表5 page_info参数信息

参数

参数类型

描述

next_marker

String

返回下一页查询地址。

请求示例

查询计划事件列表。

GET https://{endpoint}/v3/{project_id}/instance-scheduled-events?state=inquiring,scheduled,executing&limit=1

响应示例

{
    "events": [
        {
            "id": "0ead944a-72e8-494f-89ba-5846fb7ac5c0",
            "type": "instance-redeploy",
            "state": "scheduled",
            "publish_time": "2025-03-13T12:55:36Z",
            "start_time": null,
            "finish_time": null,
            "not_before": "2025-03-21T09:22:41Z",
            "not_after": "2025-03-21T11:22:41Z",
            "not_before_deadline": "2025-03-21T09:22:41Z",
            "description": "{\"en-us\":\"As being affected by underlying hardware or system OM, ECSs will be redeployed on new hosts\"}",
            "instance_id": "c51b9e4f-0469-4c6f-ad03-22b23247b7a8"
        }
    ],
    "page_info": {
        "next_marker": "0ead944a-72e8-494f-89ba-5846fb7ac5c0"
    }
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 计划事件