Vai al contenuto principale
GET
/
v1
/
failover
/
{site_id}
/
tunnels
/
{tunnel_id}
Ottieni un Tunnel Specifico
curl --request GET \
  --url https://api.altostrat.io/v1/failover/{site_id}/tunnels/{tunnel_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "9c6934c9-586b-47e5-9c59-8669911e8609",
  "tunnel_ip": "100.112.0.5",
  "name": "Fibra Primaria",
  "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

Inserisci il tuo JWT nel formato: Bearer <token>

Path Parameters

site_id
string<uuid>
required

L'identificatore univoco per il sito.

Example:

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

tunnel_id
string<uuid>
required

L'identificatore univoco per il tunnel.

Example:

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

Response

I dettagli del tunnel WAN richiesto.

id
string<uuid>

L'identificatore univoco del tunnel.

Example:

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

tunnel_ip
string<ipv4>

L'indirizzo IP interno assegnato all'interfaccia del tunnel all'interno della rete Altostrat.

Example:

"100.112.0.5"

name
string

Un nome definito dall'utente per il tunnel. Il valore predefinito è WAN {priority}.

Example:

"Fibra Primaria"

priority
integer

La priorità di failover del tunnel (1 è la più alta).

Example:

1

isp
string | null

Il nome dell'Internet Service Provider, rilevato dall'IP pubblico del tunnel.

Example:

"Google Fiber"

isp_country
string | null

Il codice paese ISO a due lettere dell'ISP.

Example:

"US"

isp_asn
string | null

L'Autonomous System Number (ASN) dell'ISP.

Example:

"16509"

type
enum<string>

Il tipo fisico o logico della connessione WAN.

Opzioni disponibili:
fibre,
copper,
3g,
4g,
lte,
5g,
ethernet,
coaxial,
vsat,
microwave,
other
Example:

"fibre"

gateway
string<ipv4>

L'indirizzo IP del gateway upstream per questa connessione WAN.

Example:

"198.51.100.1"

interface
string

Il nome dell'interfaccia fisica o logica sul router in loco utilizzata da questo tunnel.

Example:

"ether1-wan"

wan_ip
string<ipv4> | null

L'indirizzo IP pubblico della connessione WAN, come visto dalla rete Altostrat.

Example:

"203.0.113.55"

anycast_ip
string<ipv4> | null

L'indirizzo IP pubblico del concentratore Altostrat a cui questo tunnel si connette.

Example:

"192.0.2.10"

profile_ip
string<ipv4> | null

L'indirizzo IP interno del concentratore Altostrat per questo tunnel.

Example:

"100.64.0.1"

wan_provider_id
string<uuid> | null

L'identificatore per una risorsa Fornitore WAN collegata.

Example:

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

wan_provider_name
string | null

Il nome del Fornitore WAN collegato.

Example:

"Comcast Business"

connected
boolean

Indica se il tunnel è attualmente online e connesso.

Example:

true

latency
number

La latenza più recente misurata per il tunnel in millisecondi.

Example:

12.5

packet_loss
number

La percentuale di perdita di pacchetti misurata negli ultimi 30 minuti.

Example:

0.1

dyndns
string

Un hostname DynDNS stabile che risolve nell'attuale wan_ip pubblico del tunnel.

Example:

"a1b2c3d4e5f6.onpremdns.net"