Creating an Order

Function

Create an order.

After creating an edge site, you can order the resources you need.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, no identity policy-based permission required for calling this API.

URI

POST /v2/{domain_id}/delivery-orders

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
domain_id	Yes	String	Account ID in the path.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
delivery_order	Yes	CreateDeliveryOrderOption object	Parameters for creating an order.

**Table 4** CreateDeliveryOrderOption
Parameter	Mandatory	Type	Description
edge_site_id	Yes	String	Edge site ID.
servers	No	Array of ServerOption objects	The list of servers in the order.
network_devices	No	Array of NetworkDeviceOption objects	The list of network devices in the order.
storage_pools	No	Array of StorageOption objects	The list of storage pools in the order.
market_options	Yes	MarketCreateOption object	Billing information.

**Table 5** ServerOption
Parameter	Mandatory	Type	Description
offering_id	No	String	Server offering ID.
count	No	Integer	Quantity.

**Table 6** NetworkDeviceOption
Parameter	Mandatory	Type	Description
offering_id	No	String	Network device offering ID.
count	No	Integer	Quantity.

**Table 7** StorageOption
Parameter	Mandatory	Type	Description
storage_type	Yes	String	Storage type.
size	Yes	Integer	Storage pool size (TB). If a storage pool of this type already exists at the edge site, the parameter value is the capacity of the storage pool to be expanded.

**Table 8** MarketCreateOption
Parameter	Mandatory	Type	Description
charge_mode	Yes	String	Billing mode. prepaid: yearly/monthly
prepaid_options	Yes	PrepaidCreateOption object	Yearly/Monthly billing parameters.
discounts	No	Array of Discount objects	Discount information.

**Table 9** PrepaidCreateOption
Parameter	Mandatory	Type	Description
period_type	Yes	String	Yearly/Monthly type. year
period_num	Yes	Integer	Billing cycles.
pay_mode	No	String	Yearly/monthly payment type. Options: FULL: All upfront payments HALF: Half upfront payments PAID_BY_YEAR: Yearly payments ZERO_PAID_BY_YEAR:Yearly payments without upfront ZERO_PAID_BY_MONTH: Monthly payments without upfront

**Table 10** Discount
Parameter	Mandatory	Type	Description
id	No	String	Discount ID.
type	No	String	Discount type. 0: promotional discount; 2: commercial discount; 3: partner-authorized discount; 300: discount coupon.

Response Parameters

Status code: 200

**Table 11** Response body parameters
Parameter	Type	Description
delivery_order	SimpleDeliveryOrder object	Order information.
order_ids	Array of strings	Order ID list. This field is returned only when a delivery order is created.

**Table 12** SimpleDeliveryOrder
Parameter	Type	Description
id	String	Order ID.
domain_id	String	User ID.
status	String	Order status. CANCELLED: Canceled PROCESSING: Processing ACCEPTING: Acceptance pending SUCCESS: Succeeded FAIL: Failed DELETED: Deleted
edge_site_id	String	Edge site ID.
created_at	String	Creation time.
updated_at	String	Update time.

Example Requests

Creating an order

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

Example Responses

Status code: 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" ]
}