Langsung ke konten utama
POST
/
instances
Buat instans VPN
curl --request POST \
  --url https://api.altostrat.io/instances \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "VPN Produksi Utama",
  "hostname": "prod-vpn-sjc",
  "region": "sjc"
}'
{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "name": "VPN Produksi Utama",
  "region": "sjc",
  "hostname": "my-vpn-gateway.vpn.altostr.at",
  "configured": true,
  "rsa_ready": true,
  "diffie_hellman_ready": true,
  "server_ready": true,
  "status": [
    "peer-created"
  ],
  "pushed_routes": [
    "10.0.0.0/8"
  ],
  "public_dns": [
    "9.9.9.9"
  ],
  "split_dns": [
    "192.168.1.1"
  ],
  "domains": [
    "internal.corp"
  ],
  "dns_custom": [
    {
      "name": "fileserver.internal.corp",
      "type": "A",
      "value": "192.168.1.10"
    }
  ],
  "firewall": [
    {
      "name": "Izinkan ICMP",
      "protocol": "icmp",
      "port": "1-65535",
      "source": "0.0.0.0/0",
      "destination": "0.0.0.0/0"
    }
  ],
  "created_at": "2025-10-29T12:30:31Z"
}

Authorizations

โ€‹
Authorization
string
header
required

Masukkan token pembawa Anda dalam format: Bearer {token}

Body

application/json
โ€‹
name
string
required

Nama yang dapat dibaca manusia untuk instans baru.

Required string length: 3 - 20
Example:

"VPN Produksi Utama"

โ€‹
hostname
string
required

Nama host unik untuk instans. Ini akan menjadi bagian dari FQDN. Harus merupakan segmen nama host yang valid (mis., 'gerbang-vpn-saya').

Required string length: 3 - 20
Example:

"prod-vpn-sjc"

โ€‹
region
string
required

Pengenal untuk wilayah geografis tempat penerapan instans. Lihat endpoint /servers/regions untuk opsi yang tersedia.

Example:

"sjc"

Response

Instans VPN berhasil dibuat.

โ€‹
id
string<uuid>

Pengenal unik untuk instans VPN.

Example:

"d290f1ee-6c54-4b01-90e6-d701748f0851"

โ€‹
name
string

Nama yang dapat dibaca manusia untuk instans.

Example:

"VPN Produksi Utama"

โ€‹
region
string

Wilayah geografis tempat instans diterapkan.

Example:

"sjc"

โ€‹
hostname
string

Nama domain yang sepenuhnya memenuhi syarat (FQDN) dari instans VPN.

Example:

"my-vpn-gateway.vpn.altostr.at"

โ€‹
configured
boolean

Menunjukkan apakah penyiapan server awal telah selesai.

Example:

true

โ€‹
rsa_ready
boolean

Menunjukkan apakah sertifikat RSA telah dibuat.

Example:

true

โ€‹
diffie_hellman_ready
boolean

Menunjukkan apakah parameter Diffie-Hellman telah dibuat.

Example:

true

โ€‹
server_ready
boolean

Indikator umum kesiapan server.

Example:

true

โ€‹
status
string[]

Array string yang menunjukkan perubahan konfigurasi yang sedang berlangsung. Array kosong berarti konfigurasi stabil.

Example:
["peer-created"]
โ€‹
pushed_routes
string[]

Daftar rute jaringan (dalam notasi CIDR) yang akan di-push ke klien yang terhubung.

โ€‹
public_dns
string<ipv4>[]

Daftar server DNS publik yang akan digunakan oleh klien.

โ€‹
split_dns
string<ipv4>[]

Daftar server DNS pribadi untuk domain tertentu (split-tunnel DNS).

โ€‹
domains
string[]

Daftar nama domain yang harus di-resolve menggunakan server split_dns.

โ€‹
dns_custom
object[]

Daftar catatan DNS kustom yang akan dilayani oleh proksi DNS instans.

โ€‹
firewall
object[]

Daftar aturan firewall yang diterapkan pada instans.

โ€‹
created_at
string<date-time>

Stempel waktu saat instans dibuat.

Example:

"2025-10-29T12:30:31Z"