云服务器 ECS：StopInstance - 停止实例

指定的实例 ID。

该参数即将被弃用，为提高兼容性暂作保留。您在调用该接口时请忽略该参数。

停止实例时的是否强制关机策略。取值范围：

• true：强制关机。相当于典型的断电操作，所有未写入存储设备的缓存数据会丢失。

• false：正常关机流程。

默认值为 false。

停止按量付费 ECS 实例时，设置的停止模式。取值：

• StopCharging：节省停机模式。开启节省停机模式后：

  • 计算资源(vCPU、内存、GPU)、镜像 License 费用、固定公网 IP 的固定带宽模式暂停计费。

  • 系统盘、数据盘、弹性公网 IP 的固定带宽模式持续计费。

  • 由于计算资源被回收，启动时可能因库存不足导致启动失败，请您稍后再试或更换实例规格。

  • 如果实例停止前绑定了弹性公网 IP 地址，重启后 IP 地址不变；否则，固定公网 IP 地址可能会变，但私网 IP 地址不会变。

  更多信息，请参见节省停机模式。

  重要 如实例自身不支持节省停机模式，API 侧不会进行报错拦截，优先保证实例停机。不支持节省停机的实例类型：本地盘实例、包年包月实例等。

• KeepCharging：普通停机模式。实例停止后仍继续收费。

默认值：如果您在 ECS 控制台上开启 VPC 内实例节省停机模式（更多信息，请参见打开默认启用节省停机模式），并符合开启条件，则默认值为StopCharging。否则，默认值为KeepCharging。

是否只预检此次请求。取值范围：

• true：发送检查请求，不会停止实例。检查项包括是否填写了必选参数、请求格式、业务限制和 ECS 库存。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码DryRunOperation。

• false：发送正常请求，通过检查后直接停止实例。

默认值为 false。