Skip to navigation

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

You want…UseWhat happens to the address
A public address for a VM, and you don’t mind if it changesThe address assigned when you deploy the VMIt belongs to the VM. When you delete the VM, it goes back to IBEE unless you keep it as a Reserved IP.
An address that survives replacing or rebuilding the VMReserved IP (this page)It stays in your workspace until you release it
To switch traffic to a standby VM quickly (failover)Reserved IP, moved with Move to Another VMIt moves in one step
One address for several VMs, with health checksA load balancerThe load balancer has its own hostname
A fixed outgoing address for private VMsA Reserved IP on the VPC’s NAT gateway (NAT means network address translation)It is used for all their outgoing traffic

How it works

  1. 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.
  2. You attach it to one VM in the same location. Traffic to the address reaches that VM.
  3. You move or detach it when needed. The address stays reserved.
  4. 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

1

Open Reserved IPs

In the sidebar, under Network & Security, click Reserved IPs. Then click Reserve IP. The Reserve a public IP dialog opens.

2

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.
3

Add a label

Optionally enter a Label (up to 120 characters, for example production-web-ip). The dialog shows the Reserved IP charge for the location.

4

Reserve

Click Reserve IP (or Convert IP). You see “Reserved IP created” (or “Existing public IP converted to a Reserved IP”). A converted address stays on its VM.

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

RuleWhy
Same location onlyEach location has its own address pool
One Reserved IP per VM attachmentA VM that already has a Reserved IP must lose it first
To move onto a VM’s own public network, detach first, then attachMove works between VPC attachments only (“Moving to a VM public network is not supported yet — detach first.”)
An address used by a NAT gateway can’t be moved to a VMChange the gateway’s address first
A converted address on a VM without a VPC can’t be movedDetach it, then attach it to the new VM

Verify

  1. The address’s Status is Attached and Attached To shows the VM.

  2. From your computer, connect to the address on a port the VM’s firewall group accepts:

    nc -vz -w 5 203.0.113.50 22

    An open port connects at once; -w 5 makes nc give up after 5 seconds if nothing answers.

  3. If the address is in DNS, dig +short www.example.com should 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.

  1. 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.
  2. Detach the address. An attached address can’t be released (“Detach before releasing”).
  3. If a NAT gateway uses it, change the gateway’s address or delete the gateway first.
  4. 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.

curl -X POST "https://api.ibee.ai/v1/networking/reserved-ips?workspace_id=710995" \
-H "Authorization: Bearer $IBEE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"site_id": "68b99bd78a8eda32ff3f16ea", "label": "production-web-ip"}'

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):

curl -X POST "https://api.ibee.ai/v1/networking/reserved-ips/RESERVED-IP-ID/attach?workspace_id=710995" \
-H "Authorization: Bearer $IBEE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"vm_id": "VM-ID", "vpc_id": "VPC-ID", "subnet_id": "SUBNET-ID"}'
TaskOperation
Attach to a VM without a VPCPOST /networking/reserved-ips/RESERVED-IP-ID/attach-direct with {"vm_id": "..."}
Move to another VM in one stepPOST .../RESERVED-IP-ID/move with vm_id, vpc_id, subnet_id
Keep a VM’s current address (convert)POST /networking/reserved-ips/convert with vm_id, site_id and an optional label
DetachPOST .../RESERVED-IP-ID/detach
Change the label or reverse DNSPATCH .../RESERVED-IP-ID with label or reverse_dns
List, get or releaseGET /networking/reserved-ips (filter with site_id), GET or DELETE .../RESERVED-IP-ID
Use on a NAT gatewayPUT /networking/vpcs/VPC-ID/nat-gateways/NAT-GATEWAY-ID/public-ip with reserved_public_ip_id

Attaching a Reserved IP to a Virtual IP has no API operation yet; use the portal.

Limits

ItemLimit
Number of Reserved IPsSet by your plan. See Limits and quotas.
IP versionIPv4 only
Attached toOne VM attachment, one NAT gateway or one Virtual IP at a time
Reserved IPs per VM attachment1
LocationAttach only in the location it was reserved in
LabelUp to 120 characters
Reverse DNS metadataA hostname, up to 253 characters
Choosing the numberNot possible: IBEE assigns it, or you convert one you already have
ChargeShown in the Reserve a public IP dialog, and under Pricing on the detail page

Troubleshooting

You seeWhat it meansWhat to do
”No public IPv4 addresses are available in site …”The location’s pool is empty right nowTry again later, or contact support.
”You have reached your plan’s limit for this resource.”Your plan’s Reserved IP limit is used upRelease an address you don’t need, or click Request a limit increase.
”No eligible destination is available in this location.”No VM in the address’s location can take itUse a VM in the same location, or create one there.
”VM and Reserved IP must belong to the same site” (422)The VM is in another locationReserve an address in the VM’s location.
”Target VM already has another Reserved IP” (409)The VM attachment already has a Reserved IPDetach that one first.
”Reserved public IP is already attached; use move” (409)You tried to attach an address that is in useUse Move to Another VM.
”Detach this IP before releasing it.” or “Detach the public IP before releasing it” (409)The address is still attachedDetach it, then release it.
”Release is blocked while the NAT Gateway owns this address. Change or delete the gateway first.”A NAT gateway uses the addressGive the gateway another address, or delete it.
”The public IP is already managed as a Reserved IP” (409)You tried to convert an address that is already reservedNothing to do: it’s already in your list.
The address is attached but nothing answersThe VM’s firewall group blocks the port, or the guest OS still has the old network settingsCheck the firewall group’s rules, then restart networking or the VM.