文档首页/ CloudPond云服务/ API参考/ API/ 交易单/ 创建交易单 - CreateDeliveryOrder
更新时间:2026-01-29 GMT+08:00
分享

创建交易单 - 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" ]
}

状态码

状态码

描述

200

successful operation

错误码

请参见错误码

相关文档