文档首页/ 弹性云服务器 ECS/ API参考/ API/ 状态管理/ 修改云服务器定时删除时间
更新时间：2025-07-23 GMT+08:00
编辑
查看PDF
分享

修改云服务器定时删除时间

功能介绍

修改按需云服务器，设置定时删除时间。如果设置的删除时间为空字符串，表示取消删除时间。

该接口支持企业项目细粒度权限的校验，具体细粒度请参见ecs:cloudServers:setAutoTerminateTime

调试

您可以在API Explorer中调试该接口。

URI

POST /v1/{project_id}/cloudservers/{server_id}/actions/update-auto-terminate-time

参数说明请参见表1。
表1 参数说明

参数

是否必选

描述

project_id

是

项目ID。

获取方法请参见获取项目ID。

server_id

是

云服务器ID

请求消息

表2 请求参数

参数

是否必选

参数类型

描述

auto_terminate_time

是

String

参数解释：

按需云服务器定时删除时间。

约束限制：

  • 如果秒（ss）取值不是 00，则自动取为当前分钟（mm）开始时。
  • 最短定时删除时间为当前时间半小时之后。
  • 最长定时删除时间不能超过当前时间三年。
  • 如果参数auto_terminate_time为空字符串，表示不设置定时删除或取消定时删除。

取值范围：

按照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": "",
}

响应示例

无

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 状态管理

相关文档