全部产品
Search
文档中心

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

更新时间:Nov 29, 2024

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

接口说明

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ecs:DescribeInstanceModificationPriceget
*Instance
acs:ecs:{#regionId}:{#accountId}:instance/{#InstanceId}

请求参数

名称类型必填描述示例值
RegionIdstring

地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
InstanceIdstring

需要查询升配价格的实例 ID。

i-bp1f2o4ldh8l****
InstanceTypestring

实例升配的目标实例规格。建议您先调用 DescribeResourcesModification 查询指定可用区内可升配的实例规格信息。

说明 查询时,实例规格参数(InstanceType)和数据盘参数(DataDisk.N.*)不得同时为空,必须至少指定一个。
ecs.g6e.large
SystemDisk.Categorystring

系统盘类型。仅当从已停售的实例规格升配至在售实例规格,并将非 I/O 优化实例规格升级为 I/O 优化实例规格时,才需要传入参数值。关于实例规格的更多信息,请参见实例规格族以及已停售的实例规格

取值范围:

  • cloud_efficiency:高效云盘。
  • cloud_ssd:SSD 云盘。

默认值:无。

cloud_ssd
DataDiskarray<object>

数据盘类型信息。

object

数据盘类型信息。

PerformanceLevelstring

当数据盘类型为 ESSD 云盘时,设置云盘的性能等级。N 的取值必须和DataDisk.N.Category=cloud_essd中的 N 保持一致。取值范围:

  • PL0:单盘最高随机读写 IOPS 1 万。
  • PL1:单盘最高随机读写 IOPS 5 万。
  • PL2:单盘最高随机读写 IOPS 10 万。
  • PL3:单盘最高随机读写 IOPS 100 万。

默认值:PL1。

有关如何选择 ESSD 性能等级,请参见 ESSD 云盘

PL1
Sizeinteger

数据盘的容量大小。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
Categorystring

数据盘类型。当您需要查询 ECS 实例挂载的新包年包月数据盘的价格时,可以传入该参数值。N 的取值范围:1~16。取值范围:

  • cloud_efficiency:高效云盘。
  • cloud_ssd:SSD 云盘。
  • cloud_essd:ESSD 云盘。
  • cloud:普通云盘。

默认值:无。

说明 查询时,实例规格参数(InstanceType)和数据盘参数(DataDisk.N.*)不得同时为空,必须至少指定一个。
cloud_essd

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

A3DC3196-379B-4F32-A2C5-B937134FAD8A
PriceInfoobject

价格信息类型(PriceInfo)组成的数据类型,包括价格和优惠规则信息。

Rulesarray<object>

活动规则。

Ruleobject
Descriptionstring

活动规则描述。

升级优惠
RuleIdlong

活动 ID。

1234567890
Priceobject

价格。

OriginalPricefloat

原价。

175.200
DiscountPricefloat

折扣。

61.320
Currencystring

货币单位。

中国站:CNY。

国际站:USD。

CNY
TradePricefloat

最终价,为原价减去折扣。

113.880

示例

正常返回示例

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
    }
  }
}

错误码

HTTP status code错误码错误信息描述
400MissingParameter.InstanceTypeOrDataDiskYou must specify the parameter InstanceType or DataDisk.实例规格和数据盘参数二选一必须传一个,不能都为空。
400InvalidSystemDiskCategory.ValueNotSupportedThe specified parameter "SystemDisk.Category" is not valid.-
400InvalidDiskCategory.MissingThe DataDisk.1.Category parameter that is mandatory for processing the request is not provided.没有指定数据盘类型。
400InvalidDataDiskCategory.ValueNotSupportedThe specified parameter "DataDisk.n.Category" is not valid.-
400InvalidDiskCategory.ValueNotSupportedThe specified parameter "DiskCategory" is not valid.-
400InvalidDataDiskSize.ValueNotSupportedThe specified DataDisk.n.Size beyond the permitted range.数据盘大小超出目标实例允许的范围内
400InvalidPerformanceLevel.MalformedThe specified parameter DataDisk.n.PerformanceLevel is not valid.指定数据盘的参数 PerformanceLevel 无效
400InvalidDiskSize.TooSmallSpecified disk size is too small when choose PL0 of cloud_essd.-
400OperationDenied.PerformanceLevelNotMatchThe specified DataDisk.n.PerformanceLevel and DataDisk.n.Size do not match.指定的数据盘性能等级与数据盘大小不匹配
400InvalidInstanceType.ValueNotSupportedThe specified InstanceType does not exist or beyond the permitted range.您指定的实例规格不存在,或者您没有权限操作此规格的实例。
400InstanceType.Offline%s实例规格因停售、供货不足等原因,不支持该操作。
400RegionUnauthorized%s该地域未被授权。%s为变量,将根据调用API的实际情况动态返回错误信息。
400InvalidAction.WithActiveElasticUpgradeThe instance has active Elastic Upgrade.指定的实例为临时升级中(即调用ModifyPrepayInstanceSpec时设置了EndTime参数)的实例,暂不支持查询。
400PriceNotFoundThe price of your queried resource is not available now, please try other resources.未找到价格,请修改相应的参数值重试。
403InvalidParameter.ResourceOwnerAccountResourceOwnerAccount is Invalid.指定的 ResourceOwnerAccount 不合法。
403ChargeTypeViolationPostPaid instance do not support this operation.该 API 不支持查询按量付费的 ECS 的变配价格。
403InvalidInstanceType.NotSupportUpgradeThe specified InstanceType can only be downgraded. This API supports querying prices only of InstanceType that can be upgraded.指定的实例规格为降配的规格,该 API 仅支持查询升配的实例规格的价格。建议您通过 DescribeResourcesModification 接口获取可升配的实例规格。
403InstanceExpiredThe PrePaid instance has been expired.当前实例已过期,不支持查询变配价格。
403Throttling.UserRequest was denied due to user flow control.-
403ThrottlingRequest was denied due to request throttling.请求被流控。
404InvalidRegionId.NotFoundThe RegionId provided does not exist in our records.提供的RegionId不存在
404InvalidResourceGroup.NotFoundThe ResourceGroup provided does not exist in our records.资源组并不在记录中。
404InvalidInstanceId.NotFoundThe specified InstanceId does not exist.指定的实例ID未找到。
500InternalError%s内部错误。

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

变更历史

变更时间变更内容概要操作
暂无变更历史