ReplaceSystemDisk - Elastic Compute Service - Centre de documentation Alibaba Cloud

Remplace le système d'exploitation d'une instance ECS en remplaçant son 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 attentivement Remplacer le disque système (remplacer le système d'exploitation).

Lors du remplacement du disque système, notez les points suivants :

Vous ne pouvez pas modifier le mode de facturation du disque système.
Vous ne pouvez pas modifier le type de disque du disque système.
L'instance ECS à laquelle le disque système est attaché ne doit avoir aucune commande impayée.
L'instance doit être dans l'état Stopped (Stopped).

Remarque
Cela s'applique uniquement aux instances de type VPC. Si l'instance ECS utilise le mode de facturation à l'usage et que le mode économique est activé par défaut, définissez l'instance sur le mode d'arrêt standard lors de son arrêt. Cela empêche l'instance de ne pas redémarrer après le remplacement du disque système en raison d'un inventaire d'instances ECS insuffisant dans la région. Pour plus d'informations, consultez StopInstance.
Vous pouvez utiliser le paramètre SystemDisk.Size pour spécifier une nouvelle capacité pour le disque système. La nouvelle capacité ne peut pas être inférieure à la capacité d'origine.
Si l'instance ECS est verrouillée pour des raisons de sécurité, c'est-à-dire que le paramètre OperationLocks de l'instance contient "LockReason": "security", le remplacement du disque système n'est pas pris en charge. Pour plus d'informations, consultez Comportement de l'API lorsqu'une instance est verrouillée pour des raisons de sécurité.

Après avoir remplacé le disque système, appelez DescribeInstances pour interroger l'état de l'instance et vérifier si le remplacement a réussi. Si la valeur OperationLocks renvoyée est vide, le remplacement du disque système est terminé.

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. Remarque Assurez-vous que l'instance cible est dans l'état Stopped avant d'envoyer la requête.	i-bp67acfmxazb4ph****
ImageId	string	Non	L'identifiant de l'image à utiliser lors de la réinitialisation du disque système. Ce paramètre est requis.	m-bp67acfmxazb4ph****
SystemDisk.Size	integer	Non	La nouvelle capacité du disque système. Unité : Gio. Valeurs valides : Disque basique : Max{20, taille de l'image spécifiée par le paramètre ImageId} à 500. SSD d'entreprise : PL0 : Max{1, taille de l'image spécifiée par le paramètre ImageId} à 2048. PL1 : Max{20, taille de l'image spécifiée par le paramètre ImageId} à 2048. PL2 : Max{461, taille de l'image spécifiée par le paramètre ImageId} à 2048. PL3 : Max{1261, taille de l'image spécifiée par le paramètre ImageId} à 2048. Disque ESSD AutoPL : Max{1, taille de l'image spécifiée par le paramètre ImageId} à 2048. Autres types de disques : Max{20, taille de l'image spécifiée par le paramètre ImageId} à 2048. Valeur par défaut : Max{40, taille de l'image spécifiée par le paramètre ImageId}. Remarque Une capacité de disque dépassant Max{20, capacité d'origine du disque système} entraîne des frais supplémentaires.	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 vous devez vous assurer que le jeton est unique parmi les différentes requêtes. ClientToken ne peut contenir que des caractères ASCII et ne peut 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 les configurations système de la machine virtuelle fournies par Alibaba Cloud doivent être utilisées (Windows : NTP et KMS. Linux : NTP et YUM). Remarque Ce paramètre prend effet uniquement lorsque le disque système est attaché (c'est-à-dire que le nom du périphérique est /dev/xvda).	true
Password	string	Non	Indique si le mot de passe de l'instance ECS doit être réinitialisé. 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 : ()`~!@#$%^&-_+=\|{}[]:;'<>,.?/ Pour les instances Windows, le mot de passe ne peut pas commencer par une barre oblique (/). Valeur par défaut : le mot de passe reste inchangé. Remarque* Si vous spécifiez le paramètre Password, utilisez HTTPS pour envoyer la requête afin d'éviter les fuites de mot de passe.	EcsV587!
PasswordInherit	boolean	Non	Indique si le mot de passe prédéfini de l'image doit être utilisé. Valeur par défaut : false. Remarque Si vous utilisez ce paramètre, le paramètre Password doit être vide. Assurez-vous que l'image que vous utilisez possède un mot de passe prédéfini.	false
KeyPairName	string	Non	Le nom de la paire de clés. Remarque Ce paramètre s'applique uniquement aux instances ECS Linux. Vous pouvez lier une paire de clés SSH à une instance ECS comme identifiant de connexion. Une fois une paire de clés SSH liée, la connexion par nom d'utilisateur et mot de passe est désactivée.	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 [Obsolète] Ce paramètre est obsolète.	CentOS
Architecture	string	Non	Remarque [Obsolète] Ce paramètre est obsolète.	i386
SecurityEnhancementStrategy	string	Non	Indique si Security Center doit être utilisé gratuitement après le remplacement du disque système. Valeurs valides : Active : utilise Security Center. Cette valeur est prise en charge uniquement pour les images publiques. Deactive : n'utilise pas Security Center. Cette valeur est prise en charge pour toutes les images. Valeur par défaut : Deactive.	Active
Encrypted	boolean	Non	Indique si le disque doit être chiffré. Valeurs valides : true : chiffre le disque. false : ne chiffre pas le disque. Valeur par défaut : false. Important Lorsque vous utilisez une image chiffrée partagée pour créer un disque basé sur un instantané chiffré, vous devez définir le paramètre de requête Encrypted=true pour le disque afin de garantir que le disque utilise la clé du compte qui reçoit l'image partagée.	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.	hide
Arn	array<object>	Non	Ce paramètre n'est pas disponible.
	object	Non
AssumeRoleFor	integer	Non	Remarque Ce paramètre n'est pas disponible.	0
RoleType	string	Non	Remarque Ce paramètre n'est pas disponible.	null
Rolearn	string	Non	Remarque Ce paramètre n'est pas disponible.	null

É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.	Cette image ne prend pas en charge la connexion 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.	Les paramètres entrent en conflit.
400	InvalidSystemDiskSize.ImageNotSupportResize	The specified image does not support resize.	L'image spécifiée ne prend pas en charge le redimensionnement.
400	InvalidSystemDiskSize	The specified parameter SystemDisk.Size is invalid.
400	InvalidPassword.Malformed	The specified parameter "Password" is not valid.	Le paramètre Password spécifié n'est pas valide.
400	InvalidPasswordParam.Mismatch	The input password should be null when passwdInherit is true.	Lorsque PasswdInherit est activé, le nom d'utilisateur et le mot de passe doivent être vides.
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.	Le type de disque système et le type de disque de données spécifiés ne sont pas pris en charge.
400	InvalidKeyPairName.NotFound	The specified KeyPairName does not exist.	Le KeyPairName spécifié n'existe pas.
400	DependencyViolation.IoOptimize	The specified parameter InstanceId is not valid.	L'identifiant d'instance spécifié n'est pas valide, ou la configuration d'optimisation des E/S de l'instance n'est pas valide.
400	MissingParameter.Architecture	Architecture should not be null.	Le paramètre Architecture ne peut pas être vide.
400	InvalidArchitecture.Malformed	Architecture is not valid.	Le format du paramètre Architecture n'est pas valide.
400	MissingParameter.Platform	Platform should not be null.	Le paramètre Platform ne peut pas être vide.
400	InvalidPlatform.Malformed	Platform is not valid.	La distribution du système d'exploitation de l'image spécifiée n'est pas valide.
400	InvalidDiskId.NotFound	The specified disk do not exist.	Le disque spécifié n'existe pas. Vérifiez que l'identifiant du disque est correct.
400	InvalidDatadisk.DiskStatusViolation	The operation is not permitted due to status of the Datadisk.	L'état actuel du disque cloud de données ne prend pas en charge cette opération.
400	InvalidDatadisk.DiskCategoryViolation	The operation is not permitted due to category of the Datadisk.	Le type de disque cloud de données ne prend pas en charge cette opération.
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.	L'instance spécifiée n'a pas de disque système attaché. Assurez-vous que l'instance spécifiée possède un disque système attaché. Vous pouvez appeler DescribeInstances pour interroger les informations de l'instance spécifiée.
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.	Le type d'instance spécifié n'est pas pris en charge.
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.	La capacité disponible du cluster de stockage dédié sur lequel réside le disque est insuffisante.
400	QuotaExceed.DiskCapacity	The used capacity of disk type has exceeded the quota in the zone, %s.	La capacité utilisée du type de disque spécifié dépasse la limite de quota de la zone. Accédez au Centre de quotas pour consulter et demander une augmentation du quota de capacité de disque.
400	AccountForbidden.ProductCreationLimited	The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.	Les clients de migration vers le cloud pour les entreprises ne peuvent acheter que des instances ECS à la demande et ne peuvent pas acheter de produits tiers tels que des images fournies par Alibaba Cloud Marketplace. Vérifiez les paramètres et réessayez avec des paramètres valides.
400	InternalError	The requested services is not available now. Please try again later.	Une erreur interne s'est produite. Réessayez.
400	InvalidDiskName.Malformed	The specified parameter "SyatemDisk.DiskName or DataDisk.n.DiskName" is not valid.	Le format du nom du disque n'est pas valide. Le nom doit comporter entre 2 et 128 caractères et doit commencer par une lettre ou un caractère chinois. Il peut contenir des chiffres, des points (.), des traits de soulignement (_) ou des traits d'union (-). Il ne peut pas commencer par http:// ou https://.
400	InvalidParameter.Encrypted	Creating non-encrypted disks from encrypted snapshots is not allowed. Please set Encrypted to true or use an unencrypted snapshot.
400	InvalidParam.EncryptedMismatch	Creating a disk from a shared encrypted image requires encryption with your own KMS key. Please set the Encrypted parameter to true.
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 instance must be in the Stopped state when you replace the system disk. Please stop the instance and try again.
403	InstanceLockedForSecurity	The instance is locked due to security.	L'instance à laquelle le disque est attaché est verrouillée pour des raisons de sécurité.
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	OperationDenied.ImageNotValid	The specified marketplace image is not authorized. Please verify the marketplace image authorization and try again.
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	Le paramètre spécifié est invalide. Vérifiez si les paramètres sont en conflit.
403	ResourcesNotInSameZone	The specified instance and disk are not in the same zone.
403	OperationDenied.UnpaidOrder	The specified instance has unpaid order.	Une commande impayée existe déjà pour l'identifiant d'instance spécifié. Vous pouvez vous connecter à la console ECS pour finaliser le paiement.
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.	L'opération n'est pas autorisée car l'instance ne remplit pas les conditions requises pour activer l'option d'hibernation.
403	InvalidOperation.MultiAttachDisk	Multi attach disk does not support this operation.	Cette opération n'est pas prise en charge pour les disques avec l'attachement multiple activé.
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 EncryptAlgorithm is not valid. Ensure the value is a supported encryption algorithm such as AES-256.
403	InvalidEncrypted.NotMatchKmsKeyId	The Encrypted parameter must be set to true when KMSKeyId is specified. Please adjust the parameters and try again.
403	InvalidEncrypted.NotMatchEncryptAlgorithm	The Encrypted parameter must be set to true when EncryptAlgorithm is specified. Please adjust the parameters and try again.
403	InvalidParameter.KmsNotEnabled	The specified operation need enable KMS.
403	InvalidParameter.DataEncryptedKeyCreateFailed	The ECS service is not authorized to access your KMS key. Please grant the ECS service permission to use the key and try again.
403	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
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 KMSKeyId must be a symmetric key. Please use a symmetric KMS key such as an AES-256 key.
403	InvalidDiskId.NotSupportReplaceEncryptedSystemDisk	The specified diskId not support replace encrypted system disk.
403	NotSupportSnapshotEncrypted.DiskCategory	The specified disk category does not support re-encrypting a disk with a new KMSKeyId from a snapshot. Please use a disk category that supports encryption such as cloud_essd.
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.	Aucun paramètre n'a été spécifié. Spécifiez les paramètres requis.
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.	Les paramètres entrent en conflit.
403	OperationDenied	The current region does not support changing the image type.	L'instantané spécifié ne permet pas la création de volumes de données.
403	OperationDenied.DiskNoStock	The requested disk category is sold out in the specified zone. Please try a different disk category or another zone.	Le type de disque spécifié est en rupture de stock dans la zone spécifiée. Utilisez un autre type de disque ou une autre zone et réessayez.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The specified KMS key must be in an enabled state. Please enable the key in the KMS console and try again.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The specified KMS key is not authorized for the ECS service. Please grant the ECS service permission to use the key in the KMS console and try again.
403	InvalidEncrypted.NotMatchSnapshot	The Encrypted parameter must be set to true when creating disks from encrypted snapshots. Please set Encrypted to true or use an unencrypted snapshot.
403	InvalidEncrypted.NotMatchDiskDefaultEncryption	The operation failed because default disk encryption is enforced on your account. Please set the Encrypted parameter to true.
403	InvalidPayMethod.SyncPaymentNotSupport	Synchronous payment is not supported. Use another payment method.	Le paiement automatique n'est pas pris en charge dans l'état actuel. Définissez le paramètre AutoPay sur un autre mode de paiement.
403	InvalidOperation.ImageSecureBootUnsupported	The image does not support secure boot.	L'image ne prend pas en charge le démarrage sécurisé.
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.
403	InvalidOperation.TargetImageIncompatible	The source image cannot be replaced by the target image.	L'image cible spécifiée ne peut pas remplacer l'image actuelle.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	L'instance spécifiée n'existe pas. Vérifiez si l'identifiant de l'instance est correct.
404	InvalidImageId.NotFound	The specified ImageId does not exist.	L'image spécifiée n'existe pas sous ce compte. Vérifiez si l'identifiant de l'image est correct.
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.	La ressource spécifiée n'existe pas.

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

Notes de version

Consultez Notes de version pour la liste complète.