You need to enable JavaScript to run this app.
文档中心
公网IP

公网IP

复制全文
下载 pdf
IP地址池
AddIpAddressPoolCidrBlock - 添加IP地址段
复制全文
下载 pdf
AddIpAddressPoolCidrBlock - 添加IP地址段
调用 AddIpAddressPoolCidrBlock 接口,向指定IP地址池中添加IP地址网段。​
使用说明​
  • 不支持添加已占用的IP地址网段。​
  • 已欠费关停的IP地址池,无法添加IP地址段。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action String 必选 示例值:AddIpAddressPoolCidrBlock​
要执行的操作,取值:AddIpAddressPoolCidrBlock。​
​
Version String 必选 示例值:2020-04-01​
API的版本信息,当前版本为 2020-04-01。​
​
CidrBlock String 可选 示例值:101.0.XX.XX/24​
IP 地址网段。仅支持IPv4地址段,且不能以0开头,掩码取值范围:23~30。​
说明​
仅支持配置 CidrBlock 与 CidrMask其中之一。​
​
CidrMask Integer 可选 示例值:24​
IP 地址网段掩码,取值范围:24~28。输入掩码后,IP 地址网段将自动分配。​
说明​
仅支持配置 CidrBlock 与 CidrMask其中之一。​
​
IpAddressPoolId String 必选 示例值:ippool-fda83op****​
IP 地址池的 ID。​
您可以调用 DescribeIpAddressPools 接口,查询IP地址池的ID。​
​
ClientToken String 可选 示例值:123e4567-e89b-12d3-a456-42665544****​
保证请求幂等性。由客户端自动生成一个参数值,确保不同请求间该参数值唯一,避免当调用API超时或服务器内部错误时,客户端多次重试导致重复性操作。取值:​
  • 仅支持ASCII字符,且不能超过64个字符。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
RequestId String 示例值:2021062415303314515207C4****​
请求ID。​
​
CidrBlock String 示例值:101.0.XX.XX/24​
IP 地址网段。​
​
​
​
请求示例​
​
GET /?Action=AddIpAddressPoolCidrBlock&Version=2020-04-01&CidrBlock=101.0.XX.XX/24&IpAddressPoolId=ippool-fda83op**** HTTP/1.1​
Host: vpc.cn-beijing.volcengineapi.com​
Service: vpc​
Region: cn-beijing​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20210624153033015207C4****",​
"Action": "AddIpAddressPoolCidrBlock",​
"Version": "2020-04-01",​
"Service": "vpc",​
"Region": "cn-beijing"​
},​
"Result": {​
"RequestId": "20210624153033015207C4****",​
"CidrBlock": "101.0.XX.XX/24"​
}​
}​
​
错误码​
公共错误码请参见公共错误码。​
​
状态码​
错误码​
错误信息​
说明​
400​
DryRunOperation​
Exception raised to indicate a successfully authorized action when the DryRun flag is set to true.​
该请求设置为DryRun操作,操作授权已获得许可,但未被实际执行。​
400​
IdempotentParameterMismatch​
Arguments on this idempotent request are inconsistent with arguments used in previous request(s).​
此幂等请求的参数与前一个请求中使用的参数不一致。​
400​
InvalidCidr.Malformed​
The specified cidr block is malformed.​
指定的网段格式不合法。​
400​
InvalidIPPool.CidrBlockResourceNotEnough​
There is not enough CIDR block resource to create an IP address pool.​
可用网段资源不足无法创建IP地址池。​
400​
InvalidIPPool.InvalidStatus​
The specified IP address pool is not in the correct status for the request.​
指定IP地址池所处的状态无法响应该请求。​
400​
InvalidIPPoolCidrBlock.Malformed​
The specified CIDR block is malformed. The mask length must be greater than or equal to 23 and less than or equal to 30.​
指定的网段不合法,网段掩码必须大于等于23且小于等于30。​
400​
InvalidIPPoolCidrBlock.NotSupportIPv6​
The IP address pool does not support IPv6 CIDR block.​
IP地址池不支持指定IPv6网段。​
400​
InvalidIPPoolCidrMask.Malformed​
The specified CIDR mask is malformed. The mask length must be greater than or equal to 24 and less than or equal to 28.​
指定的掩码不合法,掩码必须大于等于24且小于等于28。​
400​
InvalidParameter.ClientTokenMalformed​
The specified parameter ClientToken is malformed.​
指定的参数ClientToken格式不合法,长度不能超过64个ASCII字符。​
400​
QuotaExceeded.IPPoolIP​
You've reached the limit on the number of IPs of all IP address pools that you can possess.​
已达到所有IP地址池持有IP地址数量上限。​
404​
InvalidIPPool.NotFound​
The specified IP address pool does not exist.​
指定的IP地址池不存在。​
412​
IdempotentProcessing​
The request uses the same client token as a previous one that is still in process.​
幂等请求处理中。​
​
​
最近更新时间:2026.10.09 11:39:28
这个页面对您有帮助吗?
有用
有用
无用
无用