1. 接口描述
此接口处于预下线状态 。
预计下线时间：2025-03-27 16:21:55
接口请求域名： mna.tencentcloudapi.com 。
产品下线
移动网络发起Qos加速过程
默认接口请求频率限制：1000次/秒。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：CreateQos。 |
| Version | 是 | String | 公共参数，本接口取值：2021-01-19。 |
| Region | 否 | String | 公共参数，本接口不需要传递此参数。 |
| SrcAddressInfo | 是 | SrcAddressInfo | 加速业务源地址信息，SrcIpv6和（SrcIpv4+SrcPublicIpv4）二选一，目前Ipv6不可用，全部填写以Ipv4参数为准。 示例值：{"SrcIpv4": "192.168.2.11", "SrcPublicIpv4": "10.22.33.14"} |
| DestAddressInfo | 是 | DestAddressInfo | 加速业务目标地址信息 示例值：{"DestIpv4": "128.22.36.40"} |
| QosMenu | 是 | String | 加速套餐 T100K：时延性保障 + 带宽保障上下行保障 100kbps T200K：时延性保障 + 带宽保障上下行保障 200kbps T400K：时延性保障 + 带宽保障上下行保障 400kbps BD1M：带宽型保障 + 下行带宽保障1Mbps BD2M：带宽型保障 + 下行带宽保障2Mbps BD4M：带宽型保障 + 下行带宽保障4Mbps BU1M：带宽型保障 + 上行带宽保障1Mbps BU2M：带宽型保障 + 上行带宽保障2Mbps BU4M：带宽型保障 + 上行带宽保障4Mbps 示例值：T100K |
| DeviceInfo | 否 | DeviceInfo | 申请加速的设备信息，包括运营商，操作系统，设备唯一标识等。 示例值：{"OS": 1, "Vendor": 2, "IMEI": "357315094232545"} |
| Duration | 否 | Integer | 期望加速时长（单位分钟），默认值30分钟 示例值：30 |
| Capacity | 否 | Capacity | 接口能力扩展，如果是电信用户，必须填充CTCC Token字段 示例值：{ "CTCCToken" : "177cc9c4ab0-7b93546", "Province": "Guangdong" } |
| TemplateId | 否 | String | 应用模板ID 示例值：app-1abcedf |
| Protocol | 否 | Integer | 针对特殊协议进行加速 1. IP （默认值） 2. UDP 3. TCP 示例值：1 |
| Context | 否 | Context | 加速策略关键数据 示例值：{"ExpectedHighThreshold":{"Jitter":20.0,"Loss":10.0,"RTT":90.0},"ExpectedLowThreshold":{"Jitter":5.0,"Loss":3.0,"RTT":50.5},"NetworkData":{"Jitter":48.09,"Loss":0.0,"RTT":[206.0,96.8,123.0],"Timestamp":1645586039}} |
| Extern | 否 | String | 签名 示例值：af4764571f217a9bd2c50d8e97c54239bcacb15c835100e59fda84cb33603d14 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| SessionId | String | 单次加速唯一 Id 示例值：ZWViYzAwNzJmNjRkNGExMDgyMjkzZTY0YzU0ZjZhNDY=-1-0 |
| Duration | Integer | 当前加速剩余时长（单位秒） 示例值：1790 |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 移动网络发起加速
输入示例
POST / HTTP/1.1
Host: mna.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateQos
<公共请求参数>
{
"QosMenu": "T100K",
"Duration": 30,
"SrcAddressInfo": {
"SrcIpv4": "10.168.2.11",
"SrcPublicIpv4": "119.29.29.29"
},
"DestAddressInfo": {
"DestIp": [
"114.114.114.114"
]
},
"TemplateId": "app-1abacedf",
"DeviceInfo": {
"OS": 1,
"Vendor": 2,
"DeviceId": "357315094232545",
"Wireless": 1,
"PhoneNum": "12847584945"
},
"Capacity": {
"CTCCToken": "177cc9c4ab0-7b93546",
"Province": "广东省"
},
"Protocol": 1
}输出示例
{
"Response": {
"SessionId": "ZWViYzAwNzJmNjRkNGExMDgyMjkzZTY0YzU0ZjZhNDY=-1-0",
"RequestId": "3c140219-cfe9-470e-b241-907877d6fb03",
"Duration": 1790
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError | 内部错误。 |
| InvalidParameter | 参数错误。 |
| InvalidParameterValue | 参数取值错误。 |
| InvalidParameterValue.VendorNotFound | 无法获取到可加速的运营商信息 |
| MissingParameter | 缺少参数错误。 |
| OperationDenied | 操作被拒绝。 |
| OperationDenied.AccelerationNotSuggest | 不建议加速。 |
| OperationDenied.CTCCTokenExpired | 中国电信加速token过期。 |
| OperationDenied.CreateQosExceedLimit | 相同加速间隔时间过短。 |
| OperationDenied.RequestQosTimeout | 请求运营商加速超时。 |
| OperationDenied.UserOutOfCoverage | 该用户不在运营商网络可加速范围内 |
| OperationDenied.VendorReturnError | 运营商返回结果错误。 |
| OperationDenied.VendorServerError | 运营商服务器临时错误。 |
| RequestLimitExceeded | 请求的次数超过了频率限制。 |
| ResourceUnavailable | 资源不可用。 |
