通过阿里云CLI调用StopInstance API停止一台运行中的ECS实例。

背景信息

您可以调用StopInstance停止一台运行中(Running)的ECS实例,成功调用接口后,实例从停止中(Stopping)变成已停止(Stopped)状态。相关API文档请参见StopInstance

通过阿里云CLI调用API时,不同数据类型的请求参数取值必须遵循格式要求,详情请参见参数格式说明

接口说明

  • 安全控制的实例的OperationLocks中标记了"LockReason" : "security"的锁定状态时,不能停止实例。
  • 停止本地SSD型实例规格族:
    • 搭载了本地盘i1规格族实例,ConfirmStop为必选参数,取值为true后接口调用才会成功,否则会返回错误码。
    • 成功调用接口后,本地盘上的数据会被清空,您需要通过应用层的数据冗余保证数据可用性。
    • ECS自动忽略其他实例规格族的ConfirmStop请求参数。
  • 开通默认VPC内实例停机不收费功能后,您可以通过设置StoppedMode=KeepCharging保持停机收费,ECS实例停止后会继续计费,并为您保留ECS实例规格库存和公网IP地址。

CLI请求示例

  1. 调用DescribeInstances API查询您需要停止的ECS实例ID。

    本示例通过实例名称查询。

    aliyun ecs DescribeInstances --RegionId cn-hangzhou --InstanceName namedemo --Status Running --output cols=Instances.Instance[].InstanceId
    返回结果示例:
    Instances.Instance[].InstanceId
    -------------------------------
    [i-bp14a7xie8erwsvo****]
  2. 停止运行中的ECS实例。

    本示例中停止一台运行中的按量付费ECS实例i-bp14a7xie8erwsvo****,设置停止后继续计费,并且预检查后正常停止ECS实例。

    aliyun ecs StopInstance --InstanceId i-bp14a7xie8erwsvo**** --ForceStop false --StoppedMode KeepCharging --DryRun false

执行结果

{
        "RequestId": "A6344A79-D6CD-4AC2-8F2A-DEE3E16F8C5D"
}