DescribeInstanceModificationPrice - 查询未到期的包年包月ECS实例升配时目标实例规格的价格信息、新增包年包月数据盘的价格信息 - 云服务器 ECS

查询未到期的包年包月ECS实例升配时目标实例规格的价格信息、新增包年包月数据盘的价格信息。

接口说明

仅支持查询未到期的包年包月 ECS 实例升配的价格信息，暂不支持查询实例降配的价格信息。
不支持查询按量付费 ECS 实例变配时的价格信息。由于按量付费 ECS 实例变配后的价格与新购实例的价格一致，因此您可以直接调用 DescribePrice 查询 ECS 实例的最新价格。
实例升配前，建议您先调用 DescribeResourcesModification 查询指定可用区内可升配的实例规格信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ecs:DescribeInstanceModificationPrice

get

*Instance

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

无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
InstanceId	string	是	需要查询升配价格的实例 ID。	i-bp1f2o4ldh8l****
InstanceType	string	否	实例升配的目标实例规格。建议您先调用 DescribeResourcesModification 查询指定可用区内可升配的实例规格信息。说明查询时，实例规格参数（`InstanceType`）和数据盘参数（`DataDisk.N.*`）不得同时为空，必须至少指定一个。	ecs.g6e.large
SystemDisk.Category	string	否	系统盘类型。仅当从已停售的实例规格升配至在售实例规格，并将非 I/O 优化实例规格升级为 I/O 优化实例规格时，才需要传入参数值。关于实例规格的更多信息，请参见实例规格族以及已停售的实例规格。取值范围： cloud_efficiency：高效云盘。 cloud_ssd：SSD 云盘。默认值：无。	cloud_ssd
SystemDisk	object	否
Category	string	否
PerformanceLevel	string	否		PL0
Size	integer	否		40
DataDisk	array<object>	否	数据盘类型信息。
	object	否	数据盘类型信息。
PerformanceLevel	string	否	当数据盘类型为 ESSD 云盘时，设置云盘的性能等级。N 的取值必须和`DataDisk.N.Category=cloud_essd`中的 N 保持一致。取值范围： PL0：单盘最高随机读写 IOPS 1 万。 PL1：单盘最高随机读写 IOPS 5 万。 PL2：单盘最高随机读写 IOPS 10 万。 PL3：单盘最高随机读写 IOPS 100 万。默认值：PL1。有关如何选择 ESSD 性能等级，请参见 ESSD 云盘。	PL1
Size	integer	否	数据盘的容量大小。N 的取值范围：1~16，内存单位为 GiB。取值范围： cloud_efficiency：20~32768。 cloud_ssd：20~32768。 cloud_essd：具体取值范围与`DataDisk.N.PerformanceLevel`的取值有关。 PL0：1~32768。 PL1：20~32768。 PL2：461~32768。 PL3：1261~32768。 cloud：5~2000。默认值：指定数据盘类型相应的容量大小的最小值。	100
Category	string	否	数据盘类型。当您需要查询 ECS 实例挂载的新包年包月数据盘的价格时，可以传入该参数值。N 的取值范围：1~16。取值范围： cloud_efficiency：高效云盘。 cloud_ssd：SSD 云盘。 cloud_essd：ESSD 云盘。 cloud：普通云盘。默认值：无。说明查询时，实例规格参数（`InstanceType`）和数据盘参数（`DataDisk.N.*`）不得同时为空，必须至少指定一个。	cloud_essd
DiskId	string	否		d-bf4rupt9****
ImageId	string	否		aliyun_2_1903_x64_20G_alibase_20200324.vhd
InternetMaxBandwidthOut	integer	否		10
ISP	string	否		BGP
InternetChargeType	string	否		PayByTraffic
StartTime	string	否		2025-12-05T22:40Z
EndTime	string	否		2025-12-06T22Z

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	A3DC3196-379B-4F32-A2C5-B937134FAD8A
PriceInfo	object	价格信息类型（PriceInfo）组成的数据类型，包括价格和优惠规则信息。
Rules	object
Rule	array<object>	活动规则。
	object
Description	string	活动规则描述。	升级优惠
RuleId	integer	活动 ID。	1234567890
Price	object	价格。
OriginalPrice	number	原价。	175.200
DiscountPrice	number	折扣。	61.320
Currency	string	货币单位。可能值：中国站：CNY。国际站：USD。	CNY
TradePrice	number	最终价，为原价减去折扣。	113.880
DetailInfos	object
DetailInfo	array<object>	配置明细价格信息。说明仅当 ResourceType = instance 时返回。
	array<object>	配置明细价格信息。
Resource	string	配置名称。可能值： instanceType：实例。 bandwidth：带宽。 image：镜像。 systemDisk：系统盘。 dataDisk：数据盘。	instanceType
OriginalPrice	number	原价。	4368
DiscountPrice	number	折扣价。	655.2
TradePrice	number	成交价。	3712.8
SubRules	object
Rule	array<object>	定价规则子集。
	object	定价规则子集。
Description	string	规则子集描述。	买满1年，立享官网价格8.5折优惠
RuleId	integer	活动规则 ID。	315716429631488
RelatedPrice	object
MarketplaceImagePrice	object
Currency	string		CNY
OriginalPrice	number		100
DiscountPrice	number		0
TradePrice	number		100

示例

正常返回示例

JSON格式

{
  "RequestId": "A3DC3196-379B-4F32-A2C5-B937134FAD8A",
  "PriceInfo": {
    "Rules": {
      "Rule": [
        {
          "Description": "升级优惠",
          "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": "买满1年，立享官网价格8.5折优惠",
                  "RuleId": 315716429631488
                }
              ]
            }
          }
        ]
      }
    },
    "RelatedPrice": {
      "MarketplaceImagePrice": {
        "Currency": "CNY",
        "OriginalPrice": 100,
        "DiscountPrice": 0,
        "TradePrice": 100
      }
    }
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	MissingParameter.InstanceTypeOrDataDisk	You must specify the parameter InstanceType or DataDisk.	实例规格和数据盘参数二选一必须传一个，不能都为空。
400	InvalidSystemDiskCategory.ValueNotSupported	The specified parameter "SystemDisk.Category" is not valid.	指定的参数系统盘规格无效。
400	InvalidDiskCategory.Missing	The DataDisk.1.Category parameter that is mandatory for processing the request is not provided.	没有指定数据盘类型。
400	InvalidDataDiskCategory.ValueNotSupported	The specified parameter "DataDisk.n.Category" is not valid.
400	InvalidDiskCategory.ValueNotSupported	The specified parameter "DiskCategory" is not valid.	指定的参数云盘类型DiskCategory无效。
400	InvalidDataDiskSize.ValueNotSupported	The specified DataDisk.n.Size beyond the permitted range.	数据盘大小超出目标实例允许的范围内
400	InvalidPerformanceLevel.Malformed	The specified parameter DataDisk.n.PerformanceLevel is not valid.	指定数据盘的参数 PerformanceLevel 无效
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.	指定的数据盘性能等级与数据盘大小不匹配
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	您指定的实例规格不存在，或者您没有权限操作此规格的实例。
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.	未找到价格，请修改相应的参数值重试。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	内部错误，请重试。
403	InvalidParameter.ResourceOwnerAccount	ResourceOwnerAccount is Invalid.	指定的 ResourceOwnerAccount 不合法。
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.	指定的实例规格为降配的规格，该 API 仅支持查询升配的实例规格的价格。建议您通过 DescribeResourcesModification 接口获取可升配的实例规格。
403	InstanceExpired	The PrePaid instance has been expired.	当前实例已过期，不支持查询变配价格。
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	您指定的实例规格已下线，请选择其它规格的实例。
403	RegionUnauthorized	There is no authority to create instance in the specified region.	用户未被授权在指定的地域创建实例。
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	地域信息错误
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	资源组并不在记录中。
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	指定的实例ID无效。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。