hello,
Home Page
Overview
Error Handling
Error Handling
Methods
- Account/
- Account/Auth/
- Account/Auth/TwoFactor/
- Account/BillingAddress/
- Account/ChangeOrder/Source/
- Account/ChatPassword/
- Account/Contact/
- Account/CreditCard/
- Account/Cycle/
- Account/Limits/
- Account/PasswordReset/
- Account/Paymethod/
- Account/SSH/Key/
- Account/Settings/
- Account/Subscriptions/
- Account/User/
- Account/User/StateData/
- Acronis/Backup/
- Asset/
- Asset/Connections/
- Asset/ControlPanel/Credentials/
- Asset/Measurements/
- Asset/Monitoring/
- Attribution/
- Basket/
- Basket/Domain/
- Basket/Item/
- Basket/Item/Config/
- Billing/
- Billing/Bill/
- Billing/Credit/
- Billing/CreditCard/Profile/
- Billing/Cycle/
- Billing/Invoice/
- Billing/Invoice/Preview/
- Billing/PayPal/Agreement/
- Billing/PayPal/Payment/
- Billing/Payment/
- Billing/Payment/Profile/
- BusinessEmail/Customer/
- BusinessEmail/Domain/
- Cloud/Backup/
- Cloud/Config/
- Cloud/IP/Pool/
- Cloud/Image/
- Cloud/Private/Parent/
- Cloud/Server/
- Cloud/Template/
- CloudSites/
- CloudSites/Usage/
- CodeGuard/User/
- Contact/
- Coupon/
- Coupon/Claim/
- Domain/
- Domain/Services/
- HostedEmail/Customer/
- HostedEmail/Domain/
- Licensing/
- Licensing/Cpanel/
- Licensing/Plesk/
- Market/Bundle/
- Market/Bundle/Package/
- Market/Cart/
- Market/Cart/Admin/Quote/
- Market/Cart/Discount/
- Market/Cart/Helpers/Configurator/
- Market/Cart/Item/
- Market/Package/
- Market/Package/Product/
- Market/Place/
- Meta/Timing/
- Migration/
- Migration/Account/
- Migration/Account/Server/
- Migration/Account/Server/Access/
- Migration/Destination/
- Monitoring/Bandwidth/
- Monitoring/Load/
- Monitoring/MWP/
- Monitoring/Services/
- Network/CDN/User/
- Network/CDN/Zone/
- Network/DNS/Domain/
- Network/DNS/Domain/Contact/
- Network/DNS/Domain/Nameserver/
- Network/DNS/Domain/Transfer/
- Network/DNS/Record/
- Network/DNS/Reverse/
- Network/DNS/Zone/
- Network/DNS/Zone/History/
- Network/Firewall/
- Network/Firewall/Ruleset/
- Network/IP/
- Network/LoadBalancer/
- Network/Pool/
- Network/Private/
- Network/Region/
- Network/SSHKey/
- Network/Util/
- Network/Zone/
- Notifications/
- OneTimeSecret/
- Order/AddOn/
- Product/
- Product/Addon/
- Product/Marketplace/
- Product/Series/
- Project/
- SSL/Certificate/
- Salesforce/Account/InterWorx/
- Salesforce/Chat/Auth/
- Salesforce/User/
- Server/
- Server/Auth/
- Server/Power/
- Server/VirtualDomain/
- Server/WHM/AccessHash/
- Server/WHM/DNS/
- Server/WHM/Firewall/
- Signup/Basic/
- Storage/Block/Cluster/
- Storage/Block/Volume/
- Storage/ObjectStore/
- Support/Alert/
- Support/Request/
- Support/Request/Attachment/
- Support/SystemStatus/
- Support/Ticket/Auth/
- Tags/Product/
- UserTask/
- Utilities/Info/
- VIP/
- VMware/vCloud/vDC/
- VPN/
- VPN/User/
- WWW/Cart/
- WordPress/Domain/
API Documentation (API Version bleed)
Network/IP/
DESCRIPTION
This section provides methods for listing and manipulating the IPs assigned to a server.
add
URL:
https://api.liquidweb.com/bleed/Network/IP/add
Description:
Add a number of IPs to an existing server. If the 'configure_ips' flag is passed in, the new IP address(es) will be configured within the servers operating system.
Each account has a per-server IP limit defined. By default, that limit is 8 IPv4 addresses and 1 IPv6 /64 per server. Any requests above that limit will fail. A customer can call in to have that limit adjusted if they have a valid use for them.
Bleed version supports Openstack servers of which are limited to a total of 5 IP addresses and can only add 1 IP address at a time. pool_ips, reboot, configure_ips, ip6_count, and pool6_ips args are not used. If passed in, they will be ignored.
Parameters:
| Parameter | Type | Notes |
|---|---|---|
| configure_ips | A boolean value (0 or 1). | |
| ip6_count | A non-negative integer value (i.e. 0 and up). | * Required if:
|
| ip_count | A non-negative integer value (i.e. 0 and up). | * Required if:
|
| pool6_ips | An array of an IPv6 address w/mask (e.g. 2001:DB8:0BFF:202:B3FF:FE1E:8329:0BFF/64) | * Required if:
|
| pool_ips | An array of an IPv4 IP address, in quad-dotted decimal notation (i.e. 127.0.0.1) | * Required if:
|
| reboot | A boolean value (0 or 1). | |
| uniq_id | A six-character identifier, containing only capital letters and digits. | * Required |
Returns:
| Field | Type |
|---|---|
| adding | A string consisting of only letters, digits, hyphens, spaces, and underscores. |
Possible Errors:
Refer to the Error Handling documentation for the list of exception types
details
URL:
https://api.liquidweb.com/bleed/Network/IP/details
Description:
Gets information about a particular IP.
Parameters:
| Parameter | Type | Notes |
|---|---|---|
| ip | A valid IP address (v4 or v6) | * Required |
| uniq_id | A six-character identifier, containing only capital letters and digits. | * Required |
Returns:
| Field | Type | Notes |
|---|---|---|
| broadcast | An IPv4 IP address, in quad-dotted decimal notation (i.e. 127.0.0.1) | * Optional |
| gateway | A valid IP address (v4 or v6) | |
| id | A positive integer value (i.e. 1 and up). | |
| ip | A valid IP address (v4 or v6) | * Optional |
| netmask | A valid IP address (v4 or v6) | |
| network | A valid IP address (v4 or v6) with a mask |
Possible Errors:
Refer to the Error Handling documentation for the list of exception types
list
URL:
https://api.liquidweb.com/bleed/Network/IP/list
Description:
Gets a paginated list of all IP assignments for a particular server. More details about the returned data can be found under network/ip/details
Parameters:
| Parameter | Type | Notes |
|---|---|---|
| alsowith | A single word, consisting of only letters, digits, and underscores. | |
| expand_ips | A boolean value (0 or 1). | |
| page_num | A positive integer value (i.e. 1 and up). | * Optional
|
| page_size | A positive integer value (i.e. 1 and up). | * Optional
|
| uniq_id | A six-character identifier, containing only capital letters and digits. | * Required |
Returns:
| Field | Type | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| item_count | A non-negative integer value (i.e. 0 and up). | ||||||||||||||||||||||
| item_total | A non-negative integer value (i.e. 0 and up). | ||||||||||||||||||||||
| items | An array of associative arrays containing | ||||||||||||||||||||||
| |||||||||||||||||||||||
| page_num | A positive integer value (i.e. 1 and up). | ||||||||||||||||||||||
| page_size | A positive integer value (i.e. 1 and up). | ||||||||||||||||||||||
| page_total | A positive integer value (i.e. 1 and up). | ||||||||||||||||||||||
Possible Errors:
Refer to the Error Handling documentation for the list of exception types
listAccntPublic
URL:
https://api.liquidweb.com/bleed/Network/IP/listAccntPublic
Description:
Gets a list of public network assignments for all provisioned subaccounts for a particular account, optionally for a specific zone only. With the include_pools flag, also includes IPs assigned to IP pools.
Parameters:
| Parameter | Type | Notes |
|---|---|---|
| include_pools | A boolean value (0 or 1). | |
| page_num | A positive integer value (i.e. 1 and up). | * Optional
|
| page_size | A positive integer value (i.e. 1 and up). | * Optional
|
| zone_id | A positive integer value (i.e. 1 and up). |
Returns:
| Field | Type | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| item_count | A non-negative integer value (i.e. 0 and up). | |||||||||
| item_total | A non-negative integer value (i.e. 0 and up). | |||||||||
| items | An array of associative arrays containing | |||||||||
| ||||||||||
| page_num | A positive integer value (i.e. 1 and up). | |||||||||
| page_size | A positive integer value (i.e. 1 and up). | |||||||||
| page_total | A positive integer value (i.e. 1 and up). | |||||||||
Possible Errors:
Refer to the Error Handling documentation for the list of exception types
listPublic
URL:
https://api.liquidweb.com/bleed/Network/IP/listPublic
Description:
Gets a paginated list of all public IPs for a particular server. More details about the returned data can be found under network/ip/details
Parameters:
| Parameter | Type | Notes |
|---|---|---|
| alsowith | A single word, consisting of only letters, digits, and underscores. | |
| expand_ips | A boolean value (0 or 1). | |
| page_num | A positive integer value (i.e. 1 and up). | * Optional
|
| page_size | A positive integer value (i.e. 1 and up). | * Optional
|
| uniq_id | A six-character identifier, containing only capital letters and digits. | * Required |
Returns:
| Field | Type | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| item_count | A non-negative integer value (i.e. 0 and up). | ||||||||||||||||||||||
| item_total | A non-negative integer value (i.e. 0 and up). | ||||||||||||||||||||||
| items | An array of associative arrays containing | ||||||||||||||||||||||
| |||||||||||||||||||||||
| page_num | A positive integer value (i.e. 1 and up). | ||||||||||||||||||||||
| page_size | A positive integer value (i.e. 1 and up). | ||||||||||||||||||||||
| page_total | A positive integer value (i.e. 1 and up). | ||||||||||||||||||||||
Possible Errors:
Refer to the Error Handling documentation for the list of exception types
remove
URL:
https://api.liquidweb.com/bleed/Network/IP/remove
Description:
Remove a specific IP from a server. If the 'configure_ips' flag is passed in, the IP address will be de-configured within the servers operating system.
Note: At this time, it is impossible to remove the server's primary IP using the API
Parameters:
| Parameter | Type | Notes |
|---|---|---|
| configure_ips | A boolean value (0 or 1). | |
| ip | Either: an IPv4 IP address, in quad-dotted decimal notation (i.e. 127.0.0.1); or an IPv6 address w/mask (e.g. 2001:DB8:0BFF:202:B3FF:FE1E:8329:0BFF/64) | * Required |
| reboot | A boolean value (0 or 1). | |
| uniq_id | A six-character identifier, containing only capital letters and digits. | * Required |
Returns:
| Field | Type |
|---|---|
| removing | Either: an IPv4 IP address, in quad-dotted decimal notation (i.e. 127.0.0.1); or an IPv6 address w/mask (e.g. 2001:DB8:0BFF:202:B3FF:FE1E:8329:0BFF/64) |
Possible Errors:
Refer to the Error Handling documentation for the list of exception types
request
URL:
https://api.liquidweb.com/bleed/Network/IP/request
Description:
Request additional IPs for a server. Many server types (traditional dedicated for example) require manual intervention to add IPs. This method creates a ticket, requesting that the given number of IPs be added.
Parameters:
| Parameter | Type | Notes |
|---|---|---|
| ip_count | A positive integer value (i.e. 1 and up). | * Required |
| uniq_id | A six-character identifier, containing only capital letters and digits. | * Required |
| usage_justification | A string permitting tabs, carriage returns and newlines |
Returns:
| Field | Type |
|---|---|
| adding | A string consisting of only letters, digits, hyphens, spaces, and underscores. |
Possible Errors:
Refer to the Error Handling documentation for the list of exception types
