NAT gateway renewal
Updated at：2025-10-16
Description
Extend the expiration period of the specified NAT by performing the renewal operation.
- Postpaid NAT gateways are not eligible for renewal.
Request structure
Plain Text
1PUT /v{version}/nat/{natId}?{action}&clientToken={clientToken} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4{
5 "billing":{
6 "reservation":{
7 "reservationLength": reservationLength,
8 "reservationTimeUnit": reservationTimeUnit
9 }
10 }
11}Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number, current value is 1. |
| natId | String | Yes | URL parameter | ID of renewed NAT gateway |
| action | String | Yes | Query | Parameter value for this API: purchaseReserved |
| clientToken | String | No | Query | Idempotence Token, which is an ASCII string with a length not exceeding 64 bits, see details in [ClientToken Idempotence](VPC/API Reference/General Description.md). |
| billing | [Billing](VPC/API Reference/Appendix.md#Billing) | Yes | RequestBody | Order information |
Response headers
No additional headers beyond standard ones.
Response parameters
No special response parameters are available.
Request example
Plain Text
1PUT /v1/nat/nat-bir8biqwr45e?purchaseReserved&clientToken=dc31ef8c-5e41-4e38-9ds0-9de7250ds5b20 HTTP/1.1
2host: bcc.bj.baidubce.com
3content-type: application/json
4authorization: bce-auth-v1/4df6da5b832211e8a106475a8496ca04/2018-07-09T02:47:39Z/3600/host;x-bce-account;x-bce-client-ip;x -bce-date;x-bce-request-id;x-bce-security-token/e2cbb3d113486470719a83bcb55571c623cf6e881b879f74a0c162ba31c8a42e
5{
6 "billing":{
7 "reservation":{
8 "reservationLength": 1,
9 "reservationTimeUnit": "month"
10 }
11 }
12}Response example
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 3ef091f6-37a4-450c-b8a9-ce64a2e80b27
3Date: Mon, 09 Jul 2018 02:47:39 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS