云主机 > API 文档 > 财务 >询价

询价

最近更新时间: 2021-06-03 11:32:18

请求路径

POST /v1/cm/price

请求参数

名称	类型	位置	必须	描述
infos	Enquiry[]	body	是	询价请求列表

Enquiry

名称	类型	描述
region_id	string	地域 ID。您可以调用 DescribeRegions 查看最新的七牛云地域列表
cost_charge_type	string	付费方式: PostPaid: 按需计费 PrePaid: 预付费
cost_charge_mode	string	计费方式 PayByBandwidth: 按照带宽计费 PayByTraffic: 按照流量计费 PayByDisk: 按磁盘使用计费 PayByInstance: 按主机规格使用计费 PayBySlbSpec: 按 SLB 实例规格计费 PayByRedis: 按 Redis 实例规格计费 PayByMongo: 按 Mongo 实例规格计费 PayByVRouterInterface: 按 VRouterInterface 实例规格计费 PayBy95: 按增强型95计费 PayByRds: 按 RDS 实例规格计费 PayByVpn: 按 vpn 规格计费 PayByNATGatewaySpec: 按高速通道规格计费 PayByNewBgpIp: 安全产品新BGP PayByBgpIp: 安全产品高防 PayByWaf: 安全产品WAF PayByPolarDB: 按 PolarDB 节点规格计费
cost_period_unit	string	计费单位 Hour, Day, Week, Month, Year
cost_period	integer	计费周期
cost_period	integer	计费周期
order_type	string	订单类型 create: 新建 renew: 续费 upgrade: 升配 replace_system_disk: 更换系统盘 to_prepaid_disk: 按需磁盘转包月 renew_with_spec: 续费变配
amount	integer	数量
info_items	EnquiryItem[]

EnquiryItem

名称	类型	描述
resource_type	string	资源类型 instance: 主机 disk: 磁盘 ip: 弹性公网IP snapshot: 快照 common_bandwidth：共享带宽
resource_id	string	资源 ID，升配询价时必填
expire_time	int64	过期时间，unix时间戳，升配询价时必填
item_info	EnquiryItemInfo	资源价格相关参数 "ratio": 20 ，共享带宽增强型95 必填

请求 Body 示例

{
  "infos": [
    {
      "region_id": "cn-shanghai",
      "order_type": "create",
      "amount": 1,
      "cost_period_unit": "Day",
      "cost_period": 1,
      "cost_charge_type": "PostPaid",
      "cost_charge_mode": "PayBy95",
      "info_items": [
        {
          "resource_type": "common_bandwidth",
          "item_info": {
            "bandwidth": 200,
            "ratio": 20
          }
        }
      ]
    }
  ]
}

主机 EnquiryItemInfo

名称	类型	描述
instance_type	string	实例规格，您可以通过以下接口查询 [实例/查看实例规格详情列表](https://developer.qiniu.com/qvm/5594/openapi-ecs-describe-instance-type) [实例/查看可用资源列表](https://developer.qiniu.com/qvm/5595/openapi-ecs-describe-available-resources)

云硬盘 EnquiryItemInfo

名称	类型	描述
size	int	云盘大小，单位 GB
category	int	云盘种类资源池一取值范围： cloud：普通云盘 cloud_efficiency：高效云盘 cloud_ssd：SSD 云盘 cloud_essd：ESSD 云盘资源池二取值范围： H_ESSD：极速型 SSD H_SSD：超高 IO H_GPSSD：通用型 SSD H_SAS：高 IO H_SATA：普通 IO
performance_level	string	云盘种类为 ESSD 云盘时必填，指定云盘的性能等级。取值范围： PL1（默认）：单盘最高随机读写 IOPS 5 万 PL2：单盘最高随机读写 IOPS 10 万 PL3：单盘最高随机读写 IOPS 100 万有关如何选择 ESSD 性能等级，请参见 ESSD 云盘。

名称

类型

描述

size

int

云盘大小，单位 GB

弹性公网 IP EnquiryItemInfo

名称	类型	描述
bandwidth	int	带宽大小，单位 Mbps
isp	string	线路类型资源池一取值范围： BGP：多线BGP BGP_PRO：精品BGP，目前仅香港地域支持资源池二取值范围： 5_bgp：多线BGP

名称

类型

描述

bandwidth

int

带宽大小，单位 Mbps

isp

string

线路类型

资源池一取值范围：

BGP：多线BGP
BGP_PRO：精品BGP，目前仅香港地域支持

资源池二取值范围：

5_bgp：多线BGP

请求 Body 示例

{
  "infos": [
    {
      "region_id": "cn-qingdao",
      "order_type": "create",
      "amount": 1,
      "cost_charge_mode": "PayByInstance",
      "cost_charge_type": "PrePaid",
      "cost_period": 1,
      "cost_period_unit": "Month",
      "info_items": [
        {
          "resource_type": "instance",
          "item_info": {
            "instance_type": "ecs.se1ne.2xlarge"
          }
        },
        {
          "resource_type": "disk",
          "item_info": {
            "category": "cloud_efficiency",
            "size": 40
          }
        }
      ]
    }
  ]
}

返回值

名称	类型	描述
request_id	string	请求 ID
data	EnquiryResultItem[]	价格信息

EnquiryResultItem < EnquiryItem

名称	类型	描述
atomic_items	EnquiryAtomicItem[]	计费单元列表

EnquiryAtomicItem

名称	类型	描述
amount	int	本计费单元实际计费数量
price	float64	本计费单元总价格
price_item	stirng	计费单元 key

返回值示例

{
  "data": {
    "infos": [
      {
        "amount": 1,
        "info_items": [
          {
            "resource_type": "instance",
            "item_info": {
              "instance_type": "ecs.se1ne.2xlarge"
            }
          },
          {
            "resource_type": "disk",
            "item_info": {
              "category": "cloud_efficiency",
              "size": 40
            }
          }
        ],
        "atomic_items": [
          {
            "price_item": "qvm:instance:ecs.se1ne.2xlarge:for_trade:1month",
            "product_item": "qvm:instance:ecs.se1ne.2xlarge",
            "amount": 1,
            "price": 1321.26,
            "resource_type": "instance"
          },
          {
            "price_item": "qvm:disk:cloud_efficiency:for_trade:1month",
            "product_item": "qvm:disk:cloud_efficiency",
            "amount": 4,
            "price": 13.3,
            "resource_type": "disk"
          }
        ],
        "cost_charge_type": "PrePaid",
        "cost_charge_mode": "PayByInstance",
        "cost_period_unit": "Month",
        "cost_period": 1,
        "cost_seconds": 0,
        "order_type": "create",
        "region_id": "cn-qingdao"
      }
    ]
  },
  "request_id": "ScKvEWjlTG6Ba1kW"
}

以上内容是否对您有帮助？