调用CalculatePriceV2接口查询云盘价格。

使用说明

子账号使用CalculatePriceV2接口查询云盘价格时，其价格查询结果默认包含原价、应付价和折扣价。您可以配置屏蔽折扣价的权限策略，然后将权限策略授予给子账号，使得子账号只能查询原价、应付价，无法查看折扣价。屏蔽折扣价的权限策略如下：

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：CalculatePriceV2

要执行的操作，取值：CalculatePriceV2。

Version string 必选示例值：2020-04-01

AccountId long 可选示例值：210000****

账号ID。

CalculatePriceInfos object[] 可选示例值：-

询价信息。

Count long 可选示例值：1

云盘个数，默认为1。

PurchaseTime long 可选示例值：2023-11-06T06:38:51+08:00

购买时间。

Size float 可选示例值：40

云盘容量，单位GiB。

注意

在执行创建云盘、扩容云盘、更改云盘计费模式、变更云盘规格操作前询价时，Size参数必填。

VolumeType string 可选示例值：ESSD_FlexPL

云盘规格，取值说明如下：

PTSSD：性能型SSD。

ESSD_PL0：极速型SSD云盘，PL0规格。

ESSD_FlexPL: 极速型SSD云盘，FlexPL规格。

TSSD_TL0：吞吐型SSD云盘

Action string 可选示例值：extend

询价执行的操作，大小写不敏感，取值说明如下：

create：创建云盘前询价。

extend：扩容云盘前询价。

modifyChargeType：更改计费模式，例如包年包月云盘改为按量计费云盘。

modifyType：更改云盘规格前询价，例如ESSD PL0改为ESSD FlexPL。

renew：续费前询价。

terminate：退订前询价。

注意

按量计费云盘不支持renew（续费询价）和terminate（退订询价）。

Period string 可选示例值：hourly

云盘购买周期类型，取值说明如下：

monthly：按月购买。包年包月仅支持monthly。

hourly：按小时购买。按量计费仅支持hourly。

说明

Period和Times参数必须一起传入。

Times integer 可选示例值：2

云盘购买时长。例如Period设置为monthly，Time设置为2，表示购买2个月云盘。

说明

Times和Period参数必须一起传入。

EndTime integer 可选示例值：1748361599

云盘到期截止时间，根据时间戳进行转换。

注意

仅包年包月云盘支持设置EndTime参数。

退订场景不支持EndTime参数。

如果同时设置了EndTime和Times，优先使用EndTime。

VolumeKind string 可选示例值：system

云盘类型。取值说明如下：

data：数据盘

system：系统盘

默认为数据盘。

VolumeID string 可选示例值：vol-ikbsisshogcrntuo****

云盘ID。

注意

创建云盘前询价无需传入该参数，其他场景必须传入。

Region string 可选示例值：cn-beijing

地域。默认为请求的地域。

ExtraPerformances object[] 可选示例值：-

额外性能包。

ExtraPerformanceType string 可选示例值：IOPS

额外性能的类型。取值如下：

Balance：均衡型。

IOPS：IOPS型。

Throughput：吞吐量型。

ExtraPerformanceValue integer 可选示例值：20

额外性能包的性能大小。

InstanceID string 可选示例值：i-yci7p7t660awmay7****

ECS实例ID。设置InstanceID后，会使用ECS实例的过期时间作为云盘的到期截止时间，无需再设置EndTime。

注意

仅包年包月云盘支持设置InstanceID参数。

InstanceID和EndTime参数只能二选一，同时传入InstanceID和EndTime参数，会报错。

若同时传入InstanceID和Times，优先使用InstanceID对应的实例过期时间。

ChargeType string 可选示例值：PostPaid

云盘的付费模式，取值说明如下：

PostPaid：按量计费

PrePaid：包年包月

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

OriginalAmount string 示例值：40

DiscountAmount string 示例值：40

PayableAmount string 示例值：40

ConfigItems object[] 示例值：-

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidVolumeSize	Invalid volume size.	云盘大小不合法。
412	InvalidInstanceExpireTime	Failed to retrieve the expiration time of the instance or the instance has already expired.	未查询到实例过期时间或该实例已到期。

云服务器