Create IPv6 gateway
Updated at：2025-10-16
Description
Create an IPv6 gateway.
- The IPv6 gateway must be created within a VPC that has an IPv6 CIDR
- Only One IPv6 gateway can be created within the same VPC
- Currently only postpay is supported for IPv6 gateway
- IPv6 gateway bandwidth range: 1-5,000
Request structure
Plain Text
1POST /v{version}/IPv6Gateway?clientToken={clientToken} HTTP/1.1
2Host: bcc.bd.baidubce.com
3Authorization: authorization string
4{
5 "name": name,
6 "vpcId": vpcId,
7 "bandwidthInMbps":bandwidthInMbps,
8 "billing": {
9 "paymentTiming": paymentTiming
10 },
11 "tags":[
12 {
13 "tagKey": tagKey,
14 "tagValue": tagValue
15 }
16 ],
17 "resourceGroupId": resourceGroupId,
18 "deleteProtect": deleteProtect
19}Request headers
There are no special headers required beyond the common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number |
| clientToken | String | No | Query | Idempotence token, which is an ASCII string with a length not exceeding 64 bits, see details in [ClientToken Idempotence Support](VPC/API Reference/General Description.md#Idempotence) |
| vpcId | String | Yes | Query | VPC ID |
| name | String | Yes | RequestBody | IPv6 gateway name |
| bandwidthInMbps | int | Yes | RequestBody | Upper bandwidth limit of the IPv6 gateway |
| billing | Billing | Yes | RequestBody | Billing information: Currently only postpay is supported |
| tags | List<[TagModel](VPC/API Reference/Appendix.md#TagModel)> | No | RequestBody | List of tag key-value pairs to be created. |
| resourceGroupId | String | No | RequestBody | Resource group |
| deleteProtect | Boolean | No | RequestBody | Option to enable release protection. By default, it is set to false, allowing deletion. |
Response headers
No special headers are required beyond the standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| gatewayId | String | ID of the IPv6 gateway |
Request example
Plain Text
1POST /v1/IPv6Gateway HTTP/1.1
2Host: bcc.bd.baidubce.com
3authorization: bce-auth-v1/c3119080364d11e8912505e5e0ae9978/2018-04-02T08:14:25Z/3600/host;x-bce-account;x-bce-client-ip;x-bce-date;x-bce-request-id;x-bce-security-
4token/6b93bfd5ca2328fcb5560fa57f56253d80a629f6aac9c9cb74adf9a055fceb53
5{
6 "vpcId":"vpc-g7cufa91auif",
7 "name":"IPv6Gateway",
8 "bandwidthInMbps":10,
9 "billing":{
10 "paymentTiming":"Postpaid"
11 },
12 "tags":[
13 {
14 "tagKey": "tagKey",
15 "tagValue": "tagValue"
16 }
17 ],
18 "resourceGroupId": "RESG-UoMgbkuLNjj",
19 "deleteProtect": true
20}Response example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7e789a40-adac-414a-8bd4-916d6be61112
3Date: Mon, 02 Apr 2018 08:14:25 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6{
7 "gatewayId":"gw-5af4eb65"
8}