الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
failover
/
{site_id}
/
tunnels
إضافة نفق WAN جديد
curl --request POST \
  --url https://api.altostrat.io/v1/failover/{site_id}/tunnels \
  --header 'Authorization: Bearer <token>'
{
  "id": "9c6934c9-586b-47e5-9c59-8669911e8609",
  "tunnel_ip": "100.112.0.5",
  "name": "Primary Fibre",
  "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

أدخل JWT الخاص بك بالتنسيق: Bearer <token>

Path Parameters

​
site_id
string<uuid>
required

المعرف الفريد للموقع.

Example:

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

Response

تم إنشاء النفق الجديد غير المكوّن بنجاح.

​
id
string<uuid>

المعرف الفريد للنفق.

Example:

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

​
tunnel_ip
string<ipv4>

عنوان IP الداخلي المخصص لواجهة النفق داخل شبكة Altostrat.

Example:

"100.112.0.5"

​
name
string

اسم يحدده المستخدم للنفق. القيمة الافتراضية هي WAN {priority}.

Example:

"Primary Fibre"

​
priority
integer

أولوية تجاوز الفشل للنفق (1 هي الأعلى).

Example:

1

​
isp
string | null

اسم مزود خدمة الإنترنت، الذي تم اكتشافه من عنوان IP العام للنفق.

Example:

"Google Fiber"

​
isp_country
string | null

رمز البلد المكون من حرفين حسب معيار ISO لمزود خدمة الإنترنت.

Example:

"US"

​
isp_asn
string | null

رقم النظام المستقل (ASN) لمزود خدمة الإنترنت.

Example:

"16509"

​
type
enum<string>

النوع المادي أو المنطقي لاتصال WAN.

الخيارات المتاحة:
fibre,
copper,
3g,
4g,
lte,
5g,
ethernet,
coaxial,
vsat,
microwave,
other
Example:

"fibre"

​
gateway
string<ipv4>

عنوان IP للبوابة الصاعدة لاتصال WAN هذا.

Example:

"198.51.100.1"

​
interface
string

اسم الواجهة المادية أو المنطقية على جهاز التوجيه في الموقع المستخدم من قبل هذا النفق.

Example:

"ether1-wan"

​
wan_ip
string<ipv4> | null

عنوان IP العام لاتصال WAN، كما تراه شبكة Altostrat.

Example:

"203.0.113.55"

​
anycast_ip
string<ipv4> | null

عنوان IP العام لمُركِّز Altostrat الذي يتصل به هذا النفق.

Example:

"192.0.2.10"

​
profile_ip
string<ipv4> | null

عنوان IP الداخلي لمُركِّز Altostrat لهذا النفق.

Example:

"100.64.0.1"

​
wan_provider_id
string<uuid> | null

المعرف لمورد مزود WAN المرتبط.

Example:

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

​
wan_provider_name
string | null

اسم مزود WAN المرتبط.

Example:

"Comcast Business"

​
connected
boolean

يشير إلى ما إذا كان النفق متصلاً بالإنترنت حاليًا.

Example:

true

​
latency
number

أحدث زمن انتقال تم قياسه للنفق بالمللي ثانية.

Example:

12.5

​
packet_loss
number

نسبة فقدان الحزم التي تم قياسها خلال آخر 30 دقيقة.

Example:

0.1

​
dyndns
string

اسم مضيف DynDNS ثابت يتم تحليله إلى عنوان wan_ip العام الحالي للنفق.

Example:

"a1b2c3d4e5f6.onpremdns.net"