文档首页/ 数据接入服务 DIS/ API参考/ API说明/ 通道管理/ 提交云服务套餐包订单 - PostOrders
更新时间:2025-11-13 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

Int

参数解释

购买场景模式。

约束限制

不涉及

取值范围

不涉及

默认取值

1

tenantId

String

参数解释

租户id,和projectid的值一致。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表4 cloudServicesRequestEntry

参数

是否必选

参数类型

描述

chargingMode

Int

参数解释

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

约束限制

不涉及

取值范围

不涉及

默认取值

0

paymentMode

Int

参数解释

支付方式。

约束限制

不涉及

取值范围

不涉及

默认取值

0

periodNum

Int

参数解释

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

约束限制

不涉及

取值范围

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

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

默认取值

1

periodType

Int

参数解释

购买时长类型,购买周分为月度和年度。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

参数解释

云服务类型。

约束限制

不涉及

取值范围

不涉及

默认取值

hws.service.type.dis

productInfos

Array of productInfosRequestEntry objects

参数解释

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

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表5 cloudServiceFormRequestEntry

参数

是否必选

参数类型

描述

cloudservicetype

String

参数解释

云服务类型。

约束限制

不涉及

取值范围

不涉及

默认取值

hws.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

参数解释

资源类型。

约束限制

不涉及

取值范围

不涉及

默认取值

hws.service.type.dis

响应参数

状态码:200

正常返回

请求示例

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

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

响应示例

状态码

状态码

描述

200

正常返回

错误码

请参见错误码

相关文档