Saltar al contenido principal
PUT
/
v1
/
failover
/
{site_id}
/
tunnels
/
{tunnel_id}
Configurar un Túnel 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": "Enlace de Fibra Principal",
  "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": "Fibra Principal",
  "priority": 1,
  "isp": "Telefónica de España",
  "isp_country": "ES",
  "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": "Telefónica Empresas",
  "connected": true,
  "latency": 12.5,
  "packet_loss": 0.1,
  "dyndns": "a1b2c3d4e5f6.onpremdns.net"
}

Authorizations

​
Authorization
string
header
required

Introduzca su JWT en el formato: Bearer <token>

Path Parameters

​
site_id
string<uuid>
required

El identificador único para el sitio.

Example:

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

​
tunnel_id
string<uuid>
required

El identificador único para el túnel.

Example:

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

Body

application/json
​
name
string
required

Un nombre descriptivo para la conexión WAN.

Example:

"Enlace de Fibra Principal"

​
interface
string
required

El nombre de la interfaz en el router a la que se vinculará este túnel (p. ej., ether1, pppoe-out1).

Example:

"ether1-wan"

​
gateway
string<ipv4>
required

La dirección IP de la puerta de enlace ascendente para esta conexión.

Example:

"198.51.100.1"

​
type
enum<string>
required

El tipo de tecnología de la conexión.

Opciones disponibles:
fibre,
copper,
3g,
4g,
lte,
5g,
ethernet,
coaxial,
vsat,
microwave,
other
Example:

"fibre"

​
enabled
boolean
required

Alterna si el túnel está activo e incluido en la lógica de conmutación por error.

Example:

true

​
wan_provider_id
string<uuid> | null

Un identificador opcional para asociar este túnel con un proveedor WAN preconfigurado.

Example:

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

​
sla_id
string<uuid> | null

Un identificador opcional para asociar este túnel con un perfil de SLA específico. Requiere wan_provider_id.

Example:

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

Response

El túnel fue actualizado con éxito.

​
id
string<uuid>

El identificador único del túnel.

Example:

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

​
tunnel_ip
string<ipv4>

La dirección IP interna asignada a la interfaz del túnel dentro de la red de Altostrat.

Example:

"100.112.0.5"

​
name
string

Un nombre definido por el usuario para el túnel. Por defecto es WAN {priority}.

Example:

"Fibra Principal"

​
priority
integer

La prioridad de conmutación por error del túnel (1 es la más alta).

Example:

1

​
isp
string | null

El nombre del Proveedor de Servicios de Internet, detectado a partir de la IP pública del túnel.

Example:

"Telefónica de España"

​
isp_country
string | null

El código de país ISO de dos letras del ISP.

Example:

"ES"

​
isp_asn
string | null

El Número de Sistema Autónomo (ASN) del ISP.

Example:

"16509"

​
type
enum<string>

El tipo físico o lógico de la conexión WAN.

Opciones disponibles:
fibre,
copper,
3g,
4g,
lte,
5g,
ethernet,
coaxial,
vsat,
microwave,
other
Example:

"fibre"

​
gateway
string<ipv4>

La dirección IP de la puerta de enlace ascendente para esta conexión WAN.

Example:

"198.51.100.1"

​
interface
string

El nombre de la interfaz física o lógica en el router local utilizada por este túnel.

Example:

"ether1-wan"

​
wan_ip
string<ipv4> | null

La dirección IP pública de la conexión WAN, tal como la ve la red de Altostrat.

Example:

"203.0.113.55"

​
anycast_ip
string<ipv4> | null

La dirección IP pública del concentrador de Altostrat al que se conecta este túnel.

Example:

"192.0.2.10"

​
profile_ip
string<ipv4> | null

La dirección IP interna del concentrador de Altostrat para este túnel.

Example:

"100.64.0.1"

​
wan_provider_id
string<uuid> | null

El identificador para un recurso de Proveedor WAN vinculado.

Example:

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

​
wan_provider_name
string | null

El nombre del Proveedor WAN vinculado.

Example:

"Telefónica Empresas"

​
connected
boolean

Indica si el túnel está actualmente en línea y conectado.

Example:

true

​
latency
number

La latencia más reciente medida para el túnel en milisegundos.

Example:

12.5

​
packet_loss
number

El porcentaje de pérdida de paquetes medido en los últimos 30 minutos.

Example:

0.1

​
dyndns
string

Un nombre de host DynDNS estable que resuelve a la wan_ip pública actual del túnel.

Example:

"a1b2c3d4e5f6.onpremdns.net"