Instance Ordering
Function
This API is used to place an order based on the billing mode and billing period.
URI
POST /v1/{project_id}/period/order
| 
        Parameter  | 
      
        Mandatory  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|---|
| 
        project_id  | 
      
        Yes  | 
      
        String  | 
      
        Project ID.  | 
     
Request Parameters
| 
        Parameter  | 
      
        Mandatory  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|---|
| 
        charging_mode  | 
      
        Yes  | 
      
        Integer  | 
      
        Billing mode. The options are as follows: 0: yearly/monthly; 1: pay-per-use; 2: one-off.  | 
     
| 
        cloud_service_type  | 
      
        Yes  | 
      
        String  | 
      
        Cloud service type  | 
     
| 
        composite_product_id  | 
      
        No  | 
      
        String  | 
      
        Package ID  | 
     
| 
        discount_id  | 
      
        No  | 
      
        String  | 
      
        Discount ID  | 
     
| 
        is_auto_renew  | 
      
        No  | 
      
        Integer  | 
      
        Auto-renewal  | 
     
| 
        period_num  | 
      
        Yes  | 
      
        Integer  | 
      
        Subscription periods  | 
     
| 
        period_type  | 
      
        Yes  | 
      
        Integer  | 
      
        Subscription period type. The options are as follows: 2: month; 3: year.  | 
     
| 
        product_infos  | 
      
        Yes  | 
      
        Array of ProductInfoBean objects  | 
      
        Product information list  | 
     
| 
        promotion_activity_id  | 
      
        No  | 
      
        String  | 
      
        Promotion ID  | 
     
| 
        promotion_info  | 
      
        No  | 
      
        String  | 
      
        Promotion information  | 
     
| 
        region_id  | 
      
        Yes  | 
      
        String  | 
      
        ID of the region where the current project is, for example, xx-xx-1.  | 
     
| 
        zone  | 
      
        Yes  | 
      
        String  | 
      
        Country/Region  | 
     
| 
        Parameter  | 
      
        Mandatory  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|---|
| 
        all_resource_names  | 
      
        No  | 
      
        Array of strings  | 
      
        Resource list  | 
     
| 
        cloud_service_type  | 
      
        Yes  | 
      
        String  | 
      
        Cloud service type  | 
     
| 
        display_id  | 
      
        No  | 
      
        String  | 
      
        Display ID  | 
     
| 
        product_id  | 
      
        Yes  | 
      
        String  | 
      
        Product ID  | 
     
| 
        product_spec_desc  | 
      
        No  | 
      
        String  | 
      
        Product specification description  | 
     
| 
        resource_name  | 
      
        No  | 
      
        String  | 
      
        Resource name  | 
     
| 
        resource_size  | 
      
        Yes  | 
      
        Integer  | 
      
        Number of databases supported by the product or the number of OBS scans supported by the product  | 
     
| 
        resource_size_measure_id  | 
      
        Yes  | 
      
        Integer  | 
      
        Resource capacity measurement ID. The example values are as follows: 15: mbps (used when bandwidth is purchased), 17: gb (used when EVS disks are purchased), 14: number/time.  | 
     
| 
        resource_spec_code  | 
      
        Yes  | 
      
        String  | 
      
        Product code  | 
     
| 
        resource_type  | 
      
        Yes  | 
      
        String  | 
      
        Resource type  | 
     
| 
        usage_factor  | 
      
        No  | 
      
        String  | 
      
        Coefficient in use  | 
     
| 
        usage_measure_id  | 
      
        No  | 
      
        Integer  | 
      
        Capacity measurement ID in use  | 
     
| 
        usage_value  | 
      
        No  | 
      
        Double  | 
      
        Value in use  | 
     
Response Parameters
Status code: 200
| 
        Parameter  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|
| 
        order_id  | 
      
        String  | 
      
        Order ID  | 
     
Status code: 400
| 
        Parameter  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        Error Code  | 
     
| 
        error_msg  | 
      
        String  | 
      
        Error Message  | 
     
Example Requests
Purchase the hws.service.type.sdg cloud service instance for two months for the xxxxxxxxxxxx project in China. This product supports the scanning of XX database or OBS instances.
POST /v1/{project_id}/period/order
{
  "charging_mode" : 0,
  "cloud_service_type" : "hws.service.type.sdg",
  "is_auto_renew" : 0,
  "period_num" : 1,
  "period_type" : 2,
  "region_id" : "xxxxxxxxxxxx",
  "zone" : "CH",
  "product_infos" : [ {
    "cloud_service_type" : "hws.service.type.sdg",
    "product_id" : "xxxxxxxxxxxx",
    "resource_size" : 30,
    "resource_size_measure_id" : 30,
    "resource_spec_code" : "base_professional",
    "resource_type" : "hws.resource.type.dsc.base"
  } ]
}
 Example Responses
Status code: 200
OK
{
  "order_id" : "xxxxxxxxxxxx"
}
  Status code: 400
Invalid request.
{
  "error_code" : "dsc.40000011",
  "error_msg" : "Invalid parameter"
}
 Status Codes
| 
        Status Code  | 
      
        Description  | 
     
|---|---|
| 
        200  | 
      
        OK  | 
     
| 
        400  | 
      
        Invalid request.  | 
     
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.