停止云主机

接口说明

本接口用于停止一台云主机。
● 如果云主机存在状态为挂载中或卸载中的云硬盘,不支持停止操作。
● 云主机状态是运行中状态才可以做停止操作。

使用说明:
增加关机模式(stoppedMode),关机不收费功能目前仅上海、济南资源池开放。
● 关机不收费模式下,云主机计算资源(vCPU、内存)不再收费。
● 云主机关联的系统盘、云硬盘、弹性公网IP和带宽等绑定资源正常计费。
● 云主机计算资源(vCPU、内存)不再保留,当再次开机时,可能由于资源不足导致无法正常开机,请稍后尝试再次开机。


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/{serverId}/stop

请求参数

Path

参数名称
类型
必填
描述
serverId
string
是

云主机ID,可通过主机列表详情接口获取。

Query

参数名称
类型
必填
描述
stoppedMode
enum(KEEP_CHARGING,STOP_CHARGING)
否

关机模式:
KEEP_CHARGING(默认):关机继续收费
STOP_CHARGING:关机不收费

请求示例

PUT https://ecloud.10086.cn/api/openapi-ecs/acl/v3/server/{serverId}/stop

返回参数

返回码:200
OK
参数名称
类型
描述
body
object

请求成功时返回的数据

errorCode
string

统一错误码

errorMessage
string

页面国际化错误提示

errorParams
<string> array

统一错误码的自定义参数

requestId
string

每个请求的序列号

state
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)

返回状态码;返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN

返回示例

返回码:200
OK
{
	"requestId":"reqId-dbee5d97774f4b90f32c4-457e7370-1",
	"state":"OK",
	"body":null
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。