Creates an IP address pool.
Limits
Only users who have the required permissions can use the IP address pool feature of Elastic IP Address (EIP). To apply for the required permissions, submit a ticket.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | CreatePublicIpAddressPool |
The operation that you want to perform. Set the value to CreatePublicIpAddressPool. |
Isp | String | No | BGP |
The line type. Valid values:
For more information about BGP (Multi-ISP) and BGP (Multi-ISP) Pro, see EIP line types. If you are allowed to use single-ISP bandwidth, you can also choose one of the following values:
|
Name | String | No | AddressPoolName |
The name of the IP address pool. This parameter is optional. If you enter a name, the name must be 1 to 128 characters
in length and can contain digits, periods (.), underscores (_), and hyphens (-). The
name must start with a letter but cannot start with |
Description | String | No | AddressPoolDescription |
The description of the IP address pool. This parameter is optional. If you enter a description, the description must be 2 to 256 characters in length, and cannot start with http:// or https://. |
ClientToken | String | No | 02fb3da4-130e-11**** |
The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must ensure that it is unique among different requests. ClientToken can contain only ASCII characters. |
DryRun | Boolean | No | false |
Specifies whether to check the request without performing the operation. Valid values:
|
RegionId | String | Yes | cn-chengdu |
The ID of the region where you want to create the IP address pool. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
PulbicIpAddressPoolId | String | pippool-6wetvn6fumkgycssx**** |
The ID of the IP address pool. |
RequestId | String | 4EC47282-1B74-4534-BD0E-403F3EE64CAF |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=CreatePublicIpAddressPool
&Isp=BGP
&Name=AddressPoolName
&Description=AddressPoolDescription
&ClientToken=02fb3da4-130e-11****
&DryRun=false
&RegionId=cn-chengdu
&Common request parameters
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<CreatePublicIpAddressPoolResponse>
<PulbicIpAddressPoolId>pippool-6wetvn6fumkgycssx****</PulbicIpAddressPoolId>
<RequestId>4EC47282-1B74-4534-BD0E-403F3EE64CAF</RequestId>
</CreatePublicIpAddressPoolResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"PulbicIpAddressPoolId" : "pippool-6wetvn6fumkgycssx****",
"RequestId" : "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}
Error codes
For a list of error codes, visit the API Error Center.