本接口用于创建 IP 地址段。
下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数,请参见公共参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | CreateIpCidrBlocks | 接口名称。当前 API 的名称为 CreateIpCidrBlocks。 |
Version | String | 是 | 2021-04-30 | 接口版本。当前 API 的版本为 2021-04-30。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
cidr_blocks_by_mask | String[] | 否 | [24,26] | 掩码。系统将按照您指定的掩码在 IP 地址池中创建 IP 地址段。
|
cidr_blocks | String[] | 否 | ["12.**.**.0/24","17.**.**.0/26"] | 网段。系统将按照您指定的网段在 IP 地址池中创建 IP 地址段。 cidr_blocks_by_mask 与 cidr_blocks 不能同时指定。 |
cidr_block_name | String | 否 | cidr_01 | IP 地址段的名称。命名规则如下:
|
ip_pool_id | String | 是 | ippool-phh9wg28qk8**** | IP 地址池的 ID。您可以调用 ListIpPools 接口获取 IP 地址池的 ID。 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结果。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
ip_cidr_block_ids | String[] | ipcidr-s2nkfjc9rhg**** | IP 地址段的 ID。 |
POST https://veenedge.volcengineapi.com/?Action=CreateIpCidrBlocks&Version=2021-04-30 &<其他公共参数> { "cidr_blocks": [ "12.**.**.0/24" ], "cidr_block_name": "cidr_01", "ip_pool_id": "ippool-phh9wg28qk8****" }
{ "ResponseMetadata": { "RequestId": "2025072416200809109823314372****", "Action": "CreateIpCidrBlocks", "Version": "2021-04-30", "Service": "veenedge", "Region": "cn-beijing" }, "Result": { "ip_cidr_block_ids": [ "ipcidr-s2nkfjc9rhg****" ] } }
如果响应正文中包含 Error 字段,则表示 API 请求失败。关于错误码的更多信息,参见错误码。