九游平台/ 弹性云服务器 ecs/ api参考/ api/ 状态管理/ 修改云服务器定时删除时间
更新时间：2024-06-12 gmt 08:00
查看pdf

修改云服务器定时删除时间-九游平台

功能介绍

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

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

调试

您可以在中调试该接口。

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

响应示例

无

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 状态管理

相关文档

网站地图