文档首页/ 数据接入服务 DIS/ API参考/ API说明/ 通道管理/ 提交云服务套餐包订单 - PostOrders
更新时间:2026-02-12 GMT+08:00

提交云服务套餐包订单 - PostOrders

功能介绍

本接口用于提交云服务的套餐包订单。

调用方法

请参见如何调用API。

URI

POST /v2/orders/{order_id}

表1 路径参数

参数

是否必选

参数类型

描述

order_id

是

String

订单ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。请参见认证鉴权-Token认证。

约束限制:

不涉及

取值范围:

长度为[1-32768]个字符。

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

cloudServices

否

Array of cloudServicesRequestEntry objects

参数解释:

云服务资源包信息详情。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

purchaseMode

否

Integer

参数解释:

购买场景模式。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

1

tenantId

否

String

参数解释:

租户id,和projectid的值一致。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表4 cloudServicesRequestEntry

参数

是否必选

参数类型

描述

chargingMode

否

Integer

参数解释:

计费模式。默认采用预付费。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

0

paymentMode

否

Integer

参数解释:

支付方式。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

0

periodNum

否

Integer

参数解释:

购买时长数,购买周期分为月度和年度,月度可选1-9月的整数,年度可选1-3年的整数。和periodType参数配合使用。

约束限制:

不涉及

取值范围:

periodType为2时,值为1-9的整数。

periodType为3时,值为1-3的整数。

默认取值:

1

periodType

否

Integer

参数解释:

购买时长类型,购买周分为月度和年度。periodType为2时代表月度,periodType为3时代表年度。

约束限制:

不涉及

取值范围:

  • 2:月度。

  • 3:年度。

默认取值:

2

cloudServiceForm

否

Array of cloudServiceFormRequestEntry objects

参数解释:

资源包类型信息,包含了云服务类型,projectid,订单id等资源信息。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

isAutoRenew

否

Boolean

参数解释:

是否开启了自动续订功能。

约束限制:

不涉及

取值范围:

  • 0:否

  • 1:是

默认取值:

0

isTrial

否

Boolean

参数解释:

当前订购是否处于试用期。

约束限制:

不涉及

取值范围:

  • 0:否

  • 1:是

默认取值:

0

cloudServiceType

否

String

参数解释:

云服务类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

xxx.service.type.dis

productInfos

否

Array of productInfosRequestEntry objects

参数解释:

产品信息,包含云产品类型、产品id、资源包名称等产品信息。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表5 cloudServiceFormRequestEntry

参数

是否必选

参数类型

描述

cloudservicetype

否

String

参数解释:

云服务类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

xxx.service.type.dis

projectid

否

String

参数解释:

项目ID。获取方法,请参见获取项目ID。

约束限制:

不涉及

取值范围:

只能由英文字母和数字组成,且长度为[1-64]个字符。

默认取值:

不涉及

orderid

否

String

参数解释:

订单ID,每个订单只有一个唯一的订单id。

约束限制:

不涉及

取值范围:

只能由英文字母和数字组成,且长度为[1-64]个字符。

默认取值:

不涉及

表6 productInfosRequestEntry

参数

是否必选

参数类型

描述

productId

否

String

参数解释:

购买产品ID,每个产品的ID值唯一。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

resourceSpecCode

否

String

参数解释:

资源包名称。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

dis.general.partition.duration.pkg

resourceType

否

String

参数解释:

资源类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

xxx.service.type.dis

响应参数

状态码:200

正常返回

无

请求示例

POST https://{Endpoint}/v2/orders/{order_id}

{
  "cloudServices" : {
    "avalibleZoneId" : "",
    "chargingMode" : 0,
    "cloudServiceEndpoint" : "",
    "cloudServiceForm" : {
      "projectid" : "5d5916d21xxx46efbe7c2e93bd1xxxce",
      "orderid" : "CS25110715xxx86MU",
      "cloudServiceType" : "xxx.service.type.dis"
    },
    "cloudServiceType" : "xxx.service.type.dis",
    "isAutoRenew" : 0,
    "isTrial" : 0,
    "paymentMode" : 0,
    "periodNum" : 1,
    "periodType" : 2,
    "productInfos" : {
      "cloudServiceType" : "xxx.service.type.dis",
      "productId" : "00301-261175-0--0",
      "resourceSpecCode" : "dis.general.partition.duration.pkg",
      "resourceType" : "xxx.resource.type.dis"
    },
    "regionId" : "xx-xxx-x",
    "subscriptionNum" : 1
  },
  "discountId" : "",
  "purchaseMode" : 1,
  "tenantId" : "5d5916d21xxx46efbe7c2e93bd1xxxce"
}

响应示例

无

状态码

状态码

描述

200

正常返回

错误码

请参见错误码。