How to Order Additional IPs – Support Guides

Learn how to order Additional IPs via the OVHcloud Manager and OVHcloud API

When purchasing an OVHcloud service, it generally comes with one IPv4 (Internet Protocol version 4) address. However, additional IPv4 addresses can be purchased (as a single IP or in IP blocks), up to 256 IPs per Dedicated Server or Hosted Private Cloud. These are known as FoIPs (Additional IPs), which means they are not bound to a specific device and cannot be moved.

Additional IP blocks purchased in the Singapore data center are not supported by vRack services.

Requirements

a Dedicated Server, VPS, or Hosted Private Cloud environment
access to the OVHcloud Control Panel
access to the OVHcloud API (to get started, see this guide)

Instructions

Ordering Additional IPs

Click each tab across the top to view all content.

From the OVHcloud Control Panel:

Select the Bare Metal Cloud or Hosted Private Cloud tab at the top of the page.
Click on the Order drop-down button.
Choose the Additional IP.

network_additionalIP_order01**.png

On the next screen, choose IPv4.

If you are interested in IPv6, see this guide.

network_additionalIP_order02*.png

Select the service to which you want the Additional IP to be attached and click Next.

network_additionalIP_order03**.png

Click Additional IP and then Continue my order. You can order more Additional IPs using the + button.

network_additionalIP_order04*.png

▼ Information about IPv4 Additional IP blocks

If you choose to purchase an Additional IP block, your choices are 1 (/32), 4 (/30), 8 (/29), 16 (/28), 32 (/27), 64 (/26), 128 (/25), and 256 (/24).

NOTE: By selecting one (/32) IP address, you have the option to purchase up to 16 individual IP addresses, but in one order. These IP addresses will be handled individually, which means they can be separately assigned to different servers/services.
Additionally, if you purchase a block of 4 IPs (/30) or greater, the IP addresses can still be moved but as an entire block ONLY. Also, you can set the WHOIS information by using the "Click here to access the organization management" link.

WARNING: If you elect to create an organization and assign it to a block of IP addresses, that information will be publicly accessible via a WHOIS search and CANNOT be changed. If you are unsure how to proceed, we recommend selecting "ARIN_104".

You will be taken to a new page to review your order and pay for the Additional IP(s). After completing the order the Additional IP address(es) can be viewed in the OVHcloud Control Panel by clicking Network and then IP.

network_additionalIP_order06*.png

Create cart

From the OVHcloud API, begin by creating a cart:

POST /order/cart

Parameters:

description: choose a description for your cart

ovhSubsidiary: US

Depending on the version of our API console you are using, you will either leave the expiration field blank or delete the expiration line from the request body.

Save the cartID from the results.

Add an Additional IP

Get plan codes:

GET /order/cart/{cartId}/ip

Locate the service you wish to order. In this example, we are using ordering ip-failover-arin.

Save the planCode from the results.

Add the Additional IP to your cart:

POST /order/cart/{cartId}/ip

Configure your Additional IP

You will need to run the following API call four separate times:

POST /order/cart/{cartId}/item/{itemId}/configuration

Edit the request body each time to add these Label/Value combinations:

Label	Value
country	US
destination	the name of the service to which you want to attach your Additional IP
nic	the primary email address on your account
region	us

Check the configuration (optional)

Get the code for each Label/Value combination.

GET /order/cart/{cartId}/item/{itemId}/configuration

See the details of a Label/Value combination.

GET /order/cart/{cartId}/item/{itemId}/configuration/{configurationId}

Assign cart to yourself

POST /order/cart/{cartId}/assign

Checkout

POST /order/cart/{cartId}/checkout

Save the orderId from the results.

Payment method

GET /me/order/{orderId}/availablePaymentMethod

Save the id of the payment method you wish to use.

Complete your order

POST /me/order/{orderId}/pay

Go further

If you want to use the Additional IP address to connect a VM to the Internet, please check out our How to Connect a VM to the Internet Using VMware ESXi article.

For more information and tutorials, please see our other Network support guides or explore the guides for other OVHcloud products and services.