RebootInstance - - Centro de documentación de Alibaba Cloud

Reinicia una instancia que se encuentra en estado Running.

Descripción

Solo es posible reiniciar las instancias que se encuentran en el estado Running.
Después de llamar a esta operación, el estado de la instancia cambia a Starting.
Es posible forzar el reinicio de una instancia. Un reinicio forzado (ForceStop) equivale a un reinicio físico. Esta operación puede provocar pérdida de datos si la información de la instancia no se ha escrito en el disco.
Si llama a 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.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta 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í	RebootInstance	La operación que desea ejecutar. Establezca el valor en RebootInstance.
InstanceId	String	Sí	i-bp67acfmxazb4ph****	El ID de la instancia.
ForceStop	Boolean	No	false	Especifica si se debe detener la instancia de forma forzada para reiniciarla. Valores válidos: true: detiene la instancia de manera forzada. Esta operación equivale a un apagado físico. Los datos en caché que no se hayan escrito en el almacenamiento persistente se perderán. false: detiene la instancia normalmente. Este es el valor predeterminado.
DryRun	Boolean	No	false	Especifica si se debe ejecutar una prueba en seco. Valores válidos: true: ejecuta una prueba en seco. El sistema comprueba los parámetros obligatorios, el formato de la solicitud, los límites del servicio y los recursos de ECS disponibles. Si la solicitud no supera la prueba, se devuelve un mensaje de error. Si la solicitud supera la prueba, se devuelve el código de error `DryRunOperation`. false: ejecuta una prueba en seco y envía la solicitud. Si la solicitud supera la prueba, la instancia se reinicia. Valor predeterminado: false.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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

Respuesta correcta de ejemplo

Formato XML

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

<RebootInstanceResponse>
    <RequestId>F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A</RequestId>
</RebootInstanceResponse>

Formato JSON

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

{
  "RequestId" : "F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A"
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Mensaje de error devuelto porque la operación no es compatible con el estado actual de la instancia.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Mensaje de error devuelto porque la operación no es compatible mientras la instancia está bloqueada por motivos de seguridad.
403	DiskError	IncorrectDiskStatus.	Mensaje de error devuelto porque el estado del disco especificado no es válido.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	Mensaje de error devuelto porque la instancia de suscripción ha caducado. Renueve la instancia e inténtelo de nuevo.
403	IncorrectInstanceStatus	%s	Mensaje de error devuelto porque la operación no es compatible con el estado actual de la instancia.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Mensaje de error devuelto porque la instancia especificada no existe. Compruebe si el parámetro InstanceId especificado es válido e inténtelo de nuevo.
500	InternalError	The request processing has failed due to some unknown error.	Mensaje de error devuelto porque se produjo 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.	Mensaje de error devuelto porque se produjo un error interno. Inténtelo de nuevo más tarde.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.