DescribeInstanceModificationPrice - Elastic Compute Service - Centre de documentation Alibaba Cloud

Consulte le prix de la mise à niveau d'une instance ECS à abonnement non expiré vers un type d'instance cible, ainsi que le prix de l'ajout de disques de données par abonnement.

Description de l'opération

Prend uniquement en charge la consultation des informations de prix pour la mise à niveau des instances ECS par abonnement non expirées. La consultation des informations de prix pour la rétrogradation des instances n'est pas prise en charge.
Ne prend pas en charge la consultation des informations de prix pour la modification des spécifications des instances ECS postpayées. Étant donné que le prix d'une instance ECS postpayée après une modification de spécification est identique à celui d'une nouvelle instance, vous pouvez appeler directement DescribePrice pour obtenir le prix le plus récent d'une instance ECS.
Avant de mettre à niveau une instance, appelez DescribeResourcesModification pour consulter les types d'instances disponibles pour la mise à niveau dans une zone spécifiée.

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

get

*Instance.

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région. Vous pouvez appeler DescribeRegions pour consulter la liste des régions la plus récente.	cn-hangzhou
InstanceId	string	Oui	L'identifiant de l'instance pour laquelle vous souhaitez consulter le prix de mise à niveau.	i-bp1f2o4ldh8l****
InstanceType	string	Non	Le type d'instance cible pour la mise à niveau. Nous vous recommandons d'appeler DescribeResourcesModification pour consulter les types d'instances disponibles pour la mise à niveau dans une zone spécifiée.	ecs.g6e.large
SystemDisk.Category	string	Non	La catégorie du disque système. Vous devez spécifier ce paramètre uniquement lorsque vous effectuez une mise à niveau d'un type d'instance retiré vers un type d'instance disponible et d'un type d'instance non optimisé pour les E/S vers un type d'instance optimisé pour les E/S. Pour plus d'informations sur les types d'instances, consultez Familles d'instances et Types d'instances retirés. Valeurs valides : cloud_efficiency : disque ultra. cloud_ssd : SSD standard. Valeur par défaut : null.	cloud_ssd
SystemDisk	object	Non	Les paramètres de modification du disque système.
Category	string	Non	La catégorie du disque système.
PerformanceLevel	string	Non	Le niveau de performance (PL) du disque système.	PL0
Size	integer	Non	La taille du disque système.	40
DataDisk	array<object>	Non	Les informations sur les types de disques de données.
	object	Non	Les informations sur les types de disques de données.
PerformanceLevel	string	Non	Le niveau de performance du disque de données lorsque le type de disque est un SSD d'entreprise. La valeur de N doit être identique à celle de DataDisk.N.Category=cloud_essd. Valeurs valides : PL0 : un seul disque peut fournir jusqu'à 10 000 IOPS de lecture/écriture aléatoire. PL1 : un seul disque peut fournir jusqu'à 50 000 IOPS de lecture/écriture aléatoire. PL2 : un seul disque peut fournir jusqu'à 100 000 IOPS de lecture/écriture aléatoire. PL3 : un seul disque peut fournir jusqu'à 1 000 000 IOPS de lecture/écriture aléatoire. Valeur par défaut : PL1. Pour plus d'informations sur la façon de sélectionner un niveau de performance ESSD, consultez ESSD.	PL1
Size	integer	Non	La capacité du disque de données. Valeurs valides de N : 1 à 16. Unité : GiB. Valeurs valides : cloud_efficiency : 20 à 32768. cloud_ssd : 20 à 32768. cloud_essd : la plage de valeurs valides dépend de la valeur de DataDisk.N.PerformanceLevel. PL0 : 1 à 32768. PL1 : 20 à 32768. PL2 : 461 à 32768. PL3 : 1261 à 32768. cloud : 5 à 2000. Valeur par défaut : la capacité minimale pour le type de disque de données spécifié.	100
Category	string	Non	Le type du disque de données. Spécifiez ce paramètre pour consulter le prix d'un nouveau disque de données par abonnement attaché à une instance ECS. Valeurs valides de N : 1 à 16. Valeurs valides : cloud_efficiency : disque ultra. cloud_ssd : SSD standard. cloud_essd : SSD d'entreprise. cloud : disque de base. Valeur par défaut : null. Remarque Lorsque vous appelez cette opération, le paramètre de type d'instance InstanceType et les paramètres de disque de données DataDisk.N.* ne peuvent pas être tous deux vides. Spécifiez au moins l'un d'eux.	cloud_essd
DiskId	string	Non	L'identifiant du disque de données.	d-bf4rupt9****
ImageId	string	Non	L'identifiant de l'image.	aliyun_2_1903_x64_20G_alibase_20200324.vhd
InternetMaxBandwidthOut	integer	Non	La bande passante publique sortante maximale.	10
ISP	string	Non	Le fournisseur d'accès Internet.	BGP
InternetChargeType	string	Non	La méthode de facturation du réseau vers laquelle convertir.	PayByTraffic
StartTime	string	Non	L'heure de début de la mise à niveau temporaire de la bande passante.	2025-12-05T22:40Z
EndTime	string	Non	L'heure de fin de la mise à niveau temporaire de la bande passante.	2025-12-06T22Z

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	A3DC3196-379B-4F32-A2C5-B937134FAD8A
PriceInfo	object	Les informations de prix, y compris le prix et les détails des règles de remise.
Rules	object
Rule	array<object>	La règle de promotion.
	object
Description	string	La description de la règle de promotion.	Remise de mise à niveau
RuleId	integer	L'identifiant de la promotion.	1234567890
Price	object	Le prix.
OriginalPrice	number	Le prix d'origine.	175.200
DiscountPrice	number	La remise.	61.320
Currency	string	L'unité de devise. Valeurs valides :	CNY
TradePrice	number	Le prix de la transaction, qui correspond au prix d'origine moins la remise.	113.880
DetailInfos	object
DetailInfo	array<object>	Les détails du prix de la configuration.
	array<object>	Les détails du prix de la configuration.
Resource	string	Le nom de la configuration. Valeurs valides :	instanceType
OriginalPrice	number	Le prix d'origine.	4368
DiscountPrice	number	Le prix remisé.	655.2
TradePrice	number	Le prix de la transaction.	3712.8
SubRules	object
Rule	array<object>	Le sous-ensemble de règles de tarification.
	object	Le sous-ensemble de règles de tarification.
Description	string	La description du sous-ensemble de règles.	Remise de 15 % pour un abonnement d'un an
RuleId	integer	L'identifiant de la règle de promotion.	315716429631488
RelatedPrice	object	Le prix associé.
MarketplaceImagePrice	object	Le prix de l'image de la place de marché Alibaba Cloud.
Currency	string	L'unité de devise.	CNY
OriginalPrice	number	Le prix d'origine.	100
DiscountPrice	number	La remise.	0
TradePrice	number	Le prix de la transaction, qui correspond au prix d'origine moins la remise.	100

Exemples

JSON format

{
  "RequestId": "A3DC3196-379B-4F32-A2C5-B937134FAD8A",
  "PriceInfo": {
    "Rules": {
      "Rule": [
        {
          "Description": "Remise pour mise à niveau",
          "RuleId": 1234567890
        }
      ]
    },
    "Price": {
      "OriginalPrice": 175.2,
      "DiscountPrice": 61.32,
      "Currency": "CNY",
      "TradePrice": 113.88,
      "DetailInfos": {
        "DetailInfo": [
          {
            "Resource": "instanceType",
            "OriginalPrice": 4368,
            "DiscountPrice": 655.2,
            "TradePrice": 3712.8,
            "SubRules": {
              "Rule": [
                {
                  "Description": "Remise de 15 % pour un abonnement d'un an au prix officiel du site Web",
                  "RuleId": 315716429631488
                }
              ]
            }
          }
        ]
      }
    },
    "RelatedPrice": {
      "MarketplaceImagePrice": {
        "Currency": "CNY",
        "OriginalPrice": 100,
        "DiscountPrice": 0,
        "TradePrice": 100
      }
    }
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	MissingParameter.InstanceTypeOrDataDisk	You must specify the parameter InstanceType or DataDisk.	Le type d'instance ou les paramètres du disque de données doivent être spécifiés. Ils ne peuvent pas être tous deux vides.
400	InvalidSystemDiskCategory.ValueNotSupported	The specified parameter "SystemDisk.Category" is not valid.	Le paramètre de spécification du disque système spécifié n'est pas valide.
400	InvalidDiskCategory.Missing	The DataDisk.1.Category parameter that is mandatory for processing the request is not provided.	Aucun type de disque de données n'est spécifié.
400	InvalidDataDiskCategory.ValueNotSupported	The specified parameter "DataDisk.n.Category" is not valid.
400	InvalidDiskCategory.ValueNotSupported	The specified parameter "DiskCategory" is not valid.	Le type de disque de la ressource spécifiée ne prend pas en charge cette opération.
400	InvalidDataDiskSize.ValueNotSupported	The specified DataDisk.n.Size beyond the permitted range.	La taille de disque spécifiée dépasse la plage autorisée, ou la taille de l'instantané dépasse la limite de taille de la catégorie de disque spécifiée.
400	InvalidPerformanceLevel.Malformed	The specified parameter DataDisk.n.PerformanceLevel is not valid.	Le paramètre PerformanceLevel spécifié pour le disque de données n'est pas valide.
400	InvalidDiskSize.TooSmall	Specified disk size is too small when choose PL0 of cloud_essd.
400	OperationDenied.PerformanceLevelNotMatch	The specified DataDisk.n.PerformanceLevel and DataDisk.n.Size do not match.	Le niveau de performance du disque de données spécifié ne correspond pas à la taille du disque de données.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	Le type d'instance spécifié ne prend pas en charge le type de disque de données attaché à l'instance actuelle.
400	InvalidAction.WithActiveElasticUpgrade	The instance has active Elastic Upgrade.
400	PriceNotFound	The price of your queried resource is not available now, please try other resources.	Le prix n'a pas été trouvé. Modifiez les valeurs des paramètres correspondants et réessayez.
400	InvalidBandwidth.ValueNotSupported	Instance upgrade bandwidth of temporary not allow less then existed.	La valeur de bande passante spécifiée pour l'opération de rétrogradation doit être inférieure à la valeur de bande passante de base.
400	InvalidParameter.InstanceTypeAndNetworkConflict	The current operation does not allow both InstanceType and network modification parameter to be set.	Les paramètres de type d'instance et de modification du réseau ne peuvent pas être spécifiés simultanément dans la requête actuelle.
400	InvalidParameter.InstanceTypeAndImageConflict	The current operation does not allow both InstanceType and ImageId parameter to be set.	Les paramètres InstanceType et ImageId ne peuvent pas être spécifiés simultanément dans la requête actuelle.
400	InvalidParameter.InstanceTypeAndDiskConflict	The current operation does not allow both InstanceType and Disk parameter to be set.	Les paramètres InstanceType et Disk ne peuvent pas être spécifiés simultanément dans la requête actuelle.
400	InvalidParameter.NetworkAndImageConflict	The current operation does not allow both network modification parameter and ImageId to be set.	Les paramètres de modification du réseau et ImageId ne peuvent pas être spécifiés simultanément dans la requête actuelle.
400	InvalidParameter.NetworkAndDiskConflict	The current operation does not allow both network modification parameter and disk parameter to be set.	Les paramètres de modification du réseau et Disk ne peuvent pas être spécifiés simultanément dans la requête actuelle.
400	InvalidParameter.ImageAndDiskConflict	The current operation does not allow both ImageId and DataDisk parameter to be set.	Les paramètres ImageId et Disk ne peuvent pas être spécifiés simultanément dans la requête actuelle.
400	InvalidParameter.CategoryAndSizeConflict	The current operation does not allow both Category and Size parameter to be set.	Les paramètres Category et Size ne peuvent pas être spécifiés simultanément dans la requête actuelle.
400	MissingParameter.Instance	The instance modification parameter can not be empty.	Les paramètres de modification des spécifications de l'instance ne peuvent pas être vides.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Une erreur s'est produite lors de l'envoi de la requête. Réessayez plus tard.
403	InvalidParameter.ResourceOwnerAccount	ResourceOwnerAccount is Invalid.	Le paramètre ResourceOwnerAccount spécifié est invalide.
403	ChargeTypeViolation	PostPaid instance do not support this operation.
403	InvalidInstanceType.NotSupportUpgrade	The specified InstanceType can only be downgraded. This API supports querying prices only of InstanceType that can be upgraded.	Le type d'instance spécifié correspond à une rétrogradation. Cette API prend uniquement en charge la requête de prix pour les types d'instance de mise à niveau. Utilisez l'opération DescribeResourcesModification pour obtenir les types d'instance de mise à niveau disponibles.
403	InstanceExpired	The PrePaid instance has been expired.	L'instance par abonnement spécifiée a expiré.
403	Throttling.User	Request was denied due to user flow control.
403	Throttling	Request was denied due to request throttling.
403	InstanceType.Offline	The specified InstanceType has been offline	Le type d'instance spécifié a été retiré.
403	RegionUnauthorized	There is no authority to create instance in the specified region.	Vous n'avez pas l'autorisation de créer un pool privé dans la région spécifiée.
403	InvalidSystemDiskCategory.ValueNotSupported	The specified parameter SystemDisk.Category is not valid.	Le paramètre de spécification du disque système spécifié n'est pas valide.
403	InvalidDataDiskCategory.ValueNotSupported	The specified Category of Data Disk is not valid.	Le paramètre DataDisk.Category spécifié n'est pas valide.
403	OperationDenied.PerformanceLevelNotMatch	The specified PerformanceLevel and disk size do not match.	Le niveau de performance du disque de données spécifié ne correspond pas à la taille du disque de données.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	Les informations de région ne sont pas valides.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Le groupe de ressources correspondant est introuvable.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	L'identifiant d'instance spécifié est invalide.

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

Notes de version

Consultez Notes de version pour la liste complète.