You need to enable JavaScript to run this app.
Elastic Compute Service

Elastic Compute Service

Copy page
Download PDF
Monitoring
UpdateSystemEvents - Modifies system event statuses
Copy page
Download PDF
UpdateSystemEvents - Modifies system event statuses
Call the UpdateSystemEvents operation to modify system event status.​
Request description​
  • Only for "SystemMaintenance.Redeploy" event authorization, the OperatedStartAt and OperatedEndAt parameters can be used to change the maintenance time window.​
  • OperatedStartAt and OperatedEndAt parameters only support passing in the following time periods:​
  • Event occurrence time to event occurrence time + 12h​
  • Event occurrence time + 12h to 24h​
  • Event occurrence time + 24h to 36h​
  • Event occurrence time + 36h to 48h​
  • Event occurrence time + 48h to 60h​
  • Event occurrence time + 60h to 72h​
Debugging​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameters​
Only the request parameters specific to this operation and some common parameters are listed below. For more information, refer to Common parameters.​
Action string required Sample value: UpdateSystemEvents​
The action that you want to perform. Value: UpdateSystemEvents.​
​
Version string required Sample value: 2020-04-01​
The version of the API. Valid value: 2020-04-01.​
​
EventIds.N string[] required Sample value: EventIds.1=e-3ti9101aju3vj0****&EventIds.2=e-3tiegs1y963vj0****​
The event ID. A maximum of 100 event IDs are supported. You can use the event notification feature or call the DescribeSystemEvents operation to query and obtain the event ID.​
  • Argument - N: specifies the serial number of the event ID.​
  • Separate multiple event IDs with &.​
​
OperatedEndAt string Optional Sample value: 2022-09-02T15:11:46+08:00​
The end time of the event O&M time window. Default value: request receipt time + 72h. Format: RCF3339.​
tip​
Currently, you can change the O&M time only for a "SystemMaintenance.Redeploy" event. During event authorization, the parameter is required, and the parameter value cannot be earlier than the time specified for OperatedStartAt.​
​
OperatedStartAt string Optional Sample value: 2022-08-30T15:11:46+08:00​
The start time of the event O&M time window. Default value: request receipt time + 60h. Format: RCF3339.​
tip​
You can change the O&M time only for a "SystemMaintenance.Redeploy" event. During event authorization, the parameter is required, and the parameter value cannot be later than the time specified for OperatedEndAt.​
​
Status string required Sample value: Executing​
The system event status. Valid value:​
  • Executing: in progress​
​
UpdatedAt string Optional Sample value: 2021-06-28T18:29:38+08:00​
The event update time. Default value: the request receipt time. Format: RFC3339.​
​
​
​
Response parameters​
Only the response parameters specific to this operation are listed below. For more information, refer to Response structure.​
tip​
The following error codes for the operation are returned only when invalid values are specified for request parameters. If valid values are specified for the request parameters, no error code is displayed, and a status code of 200 is returned. However, this does not mean that the operation on all system events is successful. To view the operation result on one system event, see the information in the following response parameters.​
OperationDetails object[] Sample value: --​
The operation details.​
Error object Sample value: --​
The error information for the failure to modify an event status.​
Code string Sample value: InvalidSubscription.NotFound​
The error code for the failure of a specific individual request during batch operations. Value:​
  • InvalidSystemEvent.NotFound: The specified system event does not exist.​
  • InvalidSystemEventStatus.TypeMismatch: The event status does not match the event type.​
  • InvalidSystemEventStatus.PreStatusMismatch: The event status does not match the prior event status.​
tip​
Each Code corresponds to a Message in sequence.​
​
Message string Sample value: The specified subscription does not exist.​
The error information for the failure of a specific individual request during batch operations. Value:​
  • The specified system event does not exist.: The specified system event does not exist.​
  • The specified system event type does not match this status.: Status and event type do not match.​
  • The specified system event does not match pre-status.: The event status does not match the event prior status.​
​
​
EventId string Sample value: e-3tiegs1y963vj0******​
The system event ID.​
​
​
​
​
Sample request​
​
GET /?Action=UpdateSystemEvents&Version=2020-04-01&EventIds.1=t-3ti9101aju3vj0******&Status=Executing HTTP/1.1​
Host: ecs.cn-beijing.volcengineapi.com​
Region: cn-beijing​
ServiceName: ecs​
​
Sample response​
​
{​
"ResponseMetadata": {​
"RequestId": "202106111445100102252431000052****",​
"Action": "UpdateSystemEvents",​
"Version": "2020-04-01",​
"Service": "ecs",​
"Region": "cn-beijing"​
},​
"Result": {​
"OperationDetails": [​
{​
"EventId": "e-ybq95rphkoawmb******",​
"Error": {​
"Code": "InvalidSystemEvent.NotFound",​
"Message": "The specified system event does not exist."​
}​
}​
]​
}​
}​
​
Error codes​
The table below lists the business-related error codes of the operation. For more information, refer to Common error codes.​
​
Status code​
Error code​
Error message​
Description​
400​
InvalidOperatedEndAt.Malformed​
The specified OperatedEndAt is malformed.​
The specified value of OperatedEndAt is invalid.​
400​
InvalidOperatedStartAt.Malformed​
The specified OperatedStartAt is malformed.​
The specified value of OperatedStartAt is invalid.​
400​
InvalidStatus.Malformed​
The specified Status is malformed.​
The specified value of Status is invalid.​
400​
InvalidSystemEventStatus.PreStatusMismatch​
The specified system event does not match pre status.​
The specified system event does not match the event status.​
400​
InvalidSystemEventStatus.TypeMismatch​
The specified system event type does not match this status.​
The specified system event type does not match the event status.​
400​
InvalidUpdatedAt.Malformed​
The specified UpdatedAt is malformed.​
The specified value of UpdatedAt is invalid.​
400​
LimitExceeded.MaximumEventIds​
You've reached the limit on the number of EventIds that you can set.​
The specified number of event IDs exceeds the limit.​
400​
MissingParameter.EventIds​
The required parameter EventIds is not supplied.​
The event ID is not provided.​
400​
MissingParameter.Status​
The required parameter Status is not supplied.​
The parameter Status cannot be left empty.​
404​
InvalidActionOrVersion​
Could not find operation %s for version %s.​
The operation does not exist.​
500​
InternalError​
An internal error has occurred.​
An internal error occurred. Try again. If multiple attempts fail, submit a ticket.​
​
​
Last updated: 2026.06.18 17:48:24