接口说明
本接口用于停止一台云主机。
● 如果云主机存在状态为挂载中或卸载中的云硬盘,不支持停止操作。
● 云主机状态是运行中状态才可以做停止操作。
使用说明:
增加关机模式(stoppedMode),关机不收费功能目前仅上海、济南资源池开放。
● 关机不收费模式下,云主机计算资源(vCPU、内存)不再收费。
● 云主机关联的系统盘、云硬盘、弹性公网IP和带宽等绑定资源正常计费。
● 云主机计算资源(vCPU、内存)不再保留,当再次开机时,可能由于资源不足导致无法正常开机,请稍后尝试再次开机。
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)
|
否
|
关机模式: |
请求示例
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
}