云服务器 ECS：StopInstances - 批量停止实例

是否发送预检请求。取值范围：

• true：发送检查请求，不会停止实例。检查项包括是否填写了必需参数、请求格式、实例状态。如果检查不通过，则返回对应错误。如果检查通过，则返回DRYRUN.SUCCESS。

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

默认值：false。

实例所在的地域。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

是否强制关机。取值范围：

• true：强制关机。
  警告 强制停止等同于断电处理，可能丢失实例操作系统中未写入磁盘的数据，请谨慎选择。

• false：正常关机。

默认值：false。

停止模式。取值：

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

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

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

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

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

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

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

• KeepCharging：普通停机模式。停止实例后保留实例的资源并继续收费，并为您保留 ECS 实例规格库存和公网 IP 地址。如果您停止实例是为了更换操作系统、重新初始化云盘、更改实例规格、修改私网 IP 等操作，建议您选择该模式，以避免启动失败。

默认值：如果您开启 VPC 内实例节省停机模式并符合开启条件，则默认值为StopCharging；否则，默认值为KeepCharging。

设置批量操作模式。取值范围：

• AllTogether：所有操作必须全部成功才能确认整个批量操作的成功。如果任何一个操作失败，整个批量操作都会被视为失败，所有已执行的操作都会被回滚，恢复到操作前的状态。

• SuccessFirst：允许批量操作中的每个操作独立执行。如果某个操作失败，其他操作仍然可以继续执行并确认成功。这种模式下，成功的操作会被提交，失败的操作会被标记为失败，但不会影响其他操作的执行结果。

默认值：AllTogether。