Reserved IPs
A Reserved IP is a public IPv4 address that belongs to your workspace instead of to one VM. It stays yours until you release it, even when no VM uses it, so you can move it from one VM to another without changing your DNS records. A Reserved IP can also be the public address of a VPC’s NAT gateway (which lets private VMs share one address for outgoing traffic) or of a Virtual IP.
When to use a Reserved IP
How it works
- You reserve an address in a location. IBEE picks a free IPv4 address from that location’s pool; you can’t choose the number. Or you convert a VM’s current public address so you keep that exact number.
- You attach it to one VM in the same location. Traffic to the address reaches that VM.
- You move or detach it when needed. The address stays reserved.
- You release it when you no longer need it. It goes back to IBEE’s pool and may be given to another customer.
Before you begin
- A verified organization. See Verify your identity.
- The location where the VMs that will use the address run. A Reserved IP can only be attached in its own location.
- Room in your plan. Your plan sets how many Reserved IPs you can have. See Limits and quotas.
- For the API: an API token with Networking permission (
network.read,network.write) and your workspace ID.
Reserve an address
Open Reserved IPs
In the sidebar, under Network & Security, click Reserved IPs. Then click Reserve IP. The Reserve a public IP dialog opens.
Choose how to reserve
- Add New IP: choose a Location. IP version is IPv4 (“IPv6 coming later”).
- Convert Existing IP: choose a VM’s current address under Existing VM address to keep that exact address. Only VMs without a VPC are listed; for a VM in a VPC, use the IPv4 & Reserved IP panel in the VM’s settings instead. See Networking for VMs.
Attach, move and detach
The Reserved IPs list shows each address, its label, its location, what it is Attached To, and its Status: Attached or Reserved (not in use). Use the row’s buttons, or open the address for its detail page.
- Attach to VM: click the attach button, choose a VM under Destination VM and VPC, then click Attach IP. You can choose a VM in the same location that has its own public network (listed as VM public network (direct)) or a VPC attachment.
- Move to Another VM: on an attached address, click the move button, choose the new VM, then click Move IP. The move happens in one step, without the gap a separate detach and attach would cause. The old VM loses the address at once.
- Detach: click the detach button and confirm Detach IP in the Detach Reserved IP dialog: “The address remains reserved and can be attached again later.” Traffic to the address stops reaching the VM.
After you attach or detach an address on a VM’s own public network, the VM’s operating system may still have the old setting. If the address doesn’t work, restart networking or the VM.
To put a Reserved IP on a NAT gateway or a Virtual IP, start from the VPC’s page. See Use a Reserved IP on the NAT gateway and Expose a Virtual IP publicly.
Rules for moving an address
Verify
-
The address’s Status is Attached and Attached To shows the VM.
-
From your computer, connect to the address on a port the VM’s firewall group accepts:
An open port connects at once;
-w 5makesncgive up after 5 seconds if nothing answers. -
If the address is in DNS,
dig +short www.example.comshould print it.
Edit the label and reverse DNS
On the address’s detail page, click Actions → Edit Metadata. You can change the Name (the label) and Reverse DNS metadata, a full hostname such as host.example.com. Click Save Changes. The address itself doesn’t change.
Reverse DNS is stored as information only. Saving it doesn’t create a PTR record, the DNS record that maps an address back to a name. Mail servers that check reverse DNS won’t see it.
Release an address
Releasing is permanent. The address returns to IBEE’s pool, “may be assigned to another customer”, and you may never get the same number back. Update or delete DNS records that point to it first.
- Update or remove DNS records that point to the address. Other computers may keep the old answer for as long as the record’s TTL (time to live) at your DNS provider, for example 3,600 seconds (1 hour), so do this first.
- Detach the address. An attached address can’t be released (“Detach before releasing”).
- If a NAT gateway uses it, change the gateway’s address or delete the gateway first.
- Click the release button on the list (or Actions → Release IP on the detail page), then Release IP in the Release Reserved IP dialog. You see “Reserved IP released”.
Use the API
Reserve an address. Copy site_id from GET /networking/sites (an entry where available is true); it’s an ID, not a location name.
The answer includes public_ip_id (for example eip-6f1c…), address and status reserved. Attach it to a VM inside a VPC (send the VM’s vpc_id and subnet_id):
Attaching a Reserved IP to a Virtual IP has no API operation yet; use the portal.
