RebootInstance - - Centre de documentation Alibaba Cloud

Description

Seules les instances à l'état Running peuvent être redémarrées.
Après l'appel de cette opération, l'état de l'instance passe à Starting.
Vous pouvez forcer le redémarrage d'une instance. Un redémarrage forcé (ForceStop) équivaut à un redémarrage matériel. Cette opération peut entraîner une perte de données si celles-ci n'ont pas été écrites sur le disque.
Si vous appelez l'opération DescribeInstances pour interroger les détails d'une instance et que le champ OperationLocks de la réponse contient « LockReason » : « security », l'instance est verrouillée pour des raisons de sécurité et ne peut pas être arrêtée. Pour plus d'informations, consultez la rubrique Comportement de l'API lorsqu'une instance est verrouillée pour des raisons de sécurité.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer par souci de commodité. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	RebootInstance	Opération à effectuer. Définissez la valeur sur RebootInstance.
InstanceId	String	Oui	i-bp67acfmxazb4ph****	ID de l'instance.
ForceStop	Boolean	Non	false	Indique s'il faut arrêter l'instance de force pour la redémarrer. Valeurs possibles : true : arrête l'instance de force. Cette opération équivaut à un arrêt matériel. Les données en cache qui n'ont pas été écrites dans le stockage persistant seront perdues. false : arrête l'instance normalement. Il s'agit de la valeur par défaut.
DryRun	Boolean	Non	false	Indique s'il faut effectuer une vérification préliminaire (dry run). Valeurs possibles : true : effectue une vérification préliminaire. Le système vérifie les paramètres obligatoires, le format de la requête, les limites du service et les ressources ECS disponibles. Si la requête échoue à la vérification préliminaire, un message d'erreur est renvoyé. Si la requête réussit la vérification préliminaire, le code d'erreur `DryRunOperation` est renvoyé. false : effectue une vérification préliminaire et envoie la requête. Si la requête réussit la vérification préliminaire, l'instance est redémarrée. Valeur par défaut : false.

Paramètres de réponse

Paramètre

Type

Exemple

Description

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID de la requête.

Exemples

Exemple de requête

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

Exemple de réponse en cas de succès

Format XML

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

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

Format JSON

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

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

Codes d'erreur

Code HTTP

Code d'erreur

Message d'erreur

Description

403

IncorrectInstanceStatus

The current status of the resource does not support this operation.

L'opération n'est pas prise en charge tant que l'instance se trouve dans son état actuel.

403

InstanceLockedForSecurity

The specified operation is denied as your instance is locked for security reasons.

L'opération n'est pas prise en charge tant que l'instance est verrouillée pour des raisons de sécurité.

403

DiskError

IncorrectDiskStatus.

L'état du disque spécifié n'est pas valide.

403

InstanceExpiredOrInArrears

The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).

L'instance sous abonnement a expiré. Renouvelez l'instance et réessayez.

403

IncorrectInstanceStatus

%s

L'opération n'est pas prise en charge tant que l'instance se trouve dans son état actuel.

404

InvalidInstanceId.NotFound

The specified InstanceId does not exist.

L'instance spécifiée n'existe pas. Vérifiez que le paramètre InstanceId spécifié est valide et réessayez.

500

InternalError

The request processing has failed due to some unknown error.

Une erreur interne s'est produite. Réessayez ultérieurement.

500

InternalError

The request processing has failed due to some unknown error, exception or failure.

Une erreur interne s'est produite. Réessayez ultérieurement.

Pour obtenir la liste des codes d'erreur, consultez la page Codes d'erreur de service.