الانتقال إلى المحتوى الرئيسي
POST
/
instances
إنشاء مثيل VPN
curl --request POST \
  --url https://api.altostrat.io/instances \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "شبكة الإنتاج الأساسية VPN",
  "hostname": "prod-vpn-sjc",
  "region": "sjc"
}'
{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "name": "شبكة الإنتاج الأساسية VPN",
  "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": "السماح بـ 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

أدخل رمز الحامل (bearer token) الخاص بك بالتنسيق: Bearer {token}

Body

application/json
name
string
required

اسم قابل للقراءة البشرية للمثيل الجديد.

Required string length: 3 - 20
Example:

"شبكة الإنتاج الأساسية VPN"

hostname
string
required

اسم مضيف فريد للمثيل. سيكون هذا جزءًا من FQDN. يجب أن يكون مقطع اسم مضيف صالحًا (مثل 'my-vpn-gateway').

Required string length: 3 - 20
Example:

"prod-vpn-sjc"

region
string
required

معرّف المنطقة الجغرافية لنشر المثيل. راجع نقطة النهاية /servers/regions للخيارات المتاحة.

Example:

"sjc"

Response

تم إنشاء مثيل VPN بنجاح.

id
string<uuid>

المعرّف الفريد لمثيل VPN.

Example:

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

name
string

اسم قابل للقراءة البشرية للمثيل.

Example:

"شبكة الإنتاج الأساسية VPN"

region
string

المنطقة الجغرافية التي تم نشر المثيل فيها.

Example:

"sjc"

hostname
string

اسم النطاق المؤهل بالكامل (FQDN) لمثيل VPN.

Example:

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

configured
boolean

يشير إلى ما إذا كان الإعداد الأولي للخادم قد اكتمل.

Example:

true

rsa_ready
boolean

يشير إلى ما إذا كانت شهادات RSA قد تم إنشاؤها.

Example:

true

diffie_hellman_ready
boolean

يشير إلى ما إذا كانت معلمات Diffie-Hellman قد تم إنشاؤها.

Example:

true

server_ready
boolean

مؤشر عام على جاهزية الخادم.

Example:

true

status
string[]

مصفوفة من السلاسل النصية تشير إلى أي تغييرات تكوين جارية. مصفوفة فارغة تعني أن التكوين مستقر.

Example:
["peer-created"]
pushed_routes
string[]

قائمة بمسارات الشبكة (بتدوين CIDR) التي سيتم دفعها إلى العملاء المتصلين.

public_dns
string<ipv4>[]

قائمة بخوادم DNS العامة التي سيستخدمها العملاء.

split_dns
string<ipv4>[]

قائمة بخوادم DNS خاصة لنطاقات معينة (split-tunnel DNS).

domains
string[]

قائمة بأسماء النطاقات التي يجب حلها باستخدام خوادم split_dns.

dns_custom
object[]

قائمة بسجلات DNS المخصصة التي سيخدمها وكيل DNS للمثيل.

firewall
object[]

قائمة بقواعد جدار الحماية المطبقة على المثيل.

created_at
string<date-time>

الطابع الزمني عند إنشاء المثيل.

Example:

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