StopInstance - - Centro de documentación de Alibaba Cloud

Detiene una instancia de Elastic Compute Service (ECS) en estado Running. Después de invocar la operación, el estado de la instancia cambia a Stopping y posteriormente a Stopped.

Descripción

Si invoca la operación DescribeInstances para consultar los detalles de una instancia y OperationLocks en la respuesta contiene "LockReason": "security", la instancia está bloqueada por motivos de seguridad y no se puede detener. Para obtener más información, consulte Comportamiento de la API cuando una instancia se bloquea por motivos de seguridad.
Si el modo económico está habilitado, establezca StoppedMode en KeepCharging para activar el modo estándar. En este caso, después de detener la instancia en modo estándar, se le seguirá cobrando por ella y se conservarán tanto los recursos del tipo de instancia como la dirección IP pública.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos invocar esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	StopInstance	La operación que desea ejecutar. Establezca el valor en StopInstance.
InstanceId	String	Sí	i-bp67acfmxazb4ph****	El ID de la instancia.
ConfirmStop	Boolean	No	true	Este parámetro se eliminará en el futuro y se conserva únicamente para garantizar la compatibilidad. Le recomendamos ignorar este parámetro.
ForceStop	Boolean	No	false	Especifica si se debe forzar la detención de la instancia. Valores válidos: true: fuerza la detención de la instancia. false: detiene la instancia de forma normal. Valor predeterminado: false.
StoppedMode	String	No	KeepCharging	El modo de detención de la instancia pay-as-you-go. Valores válidos: StopCharging: modo económico. Para obtener información sobre cómo entra en vigor `StopCharging`, consulte la sección "Requisitos previos" en Modo económico. KeepCharging: modo estándar. Después de detener la instancia en modo estándar, se le seguirá cobrando por ella. Valor predeterminado: Si se cumplen los requisitos previos para habilitar el modo económico y usted ha habilitado este modo en la consola de ECS, el valor predeterminado es StopCharging. Para obtener más información, consulte la sección "Habilitar el modo económico" en `Modo económico`. De lo contrario, el valor predeterminado es `KeepCharging`.
DryRun	Boolean	No	true	Especifica si se debe comprobar la validez de la solicitud sin realizarla realmente. Valor predeterminado: false. Valores válidos: true: Se comprueba la validez de la solicitud, pero no se realiza. Los elementos de comprobación incluyen los parámetros obligatorios, los límites del servicio, los recursos de ECS disponibles y el formato de la solicitud. Si la comprobación falla, se devuelve el código de error correspondiente. Si la comprobación es exitosa, se devuelve el código de error `DryRunOperation`. false: Se comprueba la validez de la solicitud y, si la comprobación es exitosa, se realiza la solicitud. Valor predeterminado: false.
Hibernate	Boolean	No	hide	Nota Este parámetro se encuentra actualmente en vista previa por invitación y no está disponible para usuarios generales.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	1C488B66-B819-4D14-8711-C4EAAA13AC01	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=StopInstance
&InstanceId=i-bp67acfmxazb4ph****
&ForceStop=false
&StoppedMode=KeepCharging
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<StopInstanceResponse>
    <RequestId>1C488B66-B819-4D14-8711-C4EAAA13AC01</RequestId>
</StopInstanceResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	El mensaje de error devuelto porque la operación no es compatible mientras el recurso se encuentra en el estado actual.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	El mensaje de error devuelto porque la operación no es compatible mientras la instancia está bloqueada por motivos de seguridad.
403	DiskError	IncorrectDiskStatus	El mensaje de error devuelto porque el estado del disco especificado no es válido.
403	InstanceType.ParameterMismatch	The input parameter ConfirmStop must be true when an instance have localstorage.	El mensaje de error devuelto porque el parámetro ConfirmStop está establecido en false para la instancia que utiliza almacenamiento local.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	El mensaje de error devuelto porque la instancia de suscripción ha caducado. Renueve la instancia e inténtelo más tarde.
403	InvalidInstanceId.NotSupport	Classic network Instance does not support this operation.	El mensaje de error devuelto porque la operación no es compatible con la instancia ubicada en la red clásica.
403	InvalidInstanceId.NotSupport	Pre pay instance does not support this operation.	El mensaje de error devuelto porque la operación no es compatible con la instancia de suscripción.
403	InvalidInstanceId.NotSupport	Local disk instance does not support this operation.	El mensaje de error devuelto porque la operación no es compatible con la instancia que utiliza discos locales.
403	InvalidInstanceId.NotSupport	Spot instance does not support this operation.	El mensaje de error devuelto porque la operación no es compatible con la preemptible instance.
403	IncorrectInstanceStatus	%s	El mensaje de error devuelto porque la operación no es compatible mientras la instancia se encuentra en el estado actual.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	El mensaje de error devuelto porque la clave maestra del cliente (CMK) especificada por el parámetro KMSKeyId no está habilitada. Puede invocar la operación DescribeKey de KMS para consultar información sobre la CMK especificada.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.	El mensaje de error devuelto porque ECS no tiene autorización para acceder a sus recursos de KMS.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	El mensaje de error devuelto porque el parámetro InstanceId especificado no es válido.
500	InternalError	The request processing has failed due to some unknown error.	El mensaje de error devuelto porque se ha producido un error interno. Inténtelo de nuevo más tarde.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	El mensaje de error devuelto porque se ha producido un error interno. Inténtelo de nuevo más tarde.

Para obtener una lista de códigos de error, visite el Centro de errores de API.