Tous les produits
Search

Ce produit

    :RedeployInstance

    Centre de documentation

    :RedeployInstance

    Dernière mise à jour :Aug 18, 2026

    Appelez cette opération pour redéployer une instance ECS lorsqu'elle reçoit une notification d'événement.

    Description

    RedeployInstance est une opération asynchrone. Elle migre les données avant de redémarrer l'instance. Une fois le redéploiement terminé, l'instance passe à l'état En cours d'exécution (Running). En cas d'échec du redéploiement, l'instance revient sur son serveur physique d'origine et retrouve son état initial.

    Lors de l'appel à cette opération, tenez compte des points suivants :

    • L'instance doit être à l'état En cours d'exécution ou Arrêtée. Après le redéploiement, l'état de l'instance évolue comme suit :

      • Si l'instance est à l'état En cours d'exécution (Running), elle passe à l'état Arrêt en cours Stopping.

      • Si l'instance est à l'état Arrêtée (Stopped), elle passe à l'état Démarrage en cours (Starting).

    • Les instances hébergées sur des hôtes dédiés ne peuvent pas être redéployées.

    • Si la réponse de l'opération DescribeInstances indique que OperationLocks contient "LockReason": "security" pour l'instance, celle-ci est verrouillée pour des raisons de sécurité et ne peut pas être redéployée.

    • Si l'instance reçoit des événements simulés créés via l'opération CreateSimulatedSystemEvent, vous ne pouvez pas la redéployer en appelant l'opération RedeployInstance.

    • Lors du traitement des événements système liés aux disques locaux, si les disques locaux endommagés sont isolés mais que l'événement SystemMaintenance.RebootAndReInitErrorDisk (redémarrage de l'instance et réinitialisation des disques endommagés lors de la maintenance du système) n'est pas envoyé, vous pouvez toujours appeler l'opération RedeployInstance pour redéployer l'instance. Pour plus d'informations, consultez la rubrique Présentation des événements système sur les instances ECS équipées de disques locaux.

    Le tableau suivant répertorie les types et états des événements auxquels vous pouvez répondre en appelant l'opération RedeployInstance.

    Événement système État

    Redémarrage de l'instance lors de la maintenance du système (SystemMaintenance.Reboot)

    Enquête et Planifié

    Redéploiement de l'instance lors de la maintenance du système (SystemMaintenance.Redeploy)

    Enquête et Planifié

    Redémarrage de l'instance et remplacement des disques endommagés lors de la maintenance du système (SystemMaintenance.RebootAndIsolateErrorDisk)

    Enquête

    Redémarrage de l'instance et réinitialisation des disques endommagés lors de la maintenance du système (SystemMaintenance.RebootAndReInitErrorDisk)

    Enquête

    Redéploiement de l'instance en cas d'erreur système (SystemFailure.Redeploy)

    Enquête et Planifié

    Pour les instances équipées uniquement de disques locaux : redémarrage de l'instance en cas d'erreur système (SystemFailure.Reboot)

    Exécution en cours

    Isolation des disques endommagés lors de la maintenance du système (SystemMaintenance.IsolateErrorDisk)

    Enquête

    Réinitialisation des disques endommagés lors de la maintenance du système (SystemMaintenance.ReInitErrorDisk)

    Enquête
    Remarque

    Lorsque le système redéploie des instances équipées de disques locaux, ces derniers sont réinitialisés et les données qu'ils contiennent sont effacées.

    Débogage

    OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. Celui-ci génère dynamiquement l'exemple de code de l'opération pour différents SDK.

    Paramètres de requête

    ParamètreTypeObligatoireExempleDescription
    ActionStringOuiRedeployInstance

    Opération à effectuer. Définissez la valeur sur RedeployInstance.

    InstanceIdStringOuii-bp1azkttqpldxgted****

    ID de l'instance.

    ForceStopBooleanNonfalse

    Indique s'il faut forcer l'arrêt de l'instance à l'état En cours d'exécution.

    Valeur par défaut : false.

    Remarque Un arrêt forcé produit les mêmes effets qu'une panne de courant. Les données du système d'exploitation de l'instance qui n'ont pas été écrites sur les disques locaux peuvent être perdues. Nous vous recommandons de redéployer les instances lorsqu'elles sont à l'état Arrêtée.

    Paramètres de réponse

    Paramètre Type Exemple Description
    RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    ID de la requête.
    TaskId String t-bp10e8orkp8x****

    ID de la tâche de redéploiement.

    Appelez l'opération DescribeTasks pour interroger le résultat de la migration.

    Exemples

    Exemple de requête

    https://ecs.aliyuncs.com/?Action=RedeployInstance
&InstanceId=i-bp1azkttqpldxgted****
&<Common request parameters>

    Exemple de réponse réussie

    Format XML

    <RedeployInstanceResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <TaskId>t-bp10e8orkp8x****</TaskId>
</RedeployInstanceResponse>

    Format JSON

    {
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "TaskId": "t-bp10e8orkp8x****"
}

    Codes d'erreur

    Code d'état HTTP Code d'erreur Message d'erreur Description
    404 InvalidInstanceId.NotFound The InstanceId provided does not exist in our records. Le message d'erreur renvoyé indique que le paramètre InstanceId spécifié n'existe pas. Vérifiez que l'ID de l'instance est correct.
    403 IncorrectInstanceStatus The current status of the resource does not support this operation. Le message d'erreur renvoyé indique que l'opération n'est pas prise en charge tant que la ressource se trouve dans l'état actuel.
    403 InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons. Le message d'erreur renvoyé indique que 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. Le message d'erreur renvoyé indique que l'état du disque spécifié n'est pas valide.
    500 InternalError The request processing has failed due to some unknown error. Le message d'erreur renvoyé indique qu'une erreur interne s'est produite. Réessayez ultérieurement.
    403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). Le message d'erreur renvoyé indique que l'instance par abonnement a expiré. Renouvelez l'instance et réessayez.
    403 IncorrectInstanceStatus %s Le message d'erreur renvoyé indique que l'opération n'est pas prise en charge tant que l'instance se trouve dans l'état actuel.
    403 InvalidOperation.RedeployInstance %s Le message d'erreur renvoyé indique que l'opération n'est pas valide.

    Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.