Tous les produits
Search

Ce produit

    Elastic Compute Service:ReplaceSystemDisk

    Centre de documentation

    Elastic Compute Service:ReplaceSystemDisk

    Dernière mise à jour :Aug 18, 2026

    Remplace le système d'exploitation d'une instance ECS en remplaçant le disque système. Après le remplacement, l'identifiant du disque système change et le disque d'origine est libéré.

    Description de l'opération

    Avant d'appeler cette opération, lisez Remplacer un disque système (changer le système d'exploitation).

    Testez maintenant

    Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

    Test

    Autorisation RAM

    Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

    • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

    • API : l'API que vous pouvez appeler pour exécuter l'action.

    • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

    • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

      • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

      • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

    • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

    • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

    ecs:ReplaceSystemDisk

    update

    Disk

    acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

    Image

    acs:ecs:{#regionId}:{#accountId}:image/{#imageId}

    *Instance

    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}
    • ecs:IsDiskEncrypted
    • ecs:IsSystemDiskEncrypted
    • ecs:PasswordInherit
    • ecs:PasswordCustomized
    • ecs:IsDiskByokEncrypted
    • ecs:IsSystemDiskByokEncrypted
    • ecs:LoginAsNonRoot
    • ecs:ImagePlatform
    		 Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    InstanceId

    string

    Oui

    L'identifiant de l'instance cible.

    i-bp67acfmxazb4ph****
    ImageId

    string

    Non

    L'identifiant de l'image à utiliser pour réinitialiser le système. Ce paramètre est requis.

    m-bp67acfmxazb4ph****
    SystemDisk.Size

    integer

    Non

    La capacité du nouveau disque système. Unité : Gio. Valeurs valides :

    80
    ClientToken

    string

    Non

    Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais assurez-vous que le jeton est unique parmi les différentes requêtes. La valeur de ClientToken ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.

    123e4567-e89b-12d3-a456-426655440000
    UseAdditionalService

    boolean

    Non

    Indique si la configuration système de la machine virtuelle fournie par Alibaba Cloud doit être utilisée (Windows : NTP et KMS. Linux : NTP et YUM).

    true
    Password

    string

    Non

    Indique si le nom d'utilisateur et le mot de passe de l'instance ECS doivent être réinitialisés. Le mot de passe doit comporter entre 8 et 30 caractères et doit contenir au moins trois des types de caractères suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux. Les caractères spéciaux suivants sont pris en charge :

    EcsV587!
    PasswordInherit

    boolean

    Non

    Indique si le mot de passe prédéfini de l'image doit être utilisé.

    false
    KeyPairName

    string

    Non

    Le nom de la paire de clés.

    testKeyPairName
    DiskId

    string

    Non

    Remarque

    [Obsolète] Ce paramètre est obsolète. Pour améliorer la compatibilité, utilisez ImageId à la place.

    d-bp67acfmxazb4ph****
    Platform

    string

    Non

    Remarque

    Ce paramètre est obsolète.

    CentOS
    Architecture

    string

    Non

    Remarque

    Ce paramètre est obsolète.

    i386
    SecurityEnhancementStrategy

    string

    Non

    Indique si le service gratuit Security Center doit être utilisé après le remplacement du disque système. Valeurs valides :

    Active
    Encrypted

    boolean

    Non

    Indique si le disque doit être chiffré. Valeurs valides :

    false
    KMSKeyId

    string

    Non

    L'identifiant de la clé KMS du disque système.

    e522b26d-abf6-4e0d-b5da-04b7******3c
    EncryptAlgorithm

    string

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    hide
    Arn

    array<object>

    Non

    Ce paramètre n'est pas disponible publiquement.

    object

    Non

    RoleType

    string

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    null
    Rolearn

    string

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    null
    AssumeRoleFor

    integer

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    0

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    DiskId

    string

    L'identifiant du nouveau disque système.

    d-bp67acfmxazb4ph****
    RequestId

    string

    L'identifiant de la requête.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    Exemples

    JSON format

    {
  "DiskId": "d-bp67acfmxazb4ph****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

    Codes d'erreur

    Code de statut HTTP

    Code d'erreur

    Message d'erreur

    Description
    400 LoginAsNonRoot.ImageNotSupport The specified image does not support login as non-root.
    400 InvalidSystemDiskSize.ValueNotSupported The specified parameter SystemDisk.Size is invalid.
    400 InvalidParameter.Conflict The specified image does not support the specified instance type.
    400 InvalidSystemDiskSize.ImageNotSupportResize The specified image does not support resize.
    400 InvalidSystemDiskSize The specified parameter SystemDisk.Size is invalid.
    400 InvalidPassword.Malformed The specified parameter "Password" is not valid.
    400 InvalidPasswordParam.Mismatch The input password should be null when passwdInherit is true.
    400 OperationDenied The specified image contains the snapshot of the data disk. This operation is not supported.
    400 InvalidDiskCategory.ValueNotSupported The specified parameter "DiskCategory" is not valid.
    400 InvalidKeyPairName.NotFound The specified KeyPairName does not exist.
    400 DependencyViolation.IoOptimize The specified parameter InstanceId is not valid.
    400 MissingParameter.Architecture Architecture should not be null.
    400 InvalidArchitecture.Malformed Architecture is not valid.
    400 MissingParameter.Platform Platform should not be null.
    400 InvalidPlatform.Malformed Platform is not valid.
    400 InvalidDiskId.NotFound The specified disk do not exist.
    400 InvalidDatadisk.DiskStatusViolation The operation is not permitted due to status of the Datadisk.
    400 InvalidDatadisk.DiskCategoryViolation The operation is not permitted due to category of the Datadisk.
    400 InvalidDatadisk.ChargeTypeViolation The operation is not permitted due to charge type of the Datadisk.
    400 MissingParameter The input parameter "ImageId" that is mandatory for processing this request is not supplied.
    400 InvalidInstance.NotFoundSystemDisk The specified instance has no system disk.
    400 InvalidParameter.DiskType The specified disk type which has kms key can't convert to system disk.
    400 DISK_IN_DEDICATED_BLOCK_STORAGE_CLUSTER The disk in dedicated block storage cluster is not allowed to do this operation.
    400 IncorrectDiskStatus.ReplicationStatusNotFound Disk replication status not found.
    400 IncorrectDiskStatus.InReplication Disk already in replication.
    400 InvalidInstanceType.NotSupported The specified instanceType is not supported by the image architecture.
    400 InvalidRegionId.NotSupportReplaceEncryptedSystemDisk The specified region not support replace encrypted system disk.
    400 InvalidStorageClusterId.CapacityNotEnough The remaining capacity of the current dedicated storage cluster is less than the size of disk.
    400 QuotaExceed.DiskCapacity The used capacity of disk type has exceeded the quota in the zone, %s.
    400 AccountForbidden.ProductCreationLimited The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.
    400 InternalError The requested services is not available now. Please try again later.
    400 InvalidDiskName.Malformed The specified parameter "SyatemDisk.DiskName or DataDisk.n.DiskName" is not valid.
    400 InvalidParameter.Encrypted Creating non-encrypted disks with encrypted snapshots is not supported.
    500 OperationDenied Internal Error.
    500 InternalError The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
    403 LoginAsNonRoot.RegionNotSupport The specified region does not support login as non-root.
    403 InvalidSystemDiskStatus.IsTransfering The current status of the resource does not support this operation. The system disk is transferring.
    403 IncorrectDiskStatus The current disk status does not support this operation.
    403 IncorrectInstanceStatus The current status of the resource does not support this operation.
    403 InstanceLockedForSecurity The instance is locked due to security.
    403 ImageNotSubscribed The specified image has not be subscribed.
    403 ImageRemovedInMarket The specified marketplace image is not available. Or the specified user-defined image includes a product code because it is based on an image subscribed from the marketplace; and that marketplace image including the exact same product code has been removed.
    403 InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
    403 ChargeTypeViolation The operation is not permitted due to charge type of the instance.
    403 DiskCreatingSnapshot The operation is denied due to a snapshot of the specified disk is not completed yet.
    403 IoOptimized.NotSupported The specified image does not support IoOptimized instances.
    403 ImageNotSupportInstanceType The specified image don not support the InstanceType instance.
    403 QuotaExceed.BuyImage The specified image is from the image market. You have not bought it or your quota has been exceeded.
    403 INST_HAS_UNPAID_ORDER The instance has unpaid order.
    403 OperationDenied.InstanceCreating The specified instance is creating.
    403 DependencyViolation.WindowsInstance The instance runs Windows and does not support SSH key pair login.
    403 InvalidParameter.NotMatch %s
    403 ResourcesNotInSameZone The specified instance and disk are not in the same zone.
    403 OperationDenied.UnpaidOrder The specified instance has unpaid order.
    403 InvalidHostname.MismatchImage The hostname of the current instance can not be applied to the image you choose.
    403 HibernationConfigured.InstanceOperationForbidden The operation is not permitted due to limit of the hibernation configured instance.
    403 InvalidOperation.MultiAttachDisk Multi attach disk does not support this operation.
    403 InvalidRegionId.NotSupportEncryptAlgorithm The current region does not support creating encrypted disks with EncryptAlgorithm.
    403 InvalidRegionId.NotExists The region not exists.
    403 InvalidEncryptAlgorithm The specified parameter EncryptAlgorithm is not valid.
    403 InvalidEncrypted.NotMatchKmsKeyId The specified parameter Encrypted must be true when KmsKeyId is not empty.
    403 InvalidEncrypted.NotMatchEncryptAlgorithm The specified parameter Encrypted must be true when EncryptAlgorithm is not empty.
    403 InvalidParameter.KmsNotEnabled The specified operation need enable KMS.
    403 InvalidParameter.DataEncryptedKeyCreateFailed Failed to create the KMS data encryption key. Please verify that the current KMS key has authorized the ECS service to use it. If the issue persists; contact KMS Technical Support.
    403 InvalidParameter.KMSKeyId.NotFound The specified KMSKeyId does not exist.
    403 InvalidParameter.KMSKeyId.KMSUnauthorized ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
    403 InvalidKMSKeyId.NotSymmetric The specified parameter KmsKeyId must be symmetric.
    403 InvalidDiskId.NotSupportReplaceEncryptedSystemDisk The specified diskId not support replace encrypted system disk.
    403 NotSupportSnapshotEncrypted.DiskCategory The specified disk category does not support creating encrypted system disks or encrypted data disks from snapshots. Check the DiskCategory or Encrypted parameter; or check your account for default encryption settings.
    403 InvalidParameter.AllEmpty The current operation does not allow both diskId and imageId to be empty. Make sure that either diskId or imageId is not empty.
    403 InvalidParameter.Conflict The current operation does not allow both diskId and imageId to be set. Make sure that either diskId or imageId is not empty.
    403 OperationDenied The current region does not support changing the image type.
    403 OperationDenied.ImageNotValid The specified Image is disabled or deleted. Please check the status of the image.
    403 OperationDenied.DiskNoStock The requested disk category is sold out in the specified zone. Please try a different disk category or another zone.
    403 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK (Customer Master Key) must be in an active state.
    403 InvalidParameter.KMSKeyId.CMKUnauthorized The CMK(Customer Master Key) lacks authorization to add tags to the ECS service.
    403 InvalidEncrypted.NotMatchSnapshot The specified parameter Encrypted must be set to true when creating disks with encrypted snapshots.
    403 InvalidEncrypted.NotMatchDiskDefaultEncryption Enabling disk default encryption prevents the creation of non-encrypted disks.
    403 InvalidPayMethod.SyncPaymentNotSupport Synchronous payment is not supported. Use another payment method.
    403 InvalidOperation.ImageSecureBootUnsupported The image does not support secure boot.
    403 InvalidDiskCategory.NotSupported The disk category is not supported in the current zone. Please call DescribeAvailableResource to check supported categories.
    403 OperationDenied.KMSKeyUnauthorized The operation is denied due to missing KMS key authorization. Please check the KMS key permissions and ensure the key is properly authorized for this operation.
    404 InvalidInstanceId.NotFound The specified InstanceId does not exist.
    404 InvalidImageId.NotFound The specified ImageId does not exist.
    404 InvalidSystemDiskSize.MoreThanMaxSize The specified SystemDisk.Size parameter exceeds the maximum size.
    404 InvalidSystemDiskSize.LessThanImageSize The specified parameter SystemDisk.Size is less than the image size.
    404 InvalidSystemDiskSize.LessThanMinSize The specified parameter SystemDisk.Size is less than the min size.
    404 NoSuchResource The specified resource is not found.

    Consultez Codes d'erreur pour la liste complète.

    Notes de version

    Consultez Notes de version pour la liste complète.