Tous les produits
Search

Ce produit

    :ResetDisk

    Centre de documentation

    :ResetDisk

    Dernière mise à jour :Aug 18, 2026

    Restaure un disque à partir d'un snapshot de ce disque.

    Description

    Lorsque vous appelez cette opération, tenez compte des points suivants :

    • Le disque doit être dans l'état En cours d'utilisation (In_Use) ou Non attaché (Available).

    • L'instance Elastic Compute Service (ECS) à laquelle le disque est attaché doit être dans l'état Arrêté (Stopped). Appelez l'opération StopInstances pour arrêter une instance.

    • Le snapshot spécifié par le paramètre SnapshotId doit avoir été créé à partir du disque spécifié par le paramètre DiskId.

    • Si la réponse de l'opération DescribeInstances contient {"OperationLocks": {"LockReason" : "security"}} pour une instance, celle-ci est verrouillée pour des raisons de sécurité et aucune opération ne peut être effectuée dessus.

    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. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

    Paramètres de requête

    ParamètreTypeObligatoireExempleDescription
    ActionStringOuiResetDisk

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

    DiskIdStringOuid-bp199lyny9b3****

    ID du disque à restaurer.

    SnapshotIdStringOuis-bp199lyny9b3****

    ID du snapshot à utiliser pour restaurer le disque.

    DryRunBooleanNonfalse

    Indique s'il faut vérifier la validité de la requête sans l'exécuter réellement. Valeurs possibles :

    • true : La validité de la requête est vérifiée, mais la requête n'est pas envoyée. Les éléments vérifiés incluent les paramètres obligatoires, le format de la requête et les limites d'état des ressources. Si la vérification échoue, le message d'erreur correspondant est renvoyé. Si la vérification réussit, le code d'erreur DryRunOperation est renvoyé.
    • false : La validité de la requête est vérifiée. Si la vérification réussit, la requête est envoyée.

    Valeur par défaut : false.

    Paramètres de réponse

    Paramètre Type Exemple Description
    RequestId String F3CD6886-D8D0-4FEE-B93E-1B732396****

    ID de la requête.

    Exemples

    Exemple de requête

    http(s)://ecs.aliyuncs.com/?Action=ResetDisk
&DiskId=d-bp199lyny9b3****
&SnapshotId=s-bp199lyny9b3****
&<Common request parameters>

    Exemple de réponse en cas de succès

    Format XML

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

<ResetDiskResponse>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B732396****</RequestId>
</ResetDiskResponse>

    Format JSON

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

{
  "RequestId" : "F3CD6886-D8D0-4FEE-B93E-1B732396****"
}

    Codes d'erreur

    Code d'état HTTP Code d'erreur Message d'erreur Description
    400 DiskCategory.OperationNotSupported The operation is not supported to the specified disk due to its disk category Message d'erreur indiquant que la catégorie de disque spécifiée ne prend pas en charge cette opération.
    400 InvalidRegionId.MalFormed The specified RegionId is not valid Message d'erreur indiquant que le paramètre RegionId spécifié n'est pas valide.
    400 DryRunOperation Request validation has been passed with DryRun flag set. Message d'erreur indiquant que votre requête est considérée comme valide lorsque le paramètre DryRun est défini sur true.
    403 IncorrectDiskStatus The current disk status does not support this operation. Message d'erreur indiquant que l'opération n'est pas prise en charge tant que le disque se trouve dans l'état actuel. Assurez-vous que le disque est utilisable et qu'aucun impayé ne le concerne.
    403 IncorrectInstanceStatus The current status of the resource does not support this operation. Message d'erreur indiquant que l'opération n'est pas prise en charge tant que la ressource se trouve dans l'état actuel.
    403 InstanceLockedForSecurity The instance is locked due to security. Message d'erreur indiquant que l'opération n'est pas prise en charge tant que l'instance est verrouillée pour des raisons de sécurité.
    403 InvalidParameter.Mismatch The specified snapshot is not created from the specified disk. Message d'erreur indiquant qu'un snapshot chiffré ne peut pas être utilisé pour restaurer un disque non chiffré.
    403 InvalidSnapshot.TooOld The snapshotId is created before 2013-07-15, it cannot be restored since the first time the disk detached. Message d'erreur indiquant que les snapshots créés avant le 15 juillet 2013 ne prennent pas en charge cette opération.
    403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). Message d'erreur indiquant que l'instance par abonnement a expiré. Renouvelez l'instance et réessayez.
    403 OperationDenied The specified snapshot dees not support ResetDisk. Message d'erreur indiquant que le snapshot spécifié ne prend pas en charge cette opération.
    403 InvalidSnapshotId.NotReady The specified snapshot has not completed yet. Message d'erreur indiquant que le snapshot spécifié est en cours de création.
    403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. Message d'erreur indiquant que le solde de votre compte est insuffisant. Approvisionnez votre compte et réessayez.
    403 InvalidAccountStatus.SnapshotServiceUnavailable Snapshot service has not been opened yet. Message d'erreur indiquant que l'opération n'est pas prise en charge tant que le service de snapshot n'est pas activé.
    403 Operation.Conflict The operation may conflicts with others. Message d'erreur indiquant que l'opération entre en conflit avec d'autres opérations.
    403 UserNotInTheWhiteList The user is not in disk white list. Message d'erreur indiquant que vous n'êtes pas autorisé à gérer le disque. Réessayez une fois que vous y êtes autorisé.
    403 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK needs to be enabled. Message d'erreur indiquant que la clé maître client (CMK) n'est pas activée lorsqu'un ID de clé Key Management Service (KMS) est spécifié pour le disque. Vous pouvez appeler l'opération DescribeKey de KMS pour interroger les informations relatives à la CMK spécifiée.
    403 InvalidParameter.KMSKeyId.KMSUnauthorized ECS service have no right to access your KMS. Message d'erreur indiquant qu'ECS n'est pas autorisé à accéder à vos ressources KMS.
    404 InvalidParameter.KMSKeyId.NotFound The specified KMSKeyId does not exist. Message d'erreur indiquant que l'ID de clé KMS spécifié n'existe pas.
    404 InvalidDiskId.NotFound The specified disk does not exist. Message d'erreur indiquant que le paramètre DiskId spécifié n'existe pas. Vérifiez si l'ID du disque est correct.
    404 Disk.NotFound The specified disk does not exist. Message d'erreur indiquant que le paramètre DiskId spécifié n'existe pas. Vérifiez si l'ID du disque est correct.
    404 InvalidSnapshotId.NotFound The specified SnapshotId does not exist. Message d'erreur indiquant que le paramètre SnapshotId spécifié n'existe pas.
    404 InvalidInstanceId.NotFound The specified InstanceId does not exist. Message d'erreur indiquant que l'instance spécifiée n'existe pas. Vérifiez si l'ID de l'instance est correct.
    500 InternalError The request processing has failed due to some unknown error. Message d'erreur indiquant qu'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. Message d'erreur indiquant qu'une erreur interne s'est produite. Réessayez ultérieurement.

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