You need to enable JavaScript to run this app.
文档中心
云服务器

云服务器

复制全文
下载 pdf
监控
DescribeSystemEvents - 查询系统事件列表
复制全文
下载 pdf
DescribeSystemEvents - 查询系统事件列表
调用 DescribeSystemEvents 接口,查询实例的系统事件信息。​
使用说明​
操作说明和注意事项请参见查询并处理事件。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:DescribeSystemEvents​
要执行的操作,取值:DescribeSystemEvents。​
​
Version string 必选 示例值:2020-04-01​
API的版本,取值:2020-04-01。​
​
Category string 可选 示例值:ResourceEvent​
系统事件类别。取值:​
  • ResourceEvent:资源事件​
  • TaskEvent:任务事件​
​
CreatedAtEnd string 可选 示例值:2021-06-29T18:11:46+08:00​
以CreatedAtEnd为终点,筛选创建时间在其之前的事件。默认值为现在,格式为RFC3339。​
​
CreatedAtStart string 可选 示例值:2021-06-28T18:29:38+08:00​
以CreatedAtStart为起点,筛选创建时间在其之后的事件。默认值为CreatedAtEnd前24小时(参考请求参数CreatedAtEnd),格式为RFC3339。​
​
EventIds.N string[] 可选 示例值:EventIds.1=e-3ti9101aju3vj0******&EventIds.2=e-r4911sfaa9ts******​
事件ID,最多支持100个ID。您可以通过事件通知或调用本接口查询获取。​
  • 参数 - N:表示事件的序号。​
  • 多个事件ID之间用&分隔。​
​
MaxResults integer 可选 示例值:20​
分页查询时设置的每页行数:​
  • 最大值:100​
  • 最小值:0​
  • 默认值:20​
​
NextToken string 可选 示例值:--​
分页查询凭证,用于标记分页的位置,初次调用该接口时无需设置。下次查询时,取值为上一次API调用返回的NextToken参数值。​
​
ResourceIds.N string[] 可选 示例值:ResourceIds.1=i-3ti9101aju3vj0******&ResourceIds.2=i-tws01a56ydh0******​
资源ID,最多支持100个ID。您可以调用DescribeInstances接口,查询获取实例ID。​
  • 参数 - N:表示资源的序号。​
  • 多个资源ID之间用&分隔。​
说明​
当前支持的资源类型为ECS实例。​
​
Status.N string[] 可选 示例值: Status.1=Executing&Status.2=Inquiring​
系统事件的状态,最多支持10个。​
  • 参数 - N:表示事件类型的序号。​
  • 多个事件类型之间用&分隔。​
  • 取值:​
  • UnknownStatus:未知状态​
  • Executing:执行中​
  • Succeeded:执行成功​
  • Failed:执行失败​
  • Inquiring:待响应​
  • Scheduled:计划执行​
  • Rejected:用户拒绝执行​
  • Canceled:已取消​
  • Pending:已暂停​
  • Recovered:已恢复​
​
Types.N string[] 可选 示例值:Types.1=SystemFailure_Reboot&Types.2=DiskError_Redeploy​
系统事件的类型,最多支持100个。​
  • 参数 - N:表示事件类型的序号。​
  • 多个事件类型之间用&分隔。​
  • 取值:​
  • SystemFailure_Stop:因系统故障实例停止。​
  • SystemFailure_Reboot:因系统故障实例重启。​
  • DiskError_Redeploy:因硬盘异常实例重新部署。​
  • GpuError_Redeploy:GPU异常,导致实例重新部署。​
  • SystemMaintenance_Redeploy:因系统维护实例重新部署。​
  • SystemMaintenance_StopAndRepair:实例停止,系统维修。​
  • SystemFailure_Redeploy:因系统故障实例重新部署。​
  • SystemFailure_Repair:系统故障,进行维修。​
  • CreateInstance:创建实例。​
  • RunInstance:启动实例。​
  • StopInstance:停止实例。​
  • DeleteInstance:删除实例。​
  • SpotInstanceInterruption_Delete:抢占型实例中断,实例释放。​
  • AccountUnbalanced_Stop:账户欠费,实例停止。​
  • AccountUnbalanced_Delete:账户欠费,实例释放。​
  • InstanceChargeType_Change:实例计费类型改变。​
  • InstanceConfiguration_Change:实例配置变更。​
  • FileSystemReadOnly_Change:文件系统变为只读状态。​
  • RebootInstance:实例重启。​
  • InstanceFailure:因操作系统错误实例异常。​
  • ApplicationFailure:应用异常。​
  • DeploymentSet_Modify:修改实例部署集。​
  • ServerMigrationTask:服务器迁移任务。​
  • ServerMigration_FirstSync:服务器迁移,全量数据同步。​
  • ServerMigration_AdditionalSync:服务器迁移,增量数据同步。​
  • GpuRiskDetected:GPU运行存在风险。​
  • ElasticScheduledInstance_Create:弹性预约单创建。​
  • ElasticScheduledInstance_Cancel:弹性预约单取消。​
  • ElasticScheduledInstance_Deliver:弹性预约单交付。​
  • ElasticScheduledInstance_AutoRelease:弹性预约实例自动释放。​
  • ElasticScheduledInstance_Invalid:弹性预约单失效。​
  • InfrastructureUpgrade_Redeploy:因基础设施升级实例重新部署。​
  • DiskErrorDetected:硬盘异常。​
  • DiskError_ReplaceDisk:因硬盘异常更换硬盘。​
  • InstanceOOM:实例内存OOM。​
  • MemoryRiskDetected:内存运行存在风险。​
  • InstanceFileSystemFailure_StopAndRepair:因文件系统异常实例停机修复。​
  • InstanceDiskStalled:因云盘性能受损实例异常。​
  • SystemMaintenance_ReserveAndRepair:因系统维护实例停机维修。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
NextToken string 示例值:bHpwdXJja2RxemU1eG5sb3NzdGcW1-RC******​
本次调用返回的查询凭证值,返回为空表示该页为末页。​
​
SystemEvents object[] 示例值:--​
实例系统事件信息。​
Category string 示例值:ResourceEvent​
事件类别。​
​
CreatedAt string 示例值:2022-08-29T18:11:46+08:00​
系统事件创建时间。​
​
ExtraInfo object 示例值:{"VolumeId": "vol-3tiegs1y963vj***","Serial": "ysw2flxa****"}​
系统事件的扩展信息。​
​
Id string 示例值:e-3tiegs1y963vj0******​
系统事件ID。​
​
ImpactLevel string 示例值:Info-信息​
系统事件的影响等级。取值:​
  • Critical-严重​
  • Warning-警告​
  • Info-信息​
​
OperatedEndAt string 示例值:2022-08-30T15:11:46+08:00​
运维时间窗口结束时间。​
​
OperatedStartAt string 示例值:2022-09-10T18:11:46+08:00​
运维时间窗口的起始时间。​
​
ResourceId string 示例值:i-3tiegs1y963vj0******​
资源ID。​
​
Status string 示例值:Execting​
系统事件的状态。​
​
Type string 示例值:SystemFailure_Stop​
系统事件的类型。​
​
UpdatedAt string 示例值:2022-08-30T18:11:46+08:00​
系统事件更新时间。​
​
​
​
​
请求示例​
​
GET /?Action=DescribeSystemEvents&Version=2020-04-01&EventIds.1=e-3ti9101aju3vj0****** HTTP/1.1​
Host: ecs.cn-beijing.volcengineapi.com​
Region: cn-beijing​
ServiceName: ecs​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202106111445100102252431000052****",​
"Action": "DescribeSystemEvents",​
"Version": "2020-04-01",​
"Service": "ecs",​
"Region": "cn-beijing"​
},​
"Result": {​
"SystemEvents": [​
{​
"Id": "e-3ti9101aju3vj0******",​
"Category": "ResourceEvent",​
"CreatedAt": "2022-06-15T16:34:34+08:00",​
"UpdatedAt": "2022-06-15T16:34:49+08:00",​
"ResourceId": "i-3ti9101aju3vj0******",​
"Type": "DiskError_Redeploy",​
"Status": "Succeeded",​
"OperatedStartAt": "2022-08-30T15:11:46+08:00",​
"OperatedEndAt": "2022-09-10T18:11:46+08:00",​
"ExtraInfo": {​
"Serial": "ysw2flxa****",​
"VolumeId": "vol-3tiegs1y963vj0******"​
}​
}​
],​
"NextToken": ""​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidCategory.Malformed​
The specified Category is malformed.​
指定的Category不合法。​
400​
InvalidCreatedAtEnd.Malformed​
The specified CreatedAtEnd is malformed.​
指定的创建结束时间不合法。​
400​
InvalidCreatedAtStart.Malformed​
The specified CreatedAtStart is malformed.​
指定的创建开始时间不合法。​
400​
InvalidResourceIds.Malformed​
The specified ResourceIds is malformed.​
指定的ResourceIds不合法。​
400​
InvalidStatus.Malformed​
The specified Status is malformed.​
指定的Status不合法。​
400​
InvalidTypes.Malformed​
The specified Types is malformed.​
指定的Types不合法。​
400​
LimitExceeded.MaximumEventIds​
You've reached the limit on the number of EventIds that you can set.​
指定的事件ID数量超过限制。​
400​
LimitExceeded.MaximumMaxResults​
The number of specified MaxResults exceeds the maximum limit.​
指定的MaxResults超过最大限制。​
400​
LimitExceeded.MaximumResourceIds​
You've reached the limit on the number of ResourceIds that you can set.​
指定的资源ID数量超过限制。​
400​
LimitExceeded.MaximumStatus​
You've reached the limit on the number of Status that you can set.​
指定的状态数量超过限制。​
400​
LimitExceeded.MaximumTypes​
You've reached the limit on the number of Types that you can set.​
指定的类型数量超过限制。​
400​
LimitExceeded.MinimumMaxResults​
The number of specified MaxResults exceeds the minimum limit.​
指定的MaxResults超过最小限制。​
404​
InvalidActionOrVersion​
Could not find operation %s for version %s.​
请求接口不存在。​
500​
InternalError​
An internal error has occurred.​
内部错误,请重试。如果多次尝试失败,请提交工单。​
​
​
最近更新时间:2025.11.12 11:27:12
这个页面对您有帮助吗?
有用
有用
无用
无用