Tous les produits
Search

Ce produit

    :ReInitDisk

    Centre de documentation

    :ReInitDisk

    Dernière mise à jour :Aug 18, 2026

    Appelez cette opération pour réinitialiser un disque et le restaurer dans l'état de sa création.

    Description

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

    • Le disque à réinitialiser doit être dans l'état In Use (In_use) et l'instance à laquelle il est attaché doit être dans l'état Stopped (Stopped).

    • Si une instance n'a jamais été démarrée depuis sa création, vous ne pouvez pas réinitialiser les disques qui lui sont attachés.

    • Si un snapshot local existe pour un disque, vous ne pouvez pas réinitialiser ce dernier.

    • La réinitialisation d'un disque système le restaure dans l'état de l'image source. Si l'image source est supprimée, la réinitialisation du disque système est impossible.

    • La réinitialisation d'un disque de données créé séparément le vide entièrement.

    • La réinitialisation d'un disque de données créé à partir d'un snapshot le restaure dans l'état du snapshot source.

    Remarque

    Si le snapshot source est supprimé, la réinitialisation du disque échoue et renvoie une erreur.

    Débogage

    OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. L'outil génère automatiquement des exemples de code pour différents SDK.

    Paramètres de requête

    ParameterTypeRequiredExampleDescription
    ActionStringYesReInitDisk

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

    DiskIdStringYesd-bp67acfmxazb4ph****

    ID du disque.

    PasswordStringNoEcsV587!

    Indique s'il faut réinitialiser le mot de passe de l'instance lors de la réinitialisation de son disque système. Le mot de passe doit comporter entre 8 et 30 caractères et inclure au moins trois des types suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux. Les caractères spéciaux autorisés sont :

    
( ) ` ~ ! @ # $ % ^ & * - _ + = | { } [ ] : ; ' < > , . ? /

    Pour une instance Windows, le mot de passe ne peut pas commencer par une barre oblique (/).

    Remarque Si vous spécifiez le paramètre Password, nous vous recommandons d'envoyer les requêtes via HTTPS pour sécuriser votre mot de passe.
    KeyPairNameStringNotestKeyPairName

    Nom de la paire de clés.

    Remarque Ce paramètre s'applique uniquement aux instances Linux. Vous pouvez associer une paire de clés SSH à une instance comme identifiant de connexion lors de la réinitialisation de son disque système. Une fois la paire de clés SSH associée, la connexion par nom d'utilisateur et mot de passe est désactivée pour l'instance.
    AutoStartInstanceBooleanNotrue

    Indique s'il faut démarrer automatiquement l'instance après la réinitialisation du disque.

    Valeur par défaut : false.

    SecurityEnhancementStrategyStringNoActive

    Indique s'il faut utiliser Security Center gratuitement après la réinitialisation du disque système. Valeurs valides :

    • Active : Security Center est utilisé gratuitement après le remplacement du disque système. Cette valeur s'applique uniquement aux images publiques.
    • Deactive : Security Center n'est pas utilisé gratuitement après le remplacement du disque système. Cette valeur s'applique à toutes les images.

    Valeur par défaut : Deactive.

    Paramètres de réponse

    Parameter Type Example Description
    RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    ID de la requête.

    Exemples

    Exemples de requêtes

    https://ecs.aliyuncs.com/?Action=ReInitDisk
&DiskId=d-bp67acfmxazb4ph****
&KeyPairName=testKeyPairName
&AutoStartInstance=true
&SecurityEnhancementStrategy=Active
&<Common request parameters>

    Exemples de réponses réussies

    Format XML

    <ReInitDiskResponse>
      <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ReInitDiskResponse>

    Format JSON

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

    Codes d'erreur

    HTTP status code Error code Error message Description
    404 InvalidDiskId.NotFound The specified disk does not exist. Le paramètre DiskId spécifié n'existe pas. Vérifiez l'exactitude de l'ID du disque.
    403 IncorrectDiskStatus The current disk status does not support this operation. L'opération n'est pas prise en charge dans l'état actuel du disque. Assurez-vous que le disque est disponible et qu'aucun impayé ne concerne votre compte pour ce disque.
    403 IncorrectInstanceStatus The current status of the resource does not support this operation. L'opération n'est pas prise en charge dans l'état actuel de la ressource.
    403 InstanceLockedForSecurity The instance is locked due to security. L'opération n'est pas prise en charge car l'instance est verrouillée pour des raisons de sécurité.
    403 InvalidSnapshot.TooOld The disk is created from a snapshotId made before 2013-07-15, it cannot be re-initiated the specified disk any more since the detached first time. Les snapshots créés avant le 15 juillet 2013 ne prennent pas en charge cette opération.
    403 OperationDenied The snapshot which is used to create the specified disk has been deleted. Le snapshot utilisé pour créer le disque spécifié n'existe pas.
    403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). L'instance par abonnement a expiré. Renouvelez l'instance.
    403 DiskCreatingSnapshot The operation is denied due to a snapshot of the specified disk is not completed yet. Un snapshot du disque spécifié est en cours de création.
    403 InvalidSourceSnapshot The snapshot which is used to create the specified disk has been deleted. Le snapshot utilisé pour créer le disque spécifié a été supprimé.
    404 InvalidImageId.NotFound The specified ImageId does not exist. L'image spécifiée n'existe pas dans ce compte. Vérifiez l'exactitude de l'ID de l'image.
    403 SharedImageDeleted The specified image by others shared is deleted. L'image partagée spécifiée a été supprimée.
    400 InvalidPassword.Malformed The specified parameter "Password" is not valid. Le paramètre Password spécifié n'est pas valide.
    400 DiskCategory.OperationNotSupported The operation is not supported to the specified disk due to its disk category La catégorie de disque spécifiée ne prend pas en charge l'opération.
    400 InvalidKeyPairName.NotFound The specified KeyPairName does not exist. Le paramètre KeyPairName spécifié n'existe pas.
    400 DependencyViolation.IoOptimize The specified parameter InstanceId is not valid. L'optimisation des E/S de l'instance n'est pas valide.
    403 UserNotInTheWhiteList The user is not in volume white list. Vous ne figurez pas dans la liste d'autorisation du stockage bloc partagé. Soumettez un ticket pour demander l'autorisation.
    400 InvalidRegionId.MalFormed The specified RegionId is not valid Le paramètre RegionId spécifié n'est pas valide.
    404 InvalidDiskId.OperationNotSupported The operation is not supported due to image not exist. L'image spécifiée n'existe pas.
    403 InvalidParameter.KMSKeyId.KMSUnauthorized ECS service have no right to access your KMS. ECS n'est pas autorisé à accéder à vos ressources KMS.
    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 le Centre d'erreurs de l'API.