更新时间：2025-12-10 GMT+08:00
修改云服务器定时删除时间 - UpdateServerAutoTerminateTime
功能介绍
修改按需云服务器，设置定时删除时间。如果设置的删除时间为空字符串，表示取消删除时间。
该接口支持企业项目细粒度权限的校验，具体细粒度请参见ecs:cloudServers:setAutoTerminateTime
调试
您可以在API Explorer中调试该接口。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
|
授权项 |
访问级别 |
资源类型（*为必须） |
条件键 |
别名 |
依赖的授权项 |
|---|---|---|---|---|---|
|
ecs:cloudServers:setAutoTerminateTime |
write |
instance * |
- |
- |
- |
URI
POST /v1/{project_id}/cloudservers/{server_id}/actions/update-auto-terminate-time
请求消息
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
auto_terminate_time |
是 |
String |
参数解释： 按需云服务器定时删除时间。 约束限制：
取值范围： 按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。 示例：2020-09-25T12:05:00Z 默认取值： 不涉及 |
响应消息
无
请求示例
- 设置云服务器的定时删除时间为“2020-09-25T12:05:00Z”。
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/actions/update-auto-terminate-time { "auto_terminate_time": "2020-09-25T12:05:00Z" } - 取消云服务器的定时删除。
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/actions/update-auto-terminate-time { "auto_terminate_time": "" }
响应示例
无
返回值
请参考通用请求返回值。
错误码
请参考错误码。
父主题： 状态管理
