Stops an Elastic Compute Service (ECS) instance in the Running state. After you call this operation, the state of the instance changes to Stopping and then to Stopped.
Operation description
- If you call the DescribeInstances operation to query the details of an instance and
OperationLocks
in the response contains"LockReason": "security"
, the instance is locked for security reasons and cannot be stopped. For more information, see API behavior when an instance is locked for security reasons. - If the economical mode is enabled, you can set
StoppedMode
to KeepCharging to switch to the standard mode. This allows an instance that is stopped in standard mode to retain its instance type resources and public IP address. However, you continue to be charged for the instance.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
InstanceId | string | Yes | The ID of the instance. | i-bp67acfmxazb4ph**** |
ConfirmStop | boolean | No | This parameter will be removed in the future and is retained only to ensure compatibility. We recommend that you ignore this parameter. | true |
ForceStop | boolean | No | Specifies whether to forcibly stop the instance. Valid values:
Default value: false. | false |
StoppedMode | string | No | The stop mode of the pay-as-you-go instance. Valid values:
Default value: If the conditions for enabling the economical mode are met and you have enabled this mode in the ECS console, the default value is StopCharging . For more information, see the "Enable economical mode" section in | KeepCharging |
DryRun | boolean | No | Specifies whether to perform only a dry run, without performing the actual request. Valid values:
Default value: false. | true |
Hibernate | boolean | No | Note
This parameter is in invitational preview and is not publicly available.
| hide |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | The resource is in a state that does not support the current operation. |
403 | InstanceLockedForSecurity | The specified operation is denied as your instance is locked for security reasons. | - |
403 | DiskError | IncorrectDiskStatus | The specified disk status is invalid. |
403 | InstanceType.ParameterMismatch | The input parameter ConfirmStop must be true when an instance have localstorage. | The ConfirmStop parameter is not set to true for the instance that uses local storage. |
403 | InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | The subscription instance has expired. You must renew the instance before you can proceed. |
403 | InvalidInstanceId.NotSupport | Classic network Instance does not support this operation. | Instances that reside in the classic network do not support the operation. |
403 | InvalidInstanceId.NotSupport | Pre pay instance does not support this operation. | Subscription instances do not support the operation. |
403 | InvalidInstanceId.NotSupport | Local disk instance does not support this operation. | The operation is not supported while the instance has local disks attached. |
403 | InvalidInstanceId.NotSupport | Spot instance does not support this operation. | Preemptible instances do not support the operation. |
403 | IncorrectInstanceStatus | %s | The instance is in a state that does not support the current operation. |
403 | InvalidParameter.KMSKeyId.CMKUnauthorized | The CMK needs to be added ECS tag | - |
403 | InvalidParameter.KMSKeyId.CMKNotEnabled | The CMK needs to be enabled. | The customer master key (CMK) is not enabled when KMSKeyId is specified for an encrypted disk. You can call the DescribeKey operation of KMS to query information about the specified CMK. |
403 | InvalidParameter.KMSKeyId.KMSUnauthorized | ECS service have no right to access your KMS. | ECS is not authorized to access your KMS resources. |
403 | HibernationConfigured.InstanceOperationForbidden | The operation is not permitted due to limit of the hibernation configured instance. | The operation cannot be performed due to the limitations of instances for which the instance hibernation feature is enabled. |
403 | HibernationConfigured.NotEnabled | The instance hibernation configured option is not enabled. | - |
404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | The specified instance does not exist. |
500 | InternalError | The request processing has failed due to some unknown error. | An internal error has occurred. Try again later. |
500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | An internal error has occurred. Try again later. |
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|---|---|
2023-07-17 | The Error code has changed | View Change Details |
2021-05-25 | The Error code has changed | View Change Details |