全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

查询价格

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数
参数名称
类型
必填
描述
Action String
公共参数,本接口取值:DescribePrice。
Version String
公共参数,本接口取值:2016-03-04。
InstanceType String

实例套餐类型,如果调用时未指定实例套餐类型,默认值为I1.1A

示例值:——
SystemDisk.DiskSize String

云主机系统盘配置参数。若不指定该参数,则按照系统默认值进行分配。

示例值:——
ImageId String

镜像ID。

示例值:标准UUID格式,形如[1]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
ChargeType String

计费类型,调用时需要明确指定,无默认值。

示例值:Monthly(包年包月)、Daily(按量付费(按日月结))、 HourlyInstantSettlement(按量付费)。默认值 HourlyInstantSettlement(按量付费)
PurchaseTime Int

购买时长,单位月

示例值:当计费类型为Monthly(包年包月)时,有效值1-36;其他计费类型时,不需要传此参数
DataDiskGb Int

数据卷容量,单位GB,容量限制依据 实例套餐类型定义 变化,如果调用时未指定,则为相应实例套餐类型最小值。InstanceType为通用型主机N1、N2、N3或者为本地NVMe机型I4时,此参数不生效。。

示例值:-
DataDisk.N Object

数据盘(云盘)的类型,数据盘n的类型,n 的取值范围为 [1, 8]。只支持I2、I2联网增强、E1、N1、N2、N3、S3、I3、C3。DataDisk.n.Type与DataDisk.n.Size必须都填写才有效。

示例值:SSD3.0,EHDD
Type String
数据盘(云盘)的类型,数据盘n的类型,n 的取值范围为 [1, 8]。只支持I2、I2联网增强、E1、N1、N2、N3、S3、I3、C3。DataDisk.n.Type与DataDisk.n.Size必须都填写才有效。
示例值:SSD3.0,EHDD
Size Int
第 n 个数据盘(云盘)的容量大小,n 的取值范围为 [1, 8]。只支持I2、I2联网增强、E1、N1、N2、N3、S3、I3、C3。DataDisk.n.Type与DataDisk.n.Size必须都填写才有效。
示例值:最小值1,最大值为MIN(当前用户实例剩余配额,50),即用户剩余配额和50比较的小者
MaxCount Int

最大实例数。

示例值:最小值1,最大值为MIN(当前用户实例剩余配额,50),即用户剩余配额和50比较的小者
SystemDisk.DiskType String

不能给默认值,不传默认按价格体系配置systemDisk属性中第一个创建

返回参数

参数名称
类型
描述
RequestId String
示例值:42e45129-5a03-4705-b5bf-1f8180aa6448003
PriceInfo Object
InstancePrice Object
DiscountPrice Double

优惠金额;例如原价100元,成交价80元,该参数即为20。示例值:20

示例值:0
OriginalPrice Double

原价/列表价。示例值:100

示例值:0.524
TradePrice Double

成交价;例如原价100元,该套餐打8折,该参数即为80。示例值:80

示例值:0.524
PriceUnit String

价格单位

示例值:元
UserDiscount Double

用户折扣;合同约定的优惠折扣。示例值:8

示例值:2.01
EBSPrice Object

ebs盘价格

DiscountPrice Double
OriginalPrice Double
TradePrice Double
PriceUnit String
UserDiscount Double

请求示例

curl -X GET|POST
'http://kec.api.ksyun.com/?Action=DescribePrice&Version=2016-03-04'
-H 'authorization: xxx, SignedHeaders=content-type;host;x-amz-date, Signature=xxx'
-H 'cache-control: no-cache'
-H 'content-type: application/x-www-form-urlencoded'
-H 'host: kec.api.ksyun.com'
-H 'x-amz-date: 20170720T022802Z'
-d 'InstanceType=xxx&SystemDisk.DiskSize=xxx&ImageId=xxx&ChargeType=xxx&PurchaseTime=xxx&DataDiskGb=xxx&DataDisk.N.Type=xxx&DataDisk.N.Size=xxx&MaxCount=xxx&SystemDisk.DiskType=xxx'

返回示例

JSON格式

{
"RequestId":"42e45129-5a03-4705-b5bf-1f8180aa6448003",
"PriceInfo":{
"InstancePrice":{
"DiscountPrice":0,
"OriginalPrice":0.524,
"TradePrice":0.524
}
}
}

错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码

错误码
错误信息
Http状态码
描述
PurchaseTimeInvalidParameterValueAn invalid or out-of-range value was supplied for the "PurchaseTime" parameter.400“购买时长”参数的取值无效或者超出有效范围
ProductPermissionDeniedThis package cannot be used400用户不能使用该套餐
SystemDiskSizeInvalidAn invalid or out-of-range value was supplied for the "SystemDisk.DiskSize" parameter.400“系统盘大小”参数的取值无效或者超出有效范围.
InstanceTypeNotSupportDescribePriceThe Dedicated type host does not support describePrice operations.400专属类型虚机不支持查询价格.
EbsSystemDiskProductSellOutInvalidebs system disk [{0}] product already sell out.400此ebs系统盘[{0}]商品在该机房已售罄.
Payment.CalculateProductFailed暂无400暂无
DataDiskTypeRequiredDataDiskTypeRequired400
InstanceTypeNotSupportBindingEBSInstanceType does not support binding EBS.400实例类型不支持绑定ebs数据盘
RootDiskSizeLessThanImageSizeRootDiskSizeLessThanImageSize400系统盘容量不能小于镜像最小需求容量或者缺省容量
PaymentPayment.CalculateProductFailed400
纯净模式常规模式

纯净模式

点击可全屏预览文档内容