描述
停止运行一个指定的实例。
| 名称 | 类型 | 是否必须 | 描述 |
| Action | String | 是 | 系统规定参数。取值：StopInstance |
| InstanceId | String | 是 | 指定的实例 ID。 |
| ForceStop | String | 否 | 停止实例时的是否强制关机策略。取值范围：
|
| ConfirmStop | String | 否 | 是否确认关机。仅对 I1 型实例规格族生效，且为 I1 型的实例规格族的必须入参。取值范围：
|
| 错误代码 | 描述 | Http 状态码 | 语义 |
| InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 404 | 指定的 InstanceId 不存在。 |
| IncorrectInstanceStatus | The current status of the resource does not support this operation. | 403 | 该资源目前的状态不支持此操作。 |
| InstanceLockedForSecurity | The specified operation is denied as your instance is locked for security reasons. | 403 | 该资源目前被安全锁定被拒绝操作。 |
| DiskError | IncorrectDiskStatus | 403 | 不正常的磁盘状态。 |
| InstanceType. Parameter Mismatch | The input parameter ConfirmStop must be true when an instance have localstorage. | 403 | ConfirmStop 入参值不正确。 |
https://ecs.aliyuncs.com/?Action=StopInstance
&InstanceId=i-instance1
&<公共请求参数>
返回示例
XML格式
<StopInstanceResponse>
<RequestId>1C488B66-B819-4D14-8711-C4EAAA13AC01</RequestId>
</StopInstanceResponse>
JSON格式
{
"RequestId": "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
根据您的描述，您想要了解如何使用阿里云ECS（Elastic Compute Service）API来停止一个指定的实例。下面是对这个过程的一个概括和指导：
您可以通过调用阿里云ECS API中的StopInstance操作来停止一个正在运行的ECS实例。此操作允许您选择是否强制停止以及对于特定类型的实例（如I1规格族），确认数据将会被清空。
StopInstance，这是执行停止实例操作的标识。false，即正常关机流程；如果设为true，则相当于直接断电，可能会导致未保存的数据丢失。true以确认本地存储上的数据将被清空。其他规格的实例此参数会被系统忽略。InvalidInstanceId.NotFound、IncorrectInstanceStatus、InstanceLockedForSecurity、DiskErrorIncorrectDiskStatus、InstanceType.ParameterMismatch等，分别对应不同的错误情况，比如实例不存在、实例状态不支持此操作、实例因安全原因被锁定、磁盘状态异常、参数不匹配等。https://ecs.aliyuncs.com/?Action=StopInstance
&InstanceId=i-instanceid
&ForceStop=false
&ConfirmStop=true
&<公共请求参数>
请替换i-instanceid为您实际要停止的实例ID，并根据需要调整ForceStop和ConfirmStop的值。同时，不要忘记添加阿里云API调用所需的公共请求参数，例如AccessKeyId、Signature、Timestamp等，确保请求能够通过身份验证和授权。
在实际应用中，您可能需要使用SDK（如Python SDK、Java SDK等）或者命令行工具（如aliyuncli）来构造和发送这些API请求，这样可以更方便地管理访问密钥和签名过程。您也可以通过ECS一键诊断全面排查并修复ECS问题。
