# 创建交易单 - CreateDeliveryOrder #### 功能介绍 创建交易单。 用户创建边缘小站后，通过交易单的形式选择一批待购买的资源。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/IES/doc?api=CreateDeliveryOrder)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cloudpond/ies_05_0800.html)。 - 如果使用身份策略授权，当前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 | 创建交易单参数 | 表4CreateDeliveryOrderOption | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 计费信息 | 表5ServerOption | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | offering_id | 否 | String | 服务器商品ID | | count | 否 | Integer | 数量 | 表6NetworkDeviceOption | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | offering_id | 否 | String | 网络设备商品ID | | count | 否 | Integer | 数量 | 表7StorageOption | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | storage_type | 是 | String | 存储类型 | | size | 是 | Integer | 存储池大小。单位：TB。 当边缘小站下已存在该类型存储池，则表示将扩容的存储池容量大小。 | 表8MarketCreateOption | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | charge_mode | 是 | String | 计费模式。 - prepaid：包周期 | | prepaid_options | 是 | [PrepaidCreateOption] object | 包周期计费参数 | | discounts | 否 | Array of [Discount] objects | 折扣信息 | 表9PrepaidCreateOption | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | period_type | 是 | String | 包周期类型 - year：包年 | | period_num | 是 | Integer | 计费周期数 | | pay_mode | 否 | String | 包周期付款类型 - FULL: 全预付 - HALF：半预付 - PAID_BY_YEAR：按年付费 - ZERO_PAID_BY_YEAR：零预付-按年 - ZERO_PAID_BY_MONTH：零预付-按月 | 表10Discount | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | id | 否 | String | 折扣ID | | type | 否 | String | 折扣类型 0：促销折扣；2：商务折扣；3：合作伙伴授予折扣；300：折扣券 | #### 响应参数 **状态码：200** 表11响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | delivery_order | [SimpleDeliveryOrder] object | 交易单信息 | | order_ids | Array of strings | 订单ID列表。该字段仅在创建交付单时返回。 | 表12SimpleDeliveryOrder | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cloudpond/ErrorCode.html)。