调用 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

订单来源（未启用）

返回数据

名称 类型 示例值 描述
InstanceIds List 5604018

实例 ID
OrderId String 202********0117

订单 ID
RequestId String 4ca591b5-bc30-4fa7-aeaa-c4d0ec5d24ed

请求 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"
}

错误码

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