创建预留网段
更新时间：2023-04-27
描述
该接口用于创建预留网段。
- 如果创建ipv6的预留网段，掩码需大于等于96
请求结构
POST /v{version}/subnet/ipreserve?clientToken={clientToken} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
{
"subnetId":{subnetId},
"ipCidr":{ipCidr},
"ipVersion":{ipVersion},
"description":{description}
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| subnetId | String | 是 | RequestBody参数 | 预留网段所属的子网ID |
| ipCidr | String | 是 | RequestBody参数 | 预留网段的ip或cidr |
| ipVersion | int | 是 | RequestBody参数 | ip版本，支持ipv4和ipv6 |
| description | String | 否 | RequestBody参数 | 预留网段描述 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| ipReserveId | String | 预留网段的ID |
请求示例
POST /v1/subnet/ipreserve?clientToken=46f818c6-d21c-452d-b6d9-215ca6ffc843 HTTP/1.1
Host: bcc.bj.baidubce.com
authorization: bce-auth-v1/69ce105be4b111edada7e5a923788a49/2023-04-27T04:10:15Z/3600/host;x-bce-accesskey;x-bce-account;x-bce-client-ip;x-bce-date;x-bce-gateway-count;x-bce-request-id;x-bce-user-agent/e061f900974bd5129e84f8eaf0b56aaeae8c22644a55588db41580fe154d8fb3
{
"subnetId":"sbn-a4cikyt7756r",
"ipCidr":"192.168.0.100/30",
"ipVersion":4,
"description":"test"
}返回示例
HTTP/1.1 200 OK
x-bce-request-id: 14f62dfa-b47d-4b4e-a2e2-e44759a196f1
Date: Thu, 27 Apr 2023 04:10:15 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
"ipReserveId":"ipr-te2pa9cv4ikk"
}