ModifyInstanceSpec - - Centre de documentation Alibaba Cloud

Modifie le type d'instance et la bande passante publique d'une instance Elastic Compute Service (ECS) en paiement à l'utilisation.

Notes d'utilisation

Pour savoir comment utiliser le SDK ECS pour Python afin de modifier les configurations des ressources, consultez la rubrique Interroger les ressources disponibles pour les modifications de configuration.

Tenez compte des points suivants :

Vérifiez qu'aucun paiement n'est en souffrance sur votre compte.
Vous ne pouvez ajuster la bande passante publique d'une instance que si celle-ci se trouve dans l'état Running ou Stopped.
Avant de modifier le type d'instance d'une instance en paiement à l'utilisation, appelez l'opération DescribeResourcesModification pour interroger les types d'instances compatibles.
La modification du type d'instance n'est possible que lorsque l'instance est à l'état Stopped.
Il est impossible de modifier simultanément le type d'instance et la bande passante publique.
Depuis le 27 novembre 2020, la bande passante totale disponible pour toutes les instances (nouvelles et modifiées) est soumise aux politiques de limitation de débit de votre compte. Pour augmenter la limite de bande passante, soumettez un ticket. Les politiques de limitation suivantes s'appliquent :
- Dans une seule région, la somme des bandes passantes de pointe réelles de toutes les instances ECS utilisant la méthode de facturation « paiement au trafic » pour l'utilisation du réseau ne peut pas dépasser 5 Gbit/s.
- Dans une seule région, la somme des bandes passantes de pointe réelles de toutes les instances ECS utilisant la méthode de facturation « paiement à la bande passante » pour l'utilisation du réseau ne peut pas dépasser 50 Gbit/s.

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ètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ModifyInstanceSpec	Opération à effectuer. Définissez la valeur sur ModifyInstanceSpec.
InstanceId	String	Oui	i-bp67acfmxazb4p****	ID de l'instance.
InstanceType	String	Non	ecs.g6.large	Nouveau type d'instance. Pour plus d'informations, consultez la rubrique Présentation des familles d'instances. Vous pouvez également appeler l'opération DescribeInstanceTypes pour interroger la liste la plus récente des types d'instances.
InternetMaxBandwidthOut	Integer	Non	10	Bande passante publique sortante maximale. Unité : Mbit/s. Valeurs valides : 0 à 100. Remarque Lorsque la méthode de facturation paiement au trafic est utilisée pour l'utilisation du réseau, les valeurs maximales de bande passante entrante et sortante sont utilisées comme limites supérieures de bande passante plutôt que comme performances garanties. Dans les scénarios où la demande dépasse l'offre de ressources, ces valeurs maximales de bande passante peuvent ne pas être atteintes. Si vous souhaitez une bande passante garantie pour votre instance, nous vous recommandons d'utiliser la méthode de facturation paiement à la bande passante.
InternetMaxBandwidthIn	Integer	Non	10	Bande passante publique entrante maximale. Unité : Mbit/s. Valeurs valides : Lorsque la bande passante publique sortante achetée est inférieure ou égale à 10 Mbit/s, les valeurs valides de ce paramètre sont comprises entre 1 et 10, et la valeur par défaut est 10. Lorsque la bande passante publique sortante achetée est supérieure à 10 Mbit/s, les valeurs valides de ce paramètre sont comprises entre 1 et la valeur `InternetMaxBandwidthOut`, et la valeur par défaut est la valeur `InternetMaxBandwidthOut`. Remarque Lorsque la méthode de facturation paiement au trafic est utilisée pour l'utilisation du réseau, les bandes passantes maximales entrantes et sortantes sont utilisées comme limites supérieures de bande passante plutôt que comme performances garanties. Dans les scénarios où la demande dépasse l'offre de ressources, ces valeurs maximales de bande passante peuvent ne pas être atteintes. Si vous souhaitez une bande passante garantie pour votre instance, nous vous recommandons d'utiliser la méthode de facturation paiement à la bande passante.
Temporary.StartTime	String	Non	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
Temporary.EndTime	String	Non	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
Temporary.InternetMaxBandwidthOut	Integer	Non	null	Remarque Ce paramètre est en aperçu sur invitation et n'est pas disponible publiquement.
Async	Boolean	Non	false	Indique s'il faut soumettre une requête asynchrone. Valeurs valides : true false Valeur par défaut : false.
AllowMigrateAcrossZone	Boolean	Non	false	Indique si les mises à niveau de type d'instance inter-clusters sont prises en charge. true false Valeur par défaut : false. Lorsque `AllowMigrateAcrossZone` est défini sur true et que vous mettez à niveau l'instance en fonction des informations renvoyées, tenez compte des points suivants : Instance résidant dans le réseau classique : Pour les types d'instances retirés, l'adresse IP privée, les noms de périphériques de disque et les codes d'autorisation logicielle d'une instance non optimisée pour les E/S changent lorsque vous mettez à niveau l'instance vers une instance optimisée pour les E/S. Pour les instances Linux, les disques basiques (`cloud`) sont identifiés comme xvd* tels que xvda et xvdb, et les disques ultra (`cloud_efficiency`) et les SSD standard (`cloud_ssd`) sont identifiés comme vd* tels que vda et vdb. Pour les familles d'instances disponibles à l'achat, lorsque le type d'instance d'une instance est modifié, l'adresse IP privée de l'instance change également. Pour plus d'informations, consultez la rubrique Présentation des familles d'instances. Instance résidant dans un cloud privé virtuel (VPC) : Pour les types d'instances retirés, lorsqu'une instance non optimisée pour les E/S est mise à niveau vers une instance optimisée pour les E/S, les noms de périphériques de disque et les codes d'autorisation logicielle de l'instance changent. Pour plus d'informations, consultez la rubrique Types d'instances retirés. Pour les instances Linux, les disques basiques (`cloud`) sont identifiés comme xvd tels que xvda et xvdb, et les disques ultra (`cloud_efficiency`) et les SSD standard (`cloud_ssd`) sont identifiés comme vd tels que vda et vdb.
SystemDisk.Category	String	Non	cloud_ssd	Nouvelle catégorie du disque système. Valeurs valides : cloud_efficiency : disque ultra. cloud_ssd : SSD standard. Remarque Ce paramètre n'est valide que lorsque vous mettez à niveau une instance d'un type d'instance retiré vers un type d'instance disponible ou lorsque vous mettez à niveau une instance non optimisée pour les E/S vers une instance optimisée pour les E/S. Pour plus d'informations, consultez les rubriques Types d'instances retirés et Présentation des familles d'instances.
ClientToken	String	Non	0c593ea1-3bea-11e9-b96b-88e9fe637760	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 différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez la rubrique Comment garantir l'idempotence.
ModifyMode	String	Non	null	Remarque Ce paramètre n'est pas disponible publiquement.
Disk.N.DiskId	String	Non	null	Remarque Ce paramètre n'est pas disponible publiquement.
Disk.N.Category	String	Non	null	Remarque Ce paramètre n'est pas disponible publiquement.
Disk.N.PerformanceLevel	String	Non	null	Remarque Ce paramètre n'est pas disponible publiquement.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=ModifyInstanceSpec
&InstanceId=i-bp67acfmxazb4p****
&InstanceType=ecs.g6.large
&InternetMaxBandwidthOut=10
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe637760
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<ModifyInstanceSpecResponse>
   <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</ModifyInstanceSpecResponse>

JSON format

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

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	Méthode de facturation invalide pour l'utilisation du réseau.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType does not exist or beyond the permitted range.	Le type d'instance est introuvable ou vous n'êtes pas autorisé à gérer les instances de ce type.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	Vous n'êtes pas autorisé à utiliser ce type d'instance.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	Le type d'instance est introuvable ou vous n'êtes pas autorisé à gérer les instances de ce type.
400	InvalidParameter.Mismatch	Too many parameters in one request.	Le nombre maximal de paramètres dans la requête est dépassé.
400	BandwidthUpgradeDenied.EipBoundInstance	The specified VPC instance has bound EIP, temporary bandwidth upgrade is denied.	L'instance est associée à une adresse IP élastique (EIP) et la bande passante réseau de l'instance ne peut pas être temporairement augmentée.
400	InvalidTemporary.StartTime	The specifed Temporary.StartTime is not valid.	L'heure de début spécifiée pour la période de mise à niveau temporaire est invalide.
400	InvalidTemporary.EndTime	The specifed Temporary.EndTime is not valid.	Valeur Temporary.EndTime invalide.
400	Downgrade.NotSupported	Downgrade operation is not supported.	Les rétrogradations de configuration ne sont pas prises en charge.
400	DependencyViolation.InstanceType	The current InstanceType cannot be changed to the specified InstanceType.	Vous ne pouvez pas modifier l'instance vers le type d'instance spécifié.
400	Account.Arrearage	Your account has an outstanding payment.	Vous avez des commandes impayées sur votre compte.
400	InvalidParameter.Bandwidth	The specified parameter Bandwidth is not valid.	Bande passante invalide.
400	InvalidParameter.Conflict	The specified image does not support the specified instance type.	L'image spécifiée ne peut pas être utilisée avec le type d'instance spécifié.
400	InvalidParameter.AllowMigrateAcrossZone	The specified parameter CanMigrateAcrossZone is not valid.	Valeur AllowMigrateAcrossZone invalide.
400	InvalidParam.SystemDiskCategory	The specified param SystemDisk.Category is not valid.	Valeur SystemDisk.Category invalide.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	Votre requête est limitée en débit. Réessayez dans 5 minutes.
400	InvalidInstanceStatus.NotStopped	The specified Instance status is not stopped.	L'instance spécifiée n'est pas à l'état Stopped.
400	InvalidAction	Specified action is not valid.	L'opération est invalide.
400	IdempotenceParamNotMatch	There is a idempotence signature mismatch between this and last request.	Cette requête et la précédente contiennent le même jeton client mais d'autres paramètres différents.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	Valeur ClientToken invalide.
400	Price.PricePlanResultNotFound	The internetMaxBandwidthIn or internetMaxBandwidthOut provided is invalid.	Valeur InternetMaxBandwidthIn ou InternetMaxBandwidthOut invalide.
400	InvalidAction.NotSupport	The ecs on dedicatedHost not support modify instanceType.	Vous ne pouvez pas modifier les types d'instances des instances hébergées sur des hôtes dédiés.
400	InvalidMarketImageStatus.NotSupported	The status of specified market image does not support this operation.	Cette opération ne peut pas être effectuée sur l'image Alibaba Cloud Marketplace dans l'état actuel.
400	InvalidOperation.VpcHasEnabledAdvancedNetworkFeature	The specified vpc has enabled advanced network feature.	Les fonctionnalités avancées sont activées pour le VPC. Vous ne pouvez pas créer d'instances ECS avec des spécifications faibles dans ce VPC.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	Cette opération ne peut pas être effectuée lorsque PrivatePoolOptions.MatchCriteria est défini sur Target.
400	InvalidDiskCategory.NotSupported	The upgrade operation of instance does not support this category of disk.	L'opération de mise à niveau de configuration des instances ne prend pas en charge cette catégorie de disque.
400	QuotaExceed.DiskCapacity	The used capacity of disk type has exceeded the quota in the zone, %s.	La capacité des disques appartenant à la catégorie de disque spécifiée dépasse la limite de quota pour la zone. Accédez au Centre de quotas pour afficher et augmenter le quota.
400	InvalidParam.Async	The specified parameter async is not valid.	Valeur Async invalide.
403	CategoryViolation	The specified instance does not support this operation because of its disk category.	Les configurations des instances auxquelles sont attachés des disques locaux ne peuvent pas être modifiées.
403	InvalidStatus.ValueNotSupported	The current status of the resource does not support this operation.	Cette opération ne peut pas être effectuée sur la ressource dans l'état actuel.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	L'instance est verrouillée pour des raisons de sécurité.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Le solde du compte est insuffisant. Ajoutez des fonds à votre compte 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	OperationDenied	The specified instance is out of usage.	L'inventaire du type d'instance spécifié est insuffisant.
403	LastTokenProcessing	The last token request is processing.	Une requête de jeton est en cours de traitement. Réessayez ultérieurement.
403	InstanceSpecModification.NotEffective	The specified instance has been reserved for making a spec modification and not taken effective in the current contract period.	L'instance a été réservée pour un changement de type d'instance. Les modifications apportées à l'instance ne peuvent pas prendre effet pendant la période de contrat actuelle.
403	InvalidInstanceType.ValueNotSupported	The specified zone does not offer the specified instancetype.	Le type d'instance n'est pas disponible dans la région spécifiée.
403	ImageNotSupportInstanceType	The specified image do not support the InstanceType instance.	L'image spécifiée ne prend pas en charge le type d'instance.
403	InvalidParameter.NotMatch	%s	Paramètre invalide. Vérifiez s'il existe des conflits de paramètres.
403	InvalidInstance.EipNotSupport	The specified instance with eip is not supported, please unassociate eip first.	Cette opération ne peut pas être effectuée sur l'instance associée à une EIP. Dissociez d'abord l'EIP.
403	OperationDenied.NoStock	The resource is out of usage.	L'instance n'est pas à l'état Running. Démarrez l'instance ou vérifiez si l'opération est valide.
403	OperationDenied.UnpaidOrder	The specified instance has unpaid order.	Vous avez des commandes impayées pour l'instance. Connectez-vous à la console ECS pour payer les commandes.
403	OperationDenied	%s	L'opération est refusée.
403	InvalidOperation.Ipv4CountExceeded	%s	Le nombre maximal d'adresses IPv4 est dépassé.
403	InvalidOperation.Ipv6CountExceeded	%s	Le nombre maximal d'adresses IPv6 est dépassé.
403	InvalidOperation.Ipv6NotSupport	%s	Les adresses IPv6 ne prennent pas en charge cette opération.
403	InvalidOperation.InstanceWithEipNotSupport	The special instance with eip not support operate, please unassociate eip first.	Cette opération ne peut pas être effectuée sur l'instance associée à une EIP. Dissociez d'abord l'EIP.
403	SecurityRisk.3DVerification	We have detected a security risk with your default credit or debit card. Please proceed with verification via the link in your email.	Des risques ont été détectés sur votre carte de crédit ou de débit par défaut. Cliquez sur l'URL dans l'e-mail pour la vérification.
403	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.	Aucun disque système n'est attaché à l'instance. Assurez-vous que l'instance dispose d'un disque système attaché. Vous pouvez appeler l'opération DescribeInstances pour interroger les détails de l'instance.
403	InvalidInstanceType.NotSupportDiskCategory	The instanceType of the specified instance does not support this disk category.	Le type d'instance spécifié ne prend pas en charge les catégories de disque de l'instance. Essayez un autre type d'instance. Pour obtenir des informations sur les catégories de disque prises en charge par les types d'instance, consultez la documentation sur les familles d'instances.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	Le nombre maximal d'instances du type d'instance spécifié dans la région est dépassé. Essayez une autre région ou un autre type d'instance, ou réduisez le nombre d'instances que vous souhaitez créer. Vous pouvez également accéder à la console ECS ou au Centre de quotas pour demander une augmentation de quota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type.	Le nombre maximal d'instances du type d'instance spécifié dans la région est dépassé. Essayez une autre région ou un autre type d'instance, ou réduisez le nombre d'instances que vous souhaitez créer. Vous pouvez également accéder à la console ECS ou au Centre de quotas pour demander une augmentation de quota.
403	QuotaExceed.ElasticQuota	The number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	Le nombre maximal de vCPU pour tous les types d'instance est dépassé. Vous pouvez accéder à la console ECS ou au Centre de quotas pour demander une augmentation de quota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type, or the number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	Le nombre maximal d'instances du type d'instance spécifié dans la région ou le nombre maximal de vCPU pour tous les types d'instance est dépassé. Vous pouvez accéder à la console ECS ou au Centre de quotas pour demander une augmentation de quota.
403	InvalidOperation.InstanceTypeNotSupportEniTrunking	%s	L'opération n'est pas prise en charge. Pour plus d'informations, consultez la valeur renvoyée par l'espace réservé %s dans le message d'erreur.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	Le nombre maximal de files d'attente sur l'ENI est dépassé. Pour plus d'informations, consultez la valeur renvoyée par l'espace réservé %s dans le message d'erreur.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	Le nombre maximal de files d'attente pour toutes les ENI sur une instance est dépassé. Pour plus d'informations, consultez la valeur renvoyée par l'espace réservé %s dans le message d'erreur.
403	InvalidParameter.InvalidEniQueueNumber	%s	Nombre de files d'attente invalide pour une ENI. Pour plus d'informations, consultez la valeur renvoyée par l'espace réservé %s dans le message d'erreur.
403	HibernationConfigured.InstanceOperationForbidden	The operation is not permitted due to limit of the hibernation configured instance.	L'opération ne peut pas être effectuée en raison des limitations des instances pour lesquelles la fonctionnalité de mise en veille prolongée est activée.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	L'ID d'instance est introuvable.
404	MissingTemporary.StartTime	Temporary.StartTime is not specified.	L'heure de début de la période de mise à niveau temporaire n'est pas spécifiée.
404	MissingTemporary.EndTime	Temporary.EndTime is not specified.	L'heure de fin de la période de mise à niveau temporaire n'est pas spécifiée.
404	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.	La méthode de facturation de l'instance est introuvable.
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.
500	InternalError	The request processing has failed due to some unknown error.	Une erreur interne s'est produite. Réessayez ultérieurement.

Pour obtenir la liste des codes d'erreur, consultez la rubrique Codes d'erreur de service.