95计费订购
更新时间 2025-08-01 19:00:46
最近更新时间: 2025-08-01 19:00:46
95计费带宽包创建
接口功能介绍
95计费带宽包创建
接口约束
无
URI
POST /v4/ec/packet-95/new
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池ID | 100054c0416811e9a6690242ac110002 | |
| ecID | 是 | String | 云间高速ID | 3acd1ed4-426a-4ea0-a8e4-8584657cddee | |
| packetName | 是 | String | 带宽包名字 | cloudhigh-packet02-openapi | |
| bandwidth | 是 | Integer | 带宽，单位MB | 5 | |
| packetType | 是 | String | 带宽包类型，取值如下： "1": 95带宽包 | 1 | |
| clientToken | 否 | String | 客户端存根，用于保证订单幂等性。要求单个云平台账户内唯一 | unique-any-string | |
| areaA | 否 | String | 区域A类型，取值如下： "china": 中国大陆, "APAC":亚太 默认china | china | |
| areaB | 否 | String | 区域B类型，取值如下： "china": 中国大陆, "APAC":亚太 默认china | china | |
| projectID | 否 | String | 项目ID | 0 | |
| payVoucherPrice | 否 | String | 代金券金额，只适用于预付费客户自动支付，若代金券支付金额传0或者控制符，则不适用代金券支付（小数会只保留2位，非负） | 0 |
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| 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进一步确认订单状态及资源状态 | |
| masterResourceID | 否 | String | 主资源ID | d708e8925dc743829cfc5b26c3d314e2 |
| masterOrderNO | 否 | String | 订单号 | |
| resources | 否 | Array of Objects | 资源明细列表,参考表resources |
表Resource
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| orderID | 否 | String | 订单ID | bb4e607c0da348a6ab6be71c10fc2a5b | |
| status | 否 | Integer | 资源状态。参考masterResourceStatus | 2 | |
| isMaster | 否 | Boolean | 布尔类型，是否是主资源项 | true | |
| resourceType | 否 | String | 本参数表示订单资源类型 | BANDWIDTH_95PEAK | |
| resourceID | 否 | String | 单项资源的变配、续订、退订等需要该资源项的ID | d708e8925dc743829cfc5b26c3d314e2 | |
| masterOrderID | 否 | String | 订单ID。调用方在拿到masterOrderID之后，在若干错误情况下，可以使用materOrderID进一步确认订单状态及资源状态 | ||
| updateTime | 否 | Integer | 更新时刻，epoch时戳，毫秒精度 | 1667902481000 | |
| expireTime | 否 | Integer | 过期时刻，epoch时戳，毫秒精度 | 1667902480000 | |
| masterResourceID | 否 | String | 主资源ID | d708e8925dc743829cfc5b26c3d314e2 | |
| itemValue | 否 | Integer | 资源规格，带宽包大小，单位MB | 5 | |
| startTime | 否 | Integer | 启动时刻，epoch时戳，毫秒精度 | 1667902478000 | |
| createTime | 否 | Integer | 创建时刻，epoch时戳，毫秒精度 | 1667902456000 |
请求示例
请求url
无
请求头header
无
请求体body
{
"packetName": "A-A-B",
"regionID": "81f7728662dd11ec810800155d307d5b",
"ecID": "9d8d02de-28fb-4b6d-8aa9-659bc3066282",
"bandwidth": 1,
"packetType": "1"
}响应示例
{
"returnObj": {
"masterResourceStatus": "started",
"regionID": "81f7728662dd11ec810800155d307d5b",
"masterOrderID": "82113e40a7ce4dc982a6abb577cd369b",
"masterResourceID": "c25219574ba947a89208be8e6c5179be",
"masterOrderNO": "20250728174645427013",
"resources": [
{
"orderID": "b8361c6cb0214604befa8127d11c848e",
"status": 2,
"isMaster": true,
"resourceType": "BANDWIDTH_95PEAK",
"resourceID": "c25219574ba947a89208be8e6c5179be",
"masterOrderID": "82113e40a7ce4dc982a6abb577cd369b",
"updateTime": 1753696016000,
"expireTime": 4909369612000,
"masterResourceID": "c25219574ba947a89208be8e6c5179be",
"itemValue": 1,
"startTime": 1753696012000,
"createTime": 1753696008000
}
]
},
"message": "success",
"description": "成功",
"statusCode": 800
}
状态码
| 状态码 | 含义 |
|---|---|
| 200 | 请求成功 |
错误码
| errorCode | 含义 |
|---|---|
| Openapi.PatternCheck.NotValid | 请求参数无效 |
| Openapi.RouteMAPEc.AccessFailed | 内部错误，请重试。如果多次尝试失败，请提交工单 |
