查看主机价格

DescribePrice

支持查看主机价格。

Request Parameters（请求参数）

InstanceType

• 实例套餐类型，如果调用时未指定实例套餐类型，默认值为I1.1A
• 类型: String
• 是否可缺省: 否

SystemDisk

• 云主机系统盘配置参数。若不指定该参数，则按照系统默认值进行分配。
• 类型：SystemDisk
• 是否可缺省：是

ImageId

• 镜像ID
• 类型: String
• 有效值：标准UUID格式，形如^[1]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
• 是否可缺省: 否
• 参考值：centos7.6：48de6f74-e287-45df-b55e-94266d77483f

ChargeType

• 计费类型，调用时需要明确指定，无默认值
• 类型: String
• 有效值：Monthly(包年包月）、Daily（按量付费（按日月结）)、 HourlyInstantSettlement（按量付费）。默认值 HourlyInstantSettlement（按量付费）
• 是否可缺省: 是

PurchaseTime

• 购买时长，单位月
• 类型: Integer
• 有效值：当计费类型为Monthly（包年包月）时，有效值1-36；其他计费类型时，不需要传此参数
• 是否可缺省: 是

DataDiskGb

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

DataDisk.n.Type

• 数据盘（云盘）的类型，数据盘n的类型，n 的取值范围为 [1, 8]。只支持I2、I2联网增强、E1、N1、N2、N3、S3、I3、C3。DataDisk.n.Type与DataDisk.n.Size必须都填写才有效。
• 类型：String
• 有效值： SSD3.0，EHDD
• 是否可缺省：是

DataDisk.n.Size

• 第 n 个数据盘（云盘）的容量大小，n 的取值范围为 [1, 8]。只支持I2、I2联网增强、E1、N1、N2、N3、S3、I3、C3。DataDisk.n.Type与DataDisk.n.Size必须都填写才有效。
• 类型：Integer
• 有效值： [10，16000]
• 是否可缺省：是

MaxCount

• 最大实例数
• 类型: Integer
• 有效值: 最小值1，最大值为MIN(当前用户实例剩余配额，50），即用户剩余配额和50比较的小者
• 是否可缺省: 是

Response Elements（返回值）

RequestId

• 请求ID
• 类型: String
• 是否可缺省: 否

PriceInfo（价格信息类型）

• Instanceprice （主机价格数据类型）
• EBSprice（EBS价格数据类型）

Sample Request(请求)

http://kec.{{region}}.api.ksyun.com/?Action=DescribePrice&Version=2016-03-04&InstanceType=N3.2B&ImageId=6e37ed46-61a2-4f0a-9f4a-dcdd0817917c

Sample Response（返回）

{
    "RequestId": "42e45129-5a03-4705-b5bf-1f8180aa6448003",
    "PriceInfo": {
        "InstancePrice": {
            "DiscountPrice": 0,//折扣价格，例如100元打八折，该参数为20.
            "OriginalPrice": 0.524,//原价
            "TradePrice": 0.524,//成交价，例如例如100元打八折，该参数为80.
            "PriceUnit": "Hour"
        }
    }
}

---

1. 0-9a-f ↩︎