调用 CreateOrder 创建订单。

请确保在使用该接口前,已充分了解云市场产品的收费方式和价格

商业镜像创建订单接口请参考 CreateInstance

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateOrder

系统规定参数。取值:CreateOrder。

ClientToken String 2709c68a-d569-4819-9c5d-1222ed2ee924

用于保证请求的幂等性。

由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。

Commodity String InstanceBuyCommodity示例:{"components":{"package_version":"yuncode1394000000"},"duration":100,"pricingCycle":"Year","productCode":"cmfw019940","properties":{},"quantity":1,"skuCode":"cmfw019940-prepay"};InstanceRenewCommodity示例:{“components”:{“package_version”:”yuncode1806900001”},”quantity”:1,”duration”:2,”instanceId”:”6227091”,”productCode”:”cmgj024069”,”pricingCycle”:”Month”,”properties”:{},”skuCode”:”cmgj024069-prepay”};InstanceUpgradeCommodity示例:{“components”:{“package_version”:”yuncode1806900002”},”quantity”:1,”duration”:1,”instanceId”:”6227091”,”productCode”:”cmgj024069”,”pricingCycle”:”Month”,”properties”:{},”skuCode”:”cmgj024069-prepay”}

订单配件信息。

可根据指定的 OrderType,使用对应的配件再进行序列化。

不同 OrderType 分别对应的 CommodityType 如下所示:

  • INSTANC_BUY:InstanceBuyCommodity
  • INSTANCE_RENEW:InstanceRenewCommodity
  • INSTANCE_UPGRADE:InstanceUpgradeCommodity

示例中的 Commodity 参数说明如下:

  • 必传参数
    • productCode:商品码
    • skuCode:商品规格码。预付费固定为 prepay,后付费固定为 postpay。
    • duration:周期数量 1,2,3...。
    • pricingCycle:周期单位。Day(日),Month(月),Year(年)。
    • components:规格模块。其中版本 package_version 必传,其他模块根据商品的设置来传。
  • 可选参数
    • quantity:订购数量
    • queryPromotion:是否查询优惠
    • couponId:优惠卷 ID
    • properties:订单扩展属性字符串,JSON 的 dict 格式
OrderType String INSTANCE_BUY

订单类型。 取值:

  • INSTANCE_BUY:商品购买
  • INSTANCE_RENEW:实例续费
  • INSTANCE_UPGRADE:实例升级
PaymentType String HAND

付款方式:

  • AUTO:余额自动支付
  • HAND:手动支付
OrderSouce String abc

订单来源 (未启用)

返回数据

名称 类型 示例值 描述
RequestId String 4ca591b5-bc30-4fa7-aeaa-c4d0ec5d24ed

请求 ID

OrderId String 202********0117

订单 ID

InstanceIds List 5604018

实例 ID

示例

请求示例

https://market.aliyuncs.com/?Action=CreateOrder
&ClientToken=2709c68a-d569-4819-9c5d-1222ed2ee924
&Commodity={"components":{"package_version":"yuncode1394000000"},"duration":100,"pricingCycle":"Year","productCode":"cmfw019940","properties":{},"quantity":1,"skuCode":"cmfw019940-prepay"}
&OrderType=INSTANCE_BUY
&PaymentType=HAND
&<公共请求参数>

正常返回示例

XML 格式

<CreateOrderResponse>
  <RequestId>4ca591b5-bc30-4fa7-aeaa-c4d0ec5d24ed</RequestId>
  <InstanceIds>
        <InstanceId>5604018</InstanceId>
  </InstanceIds>
  <OrderId>202********0117</OrderId>
</CreateOrderResponse>

JSON 格式

{
    "RequestId":"4ca591b5-bc30-4fa7-aeaa-c4d0ec5d24ed",
    "InstanceIds":{
        "InstanceId":["5604018"]
        },
    "OrderId":"202********0117"
}

错误码

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