Tous les produits
Search

Ce produit

    Elastic Compute Service:ModifyPrepayInstanceSpec

    Centre de documentation

    Elastic Compute Service:ModifyPrepayInstanceSpec

    Dernière mise à jour :Aug 27, 2026

    Modifie le type d'instance d'une instance ECS par abonnement, permettant de mettre à niveau ou de rétrograder le type d'instance. La modification prend effet pour l'ensemble du cycle de vie de l'instance.

    Description de l'opération

    Avant d'appeler cette opération, assurez-vous de bien comprendre les méthodes de facturation, les tarifs et les règles de remboursement pour les rétrogradations de spécifications d'ECS.

    Cette opération est asynchrone. Le changement de configuration prend effet après environ 5 à 10 secondes. Avant de mettre à niveau ou de rétrograder le type d'instance d'une instance ECS par abonnement, vous pouvez appeler DescribeResourcesModification pour interroger les types d'instances ECS vers lesquels l'instance actuelle peut être modifiée.

    Précautions

    • Si la propriété NVMe diffère entre le type d'instance d'origine et le type d'instance cible (le champ NvmeSupport renvoyé par DescribeInstanceTypes) et que le système d'exploitation est Windows (le champ OSType renvoyé par DescribeInstances), appliquez les mesures préventives avant d'effectuer la mise à niveau ou la rétrogradation.

    • Vous ne pouvez pas modifier le type d'une instance expirée. Renouvelez l'abonnement et réessayez.

    • Rétrograder le type d'instance :

      • L'instance doit être dans l'état Arrêtée (Stopped).

      • La différence de prix entre les types d'instance d'origine et nouveau est remboursée selon votre mode de facturation d'origine. Les bons utilisés ne sont pas remboursés. Le payeur reçoit le remboursement.

      • Le nouveau type d'instance prend effet après le démarrage de l'instance suite à la mise à niveau ou à la rétrogradation.

    • Mettre à niveau le type d'instance :

    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:ModifyPrepayInstanceSpec

    update

    *Instance.

    acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    InstanceId

    string

    Oui

    L'identifiant de l'instance.

    i-bp67acfmxazb4ph****
    RegionId

    string

    Oui

    L'identifiant de la région de l'instance. Vous pouvez appeler DescribeRegions pour interroger la liste des régions la plus récente.

    cn-hangzhou
    InstanceType

    string

    Oui

    Le type d'instance cible pour la mise à niveau ou la rétrogradation. Pour plus d'informations, consultez la section Famille d'instances ou appelez DescribeInstanceTypes.

    ecs.g5.xlarge
    OperatorType

    string

    Non

    Le type d'opération. Valeurs valides :

    Remarque

    Ce paramètre est facultatif. Le système peut déterminer automatiquement si l'opération est une mise à niveau ou une rétrogradation. Si vous transmettez ce paramètre, respectez les règles ci-dessous.

    • upgrade : met à niveau le type d'instance. Assurez-vous que le solde de votre mode de paiement est suffisant.

    • downgrade : rétrograde le type d'instance. Lorsque le type d'instance spécifié par InstanceType est inférieur au type d'instance actuel, définissez OperatorType sur downgrade.

    Remarque

    Pour les précautions concernant la mise à niveau ou la rétrogradation des types d'instance, consultez la section de description de l'opération ci-dessus.

    upgrade
    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 qu'il est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et sa longueur ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.

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

    boolean

    Non

    Indique si le paiement automatique doit être effectué automatiquement lors de la mise à niveau du type d'instance. Valeurs valides :

    • true : le paiement automatique est effectué automatiquement.

    • false : une commande est créée mais le paiement automatique n'est pas effectué.

    Valeur par défaut : true.

    Remarque

    • Si vous définissez AutoPay sur true, assurez-vous que le solde de votre mode de paiement est suffisant. Sinon, une commande anormale est générée et vous ne pouvez que l'annuler.

    • Si le solde de votre mode de paiement est insuffisant, vous pouvez définir AutoPay sur false pour générer une commande non payée. Vous pouvez ensuite vous connecter à la console ECS pour payer la commande.

    • Lorsque OperatorType est défini sur downgrade, le paramètre AutoPay est ignoré.

    true
    MigrateAcrossZone

    boolean

    Non

    Indique si la mise à niveau ou la rétrogradation inter-cluster des types d'instance est prise en charge. Valeurs valides :

    • true : les changements de type d'instance inter-cluster sont pris en charge.

    • false : les changements de type d'instance inter-cluster ne sont pas pris en charge.

    Valeur par défaut : false.

    Lorsque MigrateAcrossZone est défini sur true, prenez note des éléments suivants après la mise à niveau de l'instance Elastic Compute Service en fonction de la réponse :

    Instances de type VPC : pour les types d'instances obsolètes, lorsqu'une instance non optimisée pour les E/S est transformée en instance optimisée pour les E/S, les noms des périphériques de disque et les codes d'autorisation logicielle du serveur changent. Pour les instances Linux, les disques de base (cloud) sont identifiés comme xvda ou xvdb. Les disques ultra (cloud_efficiency) et les SSD standard (cloud_ssd) sont identifiés comme vda ou vdb. Ce paramètre est utilisé pour l'optimisation de la migration inter-cluster.

    false
    SystemDisk.Category

    string

    Non

    La 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 effectuez une mise à niveau d'un type d'instance obsolète vers une famille d'instances actuellement disponible et que vous transformez une instance non optimisée pour les E/S en instance optimisée pour les E/S.

    cloud_efficiency
    RebootTime

    string

    Non

    L'heure de redémarrage de l'instance. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mmZ. L'heure doit être en UTC.

    2018-01-01T12:05Z
    EndTime

    string

    Non

    L'heure de fin du changement temporaire de type d'instance. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mmZ. L'heure doit être en UTC.

    2018-01-01T12:05Z
    RebootWhenFinished

    boolean

    Non

    Indique si l'instance doit être redémarrée immédiatement après le changement de type d'instance. Valeurs valides :

    • true : l'instance est redémarrée immédiatement.

    • false : l'instance n'est pas redémarrée immédiatement.

    Valeur par défaut : false.

    Remarque

    Si l'instance est dans l'état Arrêtée, l'instance reste arrêtée même si vous définissez RebootWhenFinished sur true. Aucune opération n'est effectuée.

    false
    ModifyMode

    string

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    null
    Disk

    array<object>

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    object

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    DiskId

    string

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    null
    Category

    string

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    null
    PerformanceLevel

    string

    Non

    Remarque

    Ce paramètre n'est pas disponible publiquement.

    null

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    OrderId

    string

    L'identifiant de la commande.

    1234567890
    RequestId

    string

    L'identifiant de la requête.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

    Exemples

    JSON format

    {
  "OrderId": "1234567890",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

    Codes d'erreur

    Code de statut HTTP

    Code d'erreur

    Message d'erreur

    Description
    400 InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized.
    400 InvalidInstanceType.ValueNotSupported The specified InstanceType does not exist or beyond the permitted range.
    400 InvalidBillingMethod.ValueNotSupported The operation is not permitted due to an invalid billing method of the instance.
    400 InvalidInstance.PurchaseNotFound The specified instance has no purchase history.
    400 InvalidInstance.UnpaidOrder The specified instance has unpaid order.
    400 InvalidInstanceType.NotSupported The specified InstanceType is not Supported.
    400 OrderCreationFailed Order creation failed, please check your params and try it again later.
    400 Throttling You have made too many requests within a short time; your request is denied due to request throttling.
    400 Account.Arrearage Your account has an outstanding payment.
    400 InvalidInstanceId.NotFound The specified InstanceId does not exist.
    400 InvalidRebootTime.MalFormed The specified rebootTime is not valid.
    400 InvalidRebootTime.ValueNotSupported The specified RebootTime is not valid.
    400 IdempotenceParamNotMatch Request uses a client token in a previous request but is not identical to that request.
    400 InvalidInstanceChargeType.ValueNotSupported %s
    400 InvalidStatus.NotStopped Instance status must be stopped.
    400 InvalidAction %s
    400 InstanceDowngrade.QuotaExceed Quota of instance downgrade is exceed.
    400 InvalidParameter %s
    400 OperationDenied The current user does not support this operation.
    400 LastOrderProcessing The previous order is still processing, please try again later.
    400 InvalidOperation.VpcHasEnabledAdvancedNetworkFeature The specified vpc has enabled advanced network feature.
    400 InvalidAction.WithActiveElasticUpgrade The instance has active Elastic Upgrade.
    400 InstanceTypeNotSupported.TooManyDisksAttached %s
    400 QuotaExceed.DiskCapacity The used capacity of disk type has exceeded the quota in the zone, %s.
    400 MissingParameter.DiskCategory The specified parameter Disk.Category can not be null when Disk.DiskId is specified.
    400 InvalidParameter.DiskCategory The specified parameter Disk.Category is not valid.
    400 InvalidPerformanceLevel.Malformed The specified parameter Disk.n.PerformanceLevel is not valid.
    400 InvalidSystemDiskCategory.NotMatchInstanceType The system disk category does not match the instance type.
    400 QuotaExceed.RufundVcpu The maximum number of refunded vcpu is exceeded: %s .
    400 NoPermission.Price The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true.
    400 NoPermission.Refund The operation requires refund permission. Please apply for permission from your main account.
    400 InvalidInstanceStatus The current status of the instance does not support this operation.
    400 InvalidOperation.InstanceRenewWithDowngradeInPlan The operation is denied due to the specified instance has renew with downgrade record in plan.
    400 InvalidOperation.OnlineModificationUnsupported Online modification of instance type is not supported for the specified instance due to its CPU topology.
    400 InvalidInstanceType.NotSupportCpuOptionsNestedVirtualization The specified instance type does not support CpuOptions.NestedVirtualization: %s.
    401 InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized.
    500 InternalError The request processing has failed due to some unknown error, exception or failure.
    500 ImageOrderFailed Create marketplace image order failed.
    403 OperationDenied.NoStock The specified instance is out of usage.
    403 InvalidInstanceType.ValueNotSupported The specified InstanceType does not exist or beyond the permitted range.
    403 InvalidUser.PassRoleForbidden The RAM user does not have privilege to pass a role.
    403 ImageNotSupportInstanceType The specified image does not support the specified InstanceType.
    403 InstanceType.Offline %s
    403 IncorrectInstanceStatus The current status of the resource does not support this operation.
    403 Throttling You have made too many requests within a short time; your request is denied due to request throttling.
    403 InvalidParameter.InstanceId %s
    403 OperationDenied %s
    403 InvalidInstanceStatus The current status of the instance does not support this operation.
    403 InvalidOperation.StarterPackage StarterPackage not support modification.
    403 InvalidInstance.PreInstanceExpired Instance business status is not Expired.
    403 InvalidInstance.EipNotSupport The special instance with eip not support operate, please unassociate eip first.
    403 OperationDenied.ImageNotValid The specified image is not authorized.
    403 OperationDenied.LocalDiskUnsupported The configuration change is not allowed when the specified instance has local disks mounted.
    403 InvalidOperation.EniCountExceeded %s
    403 InvalidOperation.Ipv4CountExceeded %s
    403 InvalidOperation.Ipv6CountExceeded %s
    403 InvalidOperation.Ipv6NotSupport %s
    403 InvalidOperation.Ipv4NotSupport %s
    403 InvalidInstance.NotFoundSystemDisk The specified instance has no system disk.
    403 InvalidInstanceType.NotSupportDiskCategory The instanceType of the specified instance does not support this disk category.
    403 QuotaExceed.ElasticQuota No additional quota is available for the specified ECS instance type.
    403 InvalidResourceType.NotSupported %s
    403 InvalidOperation.MaxEniQueueNumberExceeded %s
    403 InvalidOperation.ExceedInstanceTypeQueueNumber %s
    403 InvalidParameter.InvalidEniQueueNumber %s
    403 HibernationConfigured.InstanceOperationForbidden The operation is not permitted due to limit of the hibernation configured instance.
    403 InvalidOperation.MaxModifyOnlineNumberExceeded The specified instance has reached the maximum number of modify online attempts and needs to be rebooted.
    403 InvalidOperation.RebootingRequired The specified instance needs to be rebooted.
    403 InvalidOperation.OSTypeNotSupported The specified OS type is not supported.
    403 OperationDenied.UnpaidOrder The specified instance has unpaid order.
    403 InvalidDisk.DetachedSystemDisk The specified resource is/has a detached system disk %s , not support current operation.
    403 InvalidDataDiskCategory.ValueNotSupported The specified Category of Data Disk is not valid.
    403 InvalidDiskCategory.NotSupported The upgrade operation of instance does not support this category of disk.
    403 InvalidOperation.InstanceTypeSecureBootUnsupported The instance type does not support secure boot.
    404 InvalidRegionId.NotFound The specified RegionId does not exist.
    404 BillingMethodNotFound The account has not chosen any billing method.
    404 InvalidInstanceId.NotFound The specified InstanceId does not exist.
    503 LimitedOperation.ServiceUnavailable The service is currently unavailable. Please try again later.

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

    Notes de version

    Consultez Notes de version pour la liste complète.