预付费对等连接退订
更新时间：2025-08-22
描述
为非跨境的预付费对等连接进行退订操作。
- 非跨境的预付费对等连接释放并退款。
- 跨账号只有发起端才可以进行退订操作；
-
后付费对等连接不支持退订，后付费对等连接可调用释放对等连接接口进行释放。
对等连接退款有惩罚机制，退款金额 = max(0, 总金额 - 已消费金额 * 1.5)
请求结构
Plain Text
1PUT /v{version}/peerconn/{peerConnId}?{action}&clientToken={clientToken} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| peerConnId | String | 是 | URL参数 | 对等连接ID |
| action | String | 是 | Query参数 | 本接口中该参数取值refund |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见ClientToken幂等性 |
返回头域
除公共头域外，无其他特殊头域。
返回参数
无特殊返回参数。
请求示例
Plain Text
1PUT /v1/peerconn/peerconn-9td54fmx143e?refund&clientToken=dc31ef8c-5e41-4e38-9ds0-9de75d0ds5b20 HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/7784e2058c1111e8b62ccf3a4a052967/2025-08-06T11:51:01Z/3600/host;x-bce-account;x-bce-client-ip;x-bce-date;x-bce-request-id;x-bce-security-token/13b9b4830ef19459427e78e61ab811a765ab68416b3ba097e18164b534906ceb返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 3ef091f6-37a4-450c-b8a9-ce64a2e80b27
3Date: Fri, 06 Aug 2025 11:51:01 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS