云企业路由器按需订单订购
接口功能介绍
按需订单订购，包括云企业路由器流量计费订单，网络实例计费订单
接口约束
无
URI
POST /v4/ec/cgw-bill/new
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| ecID | 是 | String | 云间高速ID | 3acd1ed4-426a-4ea0-a8e4-8584657cddee | |
| resourceID | 否 | String | 资源ID | 100054c0416811e9a6690242ac110002 | |
clientToken | 否 | String | 客户端存根，用于保证订单幂等性。要求单个云平台账户内唯一 | unique-any-string | |
payVoucherPrice | 否 | String | 代金券金额，只适用于预付费客户自动支付，若代金券支付金额传0或者控制符，则不适用代金券支付（小数会只保留2位，非负） | 1 |
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 否 | Integer | 返回状态码 取值范围: 800:成功 900:失败 | 800 | |
| errorCode | 否 | String | 业务细分码，为product.module.code三段式码 | ||
| message | 否 | String | 失败时的错误描述，一般为英文描述 | ||
| description | 否 | String | 失败时的错误描述，一般为中文描述 | ||
| traceID | 否 | String | 链路追踪ID | 74cb2e66-1f95-45da-aac5-ee013470fd96 | |
| returnObj | 否 | Object | 返回参数 | returnObj |
表returnObj
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
masterResourceStatus | 否 | String | 主资源状态，只有主订单资源会返回 | started |
|
regionID | 否 | String | 资源所属资源池ID | 81f7728662dd11ec810800155d307d5b |
|
masterOrderID | 否 | String | 订单ID。调用方在拿到masterOrderID之后，在若干错误情况下，可以使用materOrderID进一步确认订单状态及资源状态 | abe476445e4411edb4f40242ac110003 |
|
masterResourceID | 否 | String | 主资源ID | d708e8925dc743829cfc5b26c3d314e2 |
|
masterOrderNO | 否 | String | 订单号 | 20250728174645427013 |
|
resources | 否 | Array of Objects | 资源明细列表，参考表resources | resources |
|
表resources
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| orderID | 否 | String | 订单ID | bb4e607c0da348a6ab6be71c10fc2a5b | |
status | 否 | Integer | 资源状态。参考masterResourceStatus | 2 |
|
isMaster | 否 | Boolean | 布尔类型，是否是主资源项 | true |
|
resourceType | 否 | String | 本参数表示订单资源类型 | TGW_TRAFFIC | |
| resourceID | 否 | String | 资源ID | 795158016fed44fa9867433c9f162ed6 | |
masterOrderID | 否 | String | 订单ID。调用方在拿到masterOrderID之后，在若干错误情况下，可以使用materOrderID进一步确认订单状态及资源状态 | 1 | |
masterResourceID | 否 | String | 主资源ID | d708e8925dc743829cfc5b26c3d314e2 | |
itemValue | 否 | Integer | 资源规格，带宽包大小，单位MB | 5 | |
startTime | 否 | Integer | 启动时刻，epoch时戳，毫秒精度 | 1667902478000 | |
createTime | 否 | Integer | 创建时刻，epoch时戳，毫秒精度 | 1667902456000 | |
updateTime | 否 | Integer | 更新时刻，epoch时戳，毫秒精度 | 1667902481000 | |
expireTime | 否 | Integer | 过期时刻，epoch时戳，毫秒精度 | 1667902480000 |
请求示例
请求url
无
请求头header
无
请求体body
{
"ecID": "6c8dfd73-b43f-4d73-a99f-9cc33120f137"
}响应示例
{
"returnObj": {
"masterResourceStatus": "started",
"regionID": null,
"masterOrderID": "db8175d66bf54c109baafb598e3f40e4",
"masterResourceID": "d304a2303df647929dd72c2173bddb2f",
"masterOrderNO": "20250728192913837059",
"resources": [
{
"orderID": "6ee1846d02d64100aa2ff267097fcd3c",
"status": 2,
"isMaster": true,
"resourceType": "TGW_TRAFFIC",
"resourceID": "d304a2303df647929dd72c2173bddb2f",
"masterOrderID": "db8175d66bf54c109baafb598e3f40e4",
"updateTime": 1753702166000,
"expireTime": 4909375762000,
"masterResourceID": "d304a2303df647929dd72c2173bddb2f",
"itemValue": 1,
"startTime": 1753702162000,
"createTime": 1753702157000
},
{
"orderID": "6ee1846d02d64100aa2ff267097fcd3c",
"status": 2,
"isMaster": false,
"resourceType": "tgw_attachments",
"resourceID": "b7427a5993104f78ba5fc9fecf442d20",
"masterOrderID": "db8175d66bf54c109baafb598e3f40e4",
"updateTime": 1753702166000,
"expireTime": 4909375762000,
"masterResourceID": "d304a2303df647929dd72c2173bddb2f",
"itemValue": 1,
"startTime": 1753702162000,
"createTime": 1753702157000
}
]
},
"message": "success",
"description": "成功",
"statusCode": 800
}状态码
| 状态码 | 含义 |
|---|---|
| 200 | 请求成功 |
错误码
| errorCode | 含义 |
|---|---|
| Openapi.PatternCheck.NotValid | 请求参数无效 |
| Openapi.RouteMAPEc.AccessFailed | 内部错误，请重试。如果多次尝试失败，请提交工单 |
