Updated May 10, 2026 Manages a Raff VPC — a private network that VMs in the same project and region can attach to and reach each other on internal IPs. CIDR is immutable once created; rename and description update in place.Documentation Index
Fetch the complete documentation index at: https://docs.rafftechnologies.com/llms.txt
Use this file to discover all available pages before exploring further.
Example — minimal
Example — with description
Argument reference
Required
| Argument | Type | Description |
|---|---|---|
name | string | VPC name. Updates rename in place |
cidr | string | CIDR block. RFC 1918 (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) or RFC 6598 (100.64.0.0/10). Allowed prefix lengths: /16 to /28. ForceNew |
Optional
| Argument | Type | Description |
|---|---|---|
region | string | Region. Defaults to us-east. ForceNew |
description | string | Free-form description |
Attribute reference (computed)
| Attribute | Description |
|---|---|
id | VPC UUID |
account_id / project_id | Owning account / project UUIDs |
gateway | Gateway IP for the VPC |
gateway_type | Gateway type |
dns | DNS server IP |
router_public_ip | Public IP of the VPC router (for outbound traffic) |
router_status | Router lifecycle status |
status | VPC lifecycle status |
total_ips | Total addressable IPs in the CIDR |
used_ips | IPs currently in use |
created_at / updated_at | RFC3339 timestamps |
Lifecycle
| Operation | Behavior |
|---|---|
terraform apply (create) | Creates the VPC and its router |
Change name, description | In-place update |
Change cidr, region | Replacement — destroy + recreate |
terraform destroy | Deletes the VPC. Fails if VMs are still attached — detach them first |
Importing existing VPCs
Permissions
The API key needsvpc.create, vpc.manage, and vpc.delete in the project. The system role Project Admin grants all of these.
Data sources
Related
raff_vm
Attach VMs via vpc_id.
raff_security_group
Firewall rules for VPC traffic.
CLI: raff vpc
Imperative equivalent.