Lewati ke konten utama

Backoffice Private Network (Virtual Switch)

Layanan Backoffice ini ditujukan bagi Administrator (Support/SysAdmin) untuk melakukan pengawasan terpusat terhadap seluruh fasilitas Private Network (Virtual Switch) yang di-provisioning oleh pelanggan di berbagai Datacenter.

API di bawah ini mengembalikan daftar seluruh switch aktif, melihat detail, serta melacak topologi (Graph) jaringan milik Customer.

1. Menampilkan Seluruh Private Network (Global)​

Mengambil daftar Virtual Switch dari semua pelanggan yang terdaftar di dalam sistem tanpa batasan akun.

Request
GET /api/backoffice/private_network

Respons (200 OK):

[
  {
    "id": 45,
    "uuid": "priv-1234abcd-5678-efgh-9012-ijklmnop3456",
    "name": "Database Cluster Network",
    "location_id": 1,
    "customer_id": 123,
    "network_ip": "10.0.1.0",
    "cidr": 24,
    "status": "ACTIVE",
    "created_at": "2026-05-15T15:00:00Z"
  },
  {
    "id": 46,
    "uuid": "priv-abcdef01-2345-6789-abcd-ef0123456789",
    "name": "Internal Backend",
    "location_id": 2,
    "customer_id": 89,
    "network_ip": "192.168.1.0",
    "cidr": 24,
    "status": "ACTIVE",
    "created_at": "2026-05-14T09:30:00Z"
  }
]

Catatan: Output dari layanan Backoffice ini mengembalikan array JSON secara langsung (tanpa wrapper message atau data), berbeda dari standar format API Customer.

2. Melihat Detail Private Network Spesifik​

Melihat rincian suatu Virtual Switch tertentu berdasarkan ID internalnya.

Request
GET /api/backoffice/private/{private_network_id}/details

Respons (200 OK):

{
  "id": 45,
  "uuid": "priv-1234abcd-5678-efgh-9012-ijklmnop3456",
  "name": "Database Cluster Network",
  "location_id": 1,
  "customer_id": 123,
  "network_ip": "10.0.1.0",
  "cidr": 24,
  "status": "ACTIVE",
  "created_at": "2026-05-15T15:00:00Z"
}

3. Visualisasi Topologi (Network Graph) Backoffice​

Mendapatkan arsitektur relasional (Nodes dan Edges) untuk mendiagnosis sambungan mesin ke mesin dalam suatu Virtual Switch.

Request
GET /api/backoffice/private/{private_network_id}/graph

Respons (200 OK):

{
  "private_network_id": 45,
  "nodes": [
    {
      "id": "node-1",
      "label": "DB-Master (10.0.1.2)"
    }
  ],
  "edges": [
    {
      "from": "switch-45",
      "to": "node-1"
    }
  ]
}

Informasi Integrasi: Data Nodes dan Edges saat ini adalah kerangka format yang nantinya akan diintegrasikan dengan API topologi tingkat Hypervisor (misalnya Proxmox SDN) untuk melacak status real-time kabel virtual antar antarmuka jaringan peladen pelanggan.