功能介绍

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

该接口支持企业项目细粒度权限的校验，具体细粒度请参见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	云服务器定时删除时间。 按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。 如果秒（ss）取值不是 00，则自动取为当前分钟（mm）开始时。 最短定时删除时间为当前时间半小时之后。 最长定时删除时间不能超过当前时间三年。 如果参数auto_terminate_time为空字符串，表示不设置定时删除或取消定时删除。 示例：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": "",
}

响应示例

无

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 状态管理

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家