Remplace le système d'exploitation d'une instance Elastic Compute Service (ECS). Cette opération libère le disque d'origine et crée un nouveau disque système, ce qui modifie l'ID du disque système.
Remarques sur l'utilisation
Tenez compte des points suivants :
La catégorie du disque système ne peut pas être modifiée.
La méthode de facturation du disque système ne peut pas être modifiée.
-
L'instance doit être à l'état Stopped.
RemarqueCe point s'applique uniquement aux instances hébergées dans des réseaux privés virtuels (VPC). Si l'instance est une instance en paiement à l'utilisation et que le mode économique est activé par défaut, désactivez le mode économique et activez le mode standard lors de l'arrêt de l'instance. Cela évite l'impossibilité de redémarrer l'instance en raison de ressources ECS insuffisantes après le remplacement du disque système. Pour plus d'informations, consultez StopInstance.
Si la réponse contient {"OperationLocks": {"LockReason" : "security"}}, l'instance est verrouillée pour des raisons de sécurité et aucune opération n'est autorisée dessus. Pour plus d'informations, consultez API behavior when an instance is locked for security reasons.
Aucune commande impayée ne doit être associée à l'instance.
Configurez le paramètre SystemDisk.Size pour spécifier la capacité du nouveau disque système.
Après avoir appelé cette opération, utilisez l'une des méthodes suivantes pour vérifier si le disque système a été remplacé :
Appelez l'opération DescribeDisks pour interroger l'état du nouveau disque système. Si le nouveau disque système est à l'état In_use, le remplacement a bien eu lieu.
Appelez l'opération DescribeInstances pour interroger l'état de l'instance dont le disque système a été remplacé. Si le paramètre de réponse OperationLocks est vide, le remplacement a bien eu lieu.
Débogage
Paramètres de requête
Parameter | Type | Required | Example | Description |
Action | String | Yes | ReplaceSystemDisk | Opération à effectuer. Définissez la valeur sur ReplaceSystemDisk. |
InstanceId | String | Yes | i-bp67acfmxazb4ph**** | ID de l'instance. |
ImageId | String | No | m-bp67acfmxazb4ph**** | ID de l'image à utiliser pour remplacer le disque système. Si vous ne configurez pas le paramètre |
SystemDisk.Size | Integer | No | 80 | Capacité du nouveau disque système. Unité : GiB. Valeurs valides :
Valeur par défaut : Max{40, Taille de l'image spécifiée par le paramètre ImageId}. Remarque Si la capacité du nouveau disque système dépasse |
ClientToken | String | No | 123e4567-e89b-12d3-a456-426655440000 | 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 qu'il est unique parmi différentes requêtes. Le jeton 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. |
UseAdditionalService | Boolean | No | true | Indique s'il faut utiliser les configurations système pour les machines virtuelles fournies par Alibaba Cloud. Configurations système pour Windows : NTP et KMS. Configurations système pour Linux : NTP et YUM. Remarque Ce paramètre prend effet uniquement si vous attachez un disque système dont le nom de périphérique est /dev/xvda. |
Password | String | No | EcsV587! | Indique s'il faut réinitialiser le mot de passe de l'instance. Le mot de passe doit comporter entre 8 et 30 caractères et contenir au moins trois des types de caractères suivants : lettres majuscules, lettres minuscules, chiffres et caractères spéciaux. Le mot de passe peut contenir les caractères spéciaux suivants : Le mot de passe d'une instance Windows ne peut pas commencer par une barre oblique (/). Ce paramètre est vide par défaut, ce qui indique que le mot de passe actuel reste inchangé. Remarque Pour des raisons de sécurité, nous vous recommandons d'utiliser HTTPS pour envoyer des requêtes si le paramètre |
PasswordInherit | Boolean | No | false | Indique s'il faut utiliser le mot de passe prédéfini dans l'image. Valeur par défaut : false. Remarque Si vous configurez le paramètre PasswordInherit, vous devez laisser le paramètre Password vide et vous assurer que l'image sélectionnée dispose d'un mot de passe prédéfini. |
KeyPairName | String | No | testKeyPairName | 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 à l'instance comme identifiant de connexion. Une fois la paire de clés SSH associée, la méthode de connexion par nom d'utilisateur et mot de passe est désactivée pour l'instance. |
DiskId | String | No | d-bp67acfmxazb4ph**** | Remarque Ce paramètre est obsolète. Nous vous recommandons d'utiliser le paramètre |
Platform | String | No | CentOS | Remarque Ce paramètre est obsolète. |
Architecture | String | No | i386 | Remarque Ce paramètre est obsolète. |
SecurityEnhancementStrategy | String | No | Active | Indique s'il faut utiliser Security Center gratuitement après le remplacement du disque système. Valeurs valides :
Valeur par défaut : Deactive. |
Encrypted | Boolean | No | false | Indique s'il faut chiffrer le nouveau disque système. Valeurs valides :
Valeur par défaut : false. |
KMSKeyId | String | No | e522b26d-abf6-4e0d-b5da-04b73c | ID de la clé Key Management Service (KMS) à utiliser pour le disque système. |
EncryptAlgorithm | String | No | hide | Remarque Ce paramètre n'est pas disponible publiquement. |
Arn.N.RoleType | String | No | null | Remarque Ce paramètre n'est pas disponible publiquement. |
Arn.N.Rolearn | String | No | null | Remarque Ce paramètre n'est pas disponible publiquement. |
Arn.N.AssumeRoleFor | Long | No | 0 | Remarque Ce paramètre n'est pas disponible publiquement. |
Paramètres de réponse
|
Parameter |
Type |
Example |
Description |
|
DiskId |
String |
d-bp67acfmxazb4ph**** |
ID du nouveau disque système. |
|
RequestId |
String |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
ID de la requête. |
Exemples
Exemples de requêtes
http(s)://ecs.aliyuncs.com/?Action=ReplaceSystemDisk
&InstanceId=i-bp67acfmxazb4ph****
&ImageId=m-bp67acfmxazb4ph****
&SystemDisk.Size=80
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&UseAdditionalService=true
&Password=EcsV587!
&PasswordInherit=false
&KeyPairName=testKeyPairName
&SecurityEnhancementStrategy=Active
&<Common request parameters>Exemples de réponses réussies
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<ReplaceSystemDiskResponse>
<DiskId>d-bp67acfmxazb4ph****</DiskId>
<RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ReplaceSystemDiskResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "337568C5-64F3-4B76-8CDD-D3D8C57B5B8C",
"DiskId" : "d-bp67acfmxazb4ph****"
}Codes d'erreur
|
HTTP status code |
Error code |
Error message |
Description |
|
400 |
LoginAsNonRoot.ImageNotSupport |
The specified image does not support login as non-root. |
L'image ne prend pas en charge les connexions des utilisateurs non root. |
|
400 |
InvalidSystemDiskSize.ValueNotSupported |
The specified parameter SystemDisk.Size is invalid. |
Valeur SystemDisk.Size non valide. |
|
400 |
InvalidParameter.Conflict |
The specified image does not support the specified instance type. |
L'image ne peut pas être utilisée pour les instances du type d'instance spécifié. |
|
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. |
Valeur SystemDisk.Size non valide. |
|
400 |
InvalidPasswordParam.Mismatch |
The input password should be null when passwdInherit is true. |
Le mot de passe n'est pas laissé vide lorsque PasswdInherit est défini sur true. |
|
400 |
OperationDenied |
The specified image contains the snapshot of the data disk,does not support this operation. |
L'opération n'est pas autorisée lorsque l'image spécifiée contient des snapshots de disques de données. |
|
400 |
InvalidParameter.Conflict |
%s |
Valeur de paramètre non valide. Vérifiez s'il existe des conflits de paramètres. %s est une variable. Un message d'erreur est renvoyé dynamiquement en fonction des conditions d'appel. |
|
400 |
InvalidSystemDiskSize.ValueNotSupported |
%s |
Valeur SystemDisk.Size non valide. |
|
400 |
OperationDenied |
%s |
L'opération est refusée. |
|
400 |
InvalidKeyPairName.NotFound |
The specified KeyPairName does not exist. |
Le KeyPairName est introuvable. |
|
400 |
DependencyViolation.IoOptimize |
The specified parameter InstanceId is not valid. |
Configuration d'optimisation des E/S de l'instance non valide. |
|
400 |
MissingParameter.Architecture |
Architecture should not be null. |
Architecture est requis. |
|
400 |
InvalidArchitecture.Malformed |
Architecture is not valid. |
Valeur Architecture non valide. |
|
400 |
MissingParameter.Platform |
Platform should not be null. |
Platform est requis. |
|
400 |
InvalidPlatform.Malformed |
Platform is not valid. |
Valeur Platform non valide. |
|
400 |
InvalidParameter.AllEmpty |
%s |
Les paramètres requis ne sont pas spécifiés. |
|
400 |
InvalidDiskId.NotFound |
The specified disk do not exist. |
Le DiskId est introuvable. |
|
400 |
InvalidDatadisk.DiskStatusViolation |
The operation is not permitted due to status of the Datadisk. |
Le disque de données dans l'état actuel ne prend pas en charge cette opération. |
|
400 |
InvalidDatadisk.DiskCategoryViolation |
The operation is not permitted due to category of the Datadisk. |
Le disque de données de cette catégorie ne prend pas en charge cette opération. |
|
400 |
InvalidSystemDiskSize.ValueNotSupported |
The specified SystemDiskSize is not valid. |
Valeur SystemDisk.Size non valide. |
|
400 |
InvalidInstance.NotFoundSystemDisk |
The specified instance has no system disk. |
Aucun disque système n'est attaché à l'instance spécifiée. Assurez-vous qu'un disque système est attaché à l'instance spécifiée. Vous pouvez appeler l'opération DescribeInstances pour interroger les détails de l'instance. |
|
400 |
InvalidStorageClusterId.CapacityNotEnough |
The remaining capacity of the current dedicated storage cluster is less than the size of disk. |
La capacité restante du cluster de stockage bloc dédié auquel appartient 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 des disques appartenant à la catégorie de disque spécifiée dépasse la limite de quota pour la zone. Vous pouvez accéder au Quota Center pour afficher et augmenter le quota de capacité des disques. |
|
403 |
InvalidSystemDiskStatus.IsTransfering |
The current status of the resource does not support this operation, system disk is transfering. |
La ressource dans l'état actuel ne prend pas en charge cette opération. Réessayez après l'arrêt du transfert des données du disque système. |
|
403 |
IncorrectDiskStatus |
The current disk status does not support this operation. |
Cette opération ne peut pas être effectuée sur le disque dans l'état actuel. Assurez-vous que le disque est disponible et qu'aucun paiement n'est en retard pour celui-ci. |
|
403 |
IncorrectInstanceStatus |
The current status of the resource does not support this operation. |
La ressource dans l'état actuel ne prend pas en charge cette opération. |
|
403 |
InstanceLockedForSecurity |
The instance is locked due to security. |
L'opération n'est pas autorisée lorsque la ressource est verrouillée pour des raisons de sécurité. |
|
403 |
ImageNotSubscribed |
The specified image has not be subscribed. |
Vous n'avez pas souscrit à l'image sur Alibaba Cloud Marketplace. |
|
403 |
ImageRemovedInMarket |
The specified market image is not available, Or the specified user defined image includes product code because it is based on an image subscribed from marketplace, and that image in marketplace includeing exact the same product code has been removed. |
L'image Alibaba Cloud Marketplace n'est pas disponible, ou l'image personnalisée contient le code produit de l'image Alibaba Cloud Marketplace à partir de laquelle l'image personnalisée est dérivée et l'image Alibaba Cloud Marketplace a été supprimée d'Alibaba Cloud Marketplace. |
|
403 |
InstanceExpiredOrInArrears |
The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). |
L'instance a expiré ou présente un paiement en retard. Renouvelez ou effectuez le paiement pour l'instance et réessayez. |
|
403 |
ChargeTypeViolation |
The operation is not permitted due to charge type of the instance. |
Cette opération ne peut pas être effectuée sur l'instance utilisant la méthode de facturation actuelle. |
|
403 |
DiskCreatingSnapshot |
The operation is denied due to a snapshot of the specified disk is not completed yet. |
Un snapshot est en cours de création pour le disque spécifié. |
|
403 |
IoOptimized.NotSupported |
The specified image is not support IoOptimized Instance. |
L'image ne prend pas en charge les instances optimisées pour les E/S. |
|
403 |
ImageNotSupportInstanceType |
The specified image don not support the InstanceType instance. |
L'image spécifiée ne prend pas en charge le type d'instance. |
|
403 |
QuotaExceed.BuyImage |
The specified image is from the image market,You have not bought it or your quota has been exceeded. |
Vous n'avez pas acheté l'image Alibaba Cloud Marketplace spécifiée ou votre quota d'images a été épuisé. |
|
403 |
INST_HAS_UNPAID_ORDER |
The instance has unpaid order. |
Votre compte comporte des commandes impayées pour l'instance. |
|
403 |
OperationDenied.InstanceCreating |
The specified instance is creating. |
L'instance spécifiée est en cours de création. |
|
403 |
InvalidParameter.NotMatch |
%s |
Valeur de paramètre non valide. Vérifiez s'il existe des conflits de paramètres. |
|
403 |
ResourcesNotInSameZone |
The specified instance and disk are not in the same zone. |
L'instance et le disque ne résident pas dans la même zone. |
|
403 |
ImageNotSupportInstanceType |
The specified instanceType is not supported by instance with marketplace image. |
L'image Alibaba Cloud Marketplace spécifiée ne prend pas en charge le type d'instance. |
|
403 |
OperationDenied.UnpaidOrder |
The specified instance has unpaid order. |
Vous avez des commandes impayées pour l'instance. Vous pouvez vous connecter à la console ECS pour payer les commandes. |
|
403 |
OperationDenied.ImageNotValid |
%s |
L'image ne prend pas en charge cette opération. |
|
403 |
HibernationConfigured.InstanceOperationForbidden |
The operation is not permitted due to limit of the hibernation configured instance. |
L'opération n'est pas autorisée en raison des limites des instances pour lesquelles la fonctionnalité d'hibernation est activée. |
|
403 |
InvalidOperation.MultiAttachDisk |
Multi attach disk does not support this operation. |
Le disque pour lequel la fonctionnalité multi-attach est activée ne prend pas en charge cette opération. |
|
403 |
InvalidParameter.KmsNotEnabled |
The specified operation need enable KMS. |
Vous devez activer KMS. |
|
403 |
InvalidParameter.KMSKeyId.NotFound |
The specified KMSKeyId does not exist. |
Le KMSKeyId est introuvable. |
|
403 |
InvalidParameter.KMSKeyId.CMKNotEnabled |
The CMK needs to be enabled. |
La CMK n'est pas activée lorsque l'ID de la CMK est spécifié pour un disque. Vous pouvez appeler l'opération DescribeKey de KMS pour interroger les informations sur la CMK spécifiée. |
|
403 |
InvalidParameter.KMSKeyId.KMSUnauthorized |
ECS service have no right to access your KMS. |
ECS n'est pas autorisé à accéder à vos ressources KMS. |
|
404 |
InvalidInstanceId.NotFound |
The specified InstanceId does not exist. |
L'InstanceId est introuvable. |
|
404 |
InvalidInstanceId.NotFound |
The specified instance does not exist. |
L'instance est introuvable. Vérifiez si l'ID de l'instance est correct. |
|
404 |
InvalidImageId.NotFound |
The specified ImageId does not exist. |
L'image est introuvable dans ce compte. Vérifiez si l'ID de l'image est correct. |
|
404 |
InvalidSystemDiskSize.MoreThanMaxSize |
The specified SystemDisk.Size parameter exceeds the maximum size. |
La taille maximale du disque système est dépassée. |
|
404 |
InvalidSystemDiskSize.LessThanImageSize |
The specified parameter SystemDisk.Size is less than the image size. |
La taille du disque système est inférieure à la taille de l'image. |
|
404 |
InvalidSystemDiskSize.LessThanMinSize |
The specified parameter SystemDisk.Size is less than the min size. |
La taille du disque système spécifiée est inférieure à la taille minimale autorisée. |
|
404 |
NoSuchResource |
The specified resource is not found. |
La ressource spécifiée est introuvable. |
|
500 |
OperationDenied |
Internal Error. |
Une erreur interne s'est produite. |
|
500 |
InternalError |
The request processing has failed due to some unknown error. |
Une erreur interne s'est produite. Réessayez plus tard. |
|
500 |
InternalError |
The request processing has failed due to some unknown error, exception or failure. |
Une erreur interne s'est produite. Réessayez plus tard. |
Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.