Load balancer

Endpoint load balancer butuh load_balancer:read (baca) atau load_balancer:write (ubah). Scope ini terpisah dari network:*. Load balancer Levia bekerja di L4 (TCP/UDP): satu IP publik, satu atau lebih listener (port masuk → target_port di setiap backend), dan target berupa VM di VPC yang sama atau alamat privat di subnet VPC itu. Trafik dibagi ke target yang sehat.

Harga

GET /load-balancers/plans menampilkan tarif per load balancer dalam Rupiah. IP publiknya sudah termasuk; listener dan target tidak menambah biaya. Ditagih per jam sejak active sampai dihapus.

Buat load balancer

curl -s -X POST "$LEVIA_API/load-balancers" \
  -H "Authorization: Bearer $LEVIA_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "name": "web-lb",
    "region_id": "'$REGION'",
    "vpc_id": "'$VPC'",
    "listeners": [
      {"protocol": "tcp", "port": 80, "health_check": {"protocol": "http", "path": "/"}}
    ],
    "targets": [{"vm_id": "'$VM1'"}, {"vm_id": "'$VM2'"}]
  }'

Tunggu GET /load-balancers/{id} sampai ready: true (status active, IP publik ada). Biasanya kurang dari satu menit.
Tunggu GET /load-balancers/{id}/targets sampai setiap target health_status: healthy.
Kirim trafik ke public_ip.

Field	Arti
`listeners`	Minimal satu. `protocol`: `tcp` atau `udp`; `port`; `target_port` (bawaan = `port`); `health_check` opsional
`targets`	Opsional, bisa ditambah nanti. Isi `vm_id` atau `ip_address` per target, plus `weight` 1–256
`subnet_id`	Subnet publik VPC. Tanpa ini: subnet target VM pertama, lalu subnet publik di `zone_id`, lalu subnet default VPC. Backend boleh di subnet lain dalam VPC.
`session_affinity`	`none` (bawaan) atau `client_ip`: klien yang sama selalu ke backend yang sama
`source_ranges`	IPv4/CIDR klien yang boleh masuk; kosong = semua
`health_check`	Health check untuk setiap listener yang tidak punya health check sendiri

Health check bawaan: tcp ke target_port (UDP: none), interval 5 detik, timeout 3 detik, sehat setelah 2 kali berhasil, tidak sehat setelah 3 kali gagal. protocol: http memeriksa path.

Security group backend

Backend melihat semua trafik datang dari snat_ip load balancer, bukan alamat klien. Izinkan port backend dari snat_ip atau dari CIDR VPC di security group VM, atau health check dan trafik tidak akan sampai.

Listener

Aksi	Endpoint	Catatan
Daftar	`GET /load-balancers/{id}/listeners`	`health_check.port: 0` = `target_port`
Tambah	`POST /load-balancers/{id}/listeners`	Maks. 64 listener; pasangan protokol + port tidak boleh ganda (`422`)
Ubah	`PATCH /load-balancers/{id}/listeners/{listener_id}`	`port`, `target_port`, `health_check`. Mengganti `port` memberi listener id baru (ada di jawaban). Protokol tidak bisa diubah.
Hapus	`DELETE /load-balancers/{id}/listeners/{listener_id}`	Tanpa listener, load balancer tidak menerima trafik

Target

curl -s -X POST "$LEVIA_API/load-balancers/$LB/targets" \
  -H "Authorization: Bearer $LEVIA_KEY" -H "Content-Type: application/json" \
  -d '{"vm_id": "'$VM3'", "weight": 2}'

Isi tepat satu dari vm_id (VM organisasi di VPC load balancer yang sudah punya alamat privat, bukan jaringan isolated) atau ip_address (alamat host salah satu subnet VPC itu). Maks. 256 target.
GET /load-balancers/{id}/targets: health_status keseluruhan (healthy hanya bila sehat di semua listener; unknown = belum ada laporan, mis. tepat setelah ditambahkan) dan health per listener (mis. tcp/80).
DELETE /load-balancers/{id}/targets/{target_id} mengeluarkan backend (VM-nya tidak disentuh). target_id boleh id target atau vm_id-nya.

Ubah load balancer

PATCH /load-balancers/{id} hanya mengubah field yang dikirim:

curl -s -X PATCH "$LEVIA_API/load-balancers/$LB" \
  -H "Authorization: Bearer $LEVIA_KEY" -H "Content-Type: application/json" \
  -d '{"session_affinity": "client_ip", "source_ranges": ["203.0.113.0/24"]}'

name, session_affinity, tags.
source_ranges menggantikan seluruh daftar ([] = semua klien).
health_check menggantikan health check semua listener. Untuk satu listener, pakai PATCH …/listeners/{listener_id}.

Hapus

DELETE /load-balancers/{id} menghapus load balancer beserta listener dan daftar targetnya (VM tidak disentuh) dan menghentikan tagihan. IP publiknya kembali ke pool. Jawaban 202; status deleting lalu hilang (404).

Load balancer milik Kubernetes

Load balancer yang dibuat cluster Kubernetes tampil di daftar dengan source: kubernetes dan hanya bisa dibaca. Mengubah atau menghapusnya lewat API ditolak 409; ubah lewat Service di cluster.

Belum didukung

Ditolak 422: listener HTTP/HTTPS (L7), sertifikat TLS, routing rule, redirect HTTPS, proxy protocol, sticky session cookie, dan algoritma selain pembagian merata. Field yang tidak dikenal (mis. algorithm) juga ditolak 422 validation_error. Untuk web, pakai listener tcp port 80/443 dengan health check http, dan terminasi TLS di VM. Floating IP tidak bisa dipasang ke load balancer (load balancer sudah punya IP publik sendiri), dan belum ada opsi lintas zona.

Mulai

Konsep dasar

Panduan produk

Lainnya

Harga

Buat load balancer

Security group backend

Listener

Target

Ubah load balancer

Hapus

Load balancer milik Kubernetes

Belum didukung

​Harga

​Buat load balancer

​Security group backend

​Listener

​Target

​Ubah load balancer

​Hapus

​Load balancer milik Kubernetes

​Belum didukung

Harga

Buat load balancer

Security group backend

Listener

Target

Ubah load balancer

Hapus

Load balancer milik Kubernetes

Belum didukung