调用 AddIpAddressPoolCidrBlock 接口,向指定IP地址池中添加IP地址网段。
参数名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
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。 说明 仅支持配置 |
CidrMask | Integer | 否 | 24 | IP 地址网段掩码,取值范围:24~28。输入掩码后,IP 地址网段将自动分配。 说明 仅支持配置 |
IpAddressPoolId | String | 是 | ippool-fda83op**** | IP 地址池的 ID。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** | 保证请求幂等性。由客户端自动生成一个参数值,确保不同请求间该参数值唯一,避免当调用API超时或服务器内部错误时,客户端多次重试导致重复性操作。取值:
|
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 2021062415303314515207C4**** | 请求ID。 |
CidrBlock | String | 101.0.XX.XX/24 | IP 地址网段。 |
CidrMask | Integer | 24 | IP 地址网段掩码。 |
GET /?Action=AddIpAddressPoolCidrBlock&Version=2020-04-01&CidrBlock=101.0.XX.XX/24&IpAddressPoolId=ippool-fda83op**** HTTP/1.1 Host: open.volcengineapi.com Service: vpc Region: cn-beijing
{ "ResponseMetadata": { "RequestId": "20210624153033015207C4****", "Action": "CreateIpAddressPool", "Version": "2020-04-01", "Service": "vpc", "Region": "cn-beijing" }, "Result":{ "RequestId": "2021062415303314515207C4****", "IpAddressPoolId": "ippool-fda83op****" } }
公共错误码,请参见 公共错误码 。
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | IdempotentParameterMismatch | Arguments on this idempotent request are inconsistent with arguments used in previous request(s). | 此幂等请求的参数与前一个请求中使用的参数不一致。 |
InvalidCidr.Malformed | The specified cidr block is malformed. | 指定的网段格式不合法。 | |
InvalidIPPool.CidrBlockResourceNotEnoug | There is not enough CIDR block resource to create an IP address pool. | 可用网段资源不足无法创建IP地址池。 | |
InvalidIPPool.InvalidStatus | The specified IP address pool is not in the correct status for the request. | 指定IP地址池所处的状态无法响应该请求。 | |
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。 | |
InvalidIPPoolCidrBlock.NotSupportIPv6 | The IP address pool does not support IPv6 CIDR block. | IP地址池不支持指定IPv6网段。 | |
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。 | |
InvalidParameter | A parameter specified in the request is not valid, is unsupported or cannot be used. | 该请求传入了非法或不支持的参数。 | |
InvalidParameter.ClientTokenMalformed | The specified parameter ClientToken is malformed. | 指定的参数ClientToken格式不合法,长度不能超过64个ASCII字符。 | |
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. | 幂等请求处理中。 |