VPC | ibee | Documentation

A VPC (Virtual Private Cloud) is an isolated Layer 3 network for resources in one workspace. Resources in the same VPC communicate over private IPs without traversing the public internet.

Create a VPC

Open VPCs

In the portal sidebar, click VPC under Network, then click Create VPC.

Name the VPC

Enter a VPC Name (e.g. my-vpc) and an optional Description.

Choose a site and IP range

Choose a site where VPC networking is available.

Automatic (recommended) assigns a non-overlapping RFC1918 range.
Custom accepts an RFC1918 IPv4 CIDR with a prefix between /22 and /28.

Custom ranges cannot overlap another VPC in the same IBEE account.

Create

Click Create VPC. By default, IBEE also creates the first subnet. The VPC becomes usable when its status is available.

Connectivity modes

Mode	Use it for
`public`	Private networking with optional dedicated public IPs on individual VMs
`nat_gateway`	Private VMs that share managed outbound internet access

For inbound access to a VM behind a NAT gateway, add a port-forwarding rule that maps a port on the gateway to a private VM address.

Attach a VM

Each attachment selects a subnet and connectivity type:

private assigns only a private address.
public_ip assigns or uses a Reserved IP.
nat sends outbound traffic through the VPC NAT gateway.

Use the API

$ curl -X POST \
>   "https://api.ibee.ai/v1/networking/vpcs?workspace_id=607005" \
>   -H "Authorization: Bearer $IBEE_TOKEN" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "name": "production",
>     "site_id": "in-south-1",
>     "auto_cidr": true,
>     "create_default_subnet": true,
>     "connectivity_type": "nat_gateway"
>   }'

Use GET /networking/sites before creation to discover sites where the VPC control plane is available.

Delete a VPC

A VPC must be empty before deletion. Detach its VMs, remove NAT gateways, and remove dependent subnets first. The API returns 409 Conflict while dependencies remain.