创建交易单 - CreateDeliveryOrder

功能介绍

创建交易单。

用户创建边缘小站后，通过交易单的形式选择一批待购买的资源。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

POST /v2/{domain_id}/delivery-orders

表1 路径参数
参数	是否必选	参数类型	描述
domain_id	是	String	path中租户的账号ID

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token

表3 请求Body参数
参数	是否必选	参数类型	描述
delivery_order	是	CreateDeliveryOrderOption object	创建交易单参数

表4 CreateDeliveryOrderOption
参数	是否必选	参数类型	描述
edge_site_id	是	String	边缘小站ID
servers	否	Array of ServerOption objects	订购服务器列表
network_devices	否	Array of NetworkDeviceOption objects	订购网络设备列表
storage_pools	否	Array of StorageOption objects	订购存储池列表
market_options	是	MarketCreateOption object	计费信息

表5 ServerOption
参数	是否必选	参数类型	描述
offering_id	否	String	服务器商品ID
count	否	Integer	数量

表6 NetworkDeviceOption
参数	是否必选	参数类型	描述
offering_id	否	String	网络设备商品ID
count	否	Integer	数量

表7 StorageOption
参数	是否必选	参数类型	描述
storage_type	是	String	存储类型
size	是	Integer	存储池大小。单位：TB。当边缘小站下已存在该类型存储池，则表示将扩容的存储池容量大小。

表8 MarketCreateOption
参数	是否必选	参数类型	描述
charge_mode	是	String	计费模式。 prepaid：包周期
prepaid_options	是	PrepaidCreateOption object	包周期计费参数
discounts	否	Array of Discount objects	折扣信息

表9 PrepaidCreateOption
参数	是否必选	参数类型	描述
period_type	是	String	包周期类型 year：包年
period_num	是	Integer	计费周期数
pay_mode	否	String	包周期付款类型 FULL: 全预付 HALF：半预付 PAID_BY_YEAR：按年付费 ZERO_PAID_BY_YEAR：零预付-按年 ZERO_PAID_BY_MONTH：零预付-按月

**表10** Discount
参数	是否必选	参数类型	描述
id	否	String	折扣ID
type	否	String	折扣类型 0：促销折扣；2：商务折扣；3：合作伙伴授予折扣；300：折扣券

响应参数

状态码：200

**表11** 响应Body参数
参数	参数类型	描述
delivery_order	SimpleDeliveryOrder object	交易单信息
order_ids	Array of strings	订单ID列表。该字段仅在创建交付单时返回。

**表12** SimpleDeliveryOrder
参数	参数类型	描述
id	String	交易ID
domain_id	String	用户ID
status	String	交易单状态 CANCELLED 已取消 PROCESSING 交易处理中 ACCEPTING 待验收 SUCCESS 交易成功 FAIL 交易失败 DELETED 已删除
edge_site_id	String	边缘小站ID
created_at	String	创建时间
updated_at	String	更新时间

请求示例

创建交易单

POST https://{ies_endpoint}/v2/{domain_id}/delivery-orders

{
  "delivery_order" : {
    "edge_site_id" : 0,
    "network_devices" : [ {
      "offering_id" : "00000000-0000-000-0000-000000000000",
      "count" : 1
    } ],
    "servers" : [ {
      "offering_id" : "00000000-0000-000-0000-000000000000",
      "count" : 1
    } ],
    "storage_pools" : [ {
      "storage_type" : "SSD",
      "size" : 26
    } ],
    "market_options" : {
      "charge_mode" : "prepaid",
      "prepaid_options" : {
        "period_type" : "year",
        "period_num" : 3,
        "pay_mode" : "FULL"
      }
    }
  }
}

响应示例

状态码：200

successful operation

{
  "delivery_order" : {
    "id" : "00000000-0000-000-0000-000000000000",
    "name" : "delivery_order-zurcq",
    "domain_id" : "00000000000000000000000000000000",
    "status" : "PROCESSING",
    "edge_site_id" : "00000000-0000-000-0000-000000000000",
    "created_at" : "2026-01-04T07:05:14.405839Z",
    "updated_at" : "2026-01-04T07:05:14.405839Z"
  },
  "order_ids" : [ "CS000000000000000" ]
}