Langsung ke konten utama
PUT
/
v1
/
failover
/
{site_id}
/
tunnels
/
{tunnel_id}
Konfigurasi Tunnel WAN
curl --request PUT \
  --url https://api.altostrat.io/v1/failover/{site_id}/tunnels/{tunnel_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Tautan Fiber Utama",
  "interface": "ether1-wan",
  "gateway": "198.51.100.1",
  "type": "fibre",
  "wan_provider_id": "9c6934e8-4660-4927-9c94-013083e9a531",
  "sla_id": "9c6934f8-d450-482b-8a1a-428615ef5195",
  "enabled": true
}'
{
  "id": "9c6934c9-586b-47e5-9c59-8669911e8609",
  "tunnel_ip": "100.112.0.5",
  "name": "Fiber Utama",
  "priority": 1,
  "isp": "Google Fiber",
  "isp_country": "US",
  "isp_asn": "16509",
  "type": "fibre",
  "gateway": "198.51.100.1",
  "interface": "ether1-wan",
  "wan_ip": "203.0.113.55",
  "anycast_ip": "192.0.2.10",
  "profile_ip": "100.64.0.1",
  "wan_provider_id": "9c6934e8-4660-4927-9c94-013083e9a531",
  "wan_provider_name": "Comcast Business",
  "connected": true,
  "latency": 12.5,
  "packet_loss": 0.1,
  "dyndns": "a1b2c3d4e5f6.onpremdns.net"
}

Authorizations

โ€‹
Authorization
string
header
required

Masukkan JWT Anda dalam format: Bearer <token>

Path Parameters

โ€‹
site_id
string<uuid>
required

Pengidentifikasi unik untuk situs.

Example:

"9c69345c-8d39-4786-9f17-8153c988c89a"

โ€‹
tunnel_id
string<uuid>
required

Pengidentifikasi unik untuk tunnel.

Example:

"9c6934c9-586b-47e5-9c59-8669911e8609"

Body

application/json
โ€‹
name
string
required

Nama deskriptif untuk koneksi WAN.

Example:

"Tautan Fiber Utama"

โ€‹
interface
string
required

Nama interface pada router untuk mengikat tunnel ini (mis., ether1, pppoe-out1).

Example:

"ether1-wan"

โ€‹
gateway
string<ipv4>
required

Alamat IP gateway upstream untuk koneksi ini.

Example:

"198.51.100.1"

โ€‹
type
enum<string>
required

Jenis teknologi koneksi.

Opsi yang tersedia:
fibre,
copper,
3g,
4g,
lte,
5g,
ethernet,
coaxial,
vsat,
microwave,
other
Example:

"fibre"

โ€‹
enabled
boolean
required

Mengaktifkan atau menonaktifkan tunnel dan apakah tunnel disertakan dalam logika failover.

Example:

true

โ€‹
wan_provider_id
string<uuid> | null

Pengidentifikasi opsional untuk mengaitkan tunnel ini dengan penyedia WAN yang telah dikonfigurasi sebelumnya.

Example:

"9c6934e8-4660-4927-9c94-013083e9a531"

โ€‹
sla_id
string<uuid> | null

Pengidentifikasi opsional untuk mengaitkan tunnel ini dengan profil SLA tertentu. Memerlukan wan_provider_id.

Example:

"9c6934f8-d450-482b-8a1a-428615ef5195"

Response

Tunnel berhasil diperbarui.

โ€‹
id
string<uuid>

Pengidentifikasi unik tunnel.

Example:

"9c6934c9-586b-47e5-9c59-8669911e8609"

โ€‹
tunnel_ip
string<ipv4>

Alamat IP internal yang ditetapkan ke interface tunnel di dalam jaringan Altostrat.

Example:

"100.112.0.5"

โ€‹
name
string

Nama yang ditentukan pengguna untuk tunnel. Defaultnya adalah WAN {priority}.

Example:

"Fiber Utama"

โ€‹
priority
integer

Prioritas failover tunnel (1 adalah yang tertinggi).

Example:

1

โ€‹
isp
string | null

Nama Penyedia Layanan Internet, terdeteksi dari IP publik tunnel.

Example:

"Google Fiber"

โ€‹
isp_country
string | null

Kode negara ISO dua huruf dari ISP.

Example:

"US"

โ€‹
isp_asn
string | null

Autonomous System Number (ASN) dari ISP.

Example:

"16509"

โ€‹
type
enum<string>

Jenis fisik atau logis dari koneksi WAN.

Opsi yang tersedia:
fibre,
copper,
3g,
4g,
lte,
5g,
ethernet,
coaxial,
vsat,
microwave,
other
Example:

"fibre"

โ€‹
gateway
string<ipv4>

Alamat IP dari gateway upstream untuk koneksi WAN ini.

Example:

"198.51.100.1"

โ€‹
interface
string

Nama interface fisik atau logis pada router di lokasi yang digunakan oleh tunnel ini.

Example:

"ether1-wan"

โ€‹
wan_ip
string<ipv4> | null

Alamat IP publik dari koneksi WAN, seperti yang terlihat oleh jaringan Altostrat.

Example:

"203.0.113.55"

โ€‹
anycast_ip
string<ipv4> | null

Alamat IP publik dari konsentrator Altostrat yang terhubung dengan tunnel ini.

Example:

"192.0.2.10"

โ€‹
profile_ip
string<ipv4> | null

Alamat IP internal dari konsentrator Altostrat untuk tunnel ini.

Example:

"100.64.0.1"

โ€‹
wan_provider_id
string<uuid> | null

Pengidentifikasi untuk sumber daya Penyedia WAN yang ditautkan.

Example:

"9c6934e8-4660-4927-9c94-013083e9a531"

โ€‹
wan_provider_name
string | null

Nama Penyedia WAN yang ditautkan.

Example:

"Comcast Business"

โ€‹
connected
boolean

Menunjukkan apakah tunnel saat ini online dan terhubung.

Example:

true

โ€‹
latency
number

Latensi yang terakhir diukur untuk tunnel dalam milidetik.

Example:

12.5

โ€‹
packet_loss
number

Persentase kehilangan paket yang diukur selama 30 menit terakhir.

Example:

0.1

โ€‹
dyndns
string

Nama host DynDNS stabil yang me-resolve ke wan_ip publik tunnel saat ini.

Example:

"a1b2c3d4e5f6.onpremdns.net"