الانتقال إلى المحتوى الرئيسي
POST
/
prefix-lists
إنشاء قائمة بادئات
curl --request POST \
  --url https://api.altostrat.io/prefix-lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "عناوين IP لمكتب الشركة",
  "description": "عناوين IP الثابتة لمكتب شركتنا الرئيسي.",
  "prefixes": [
    {
      "cidr": "203.0.113.0/28",
      "description": "كتلة مزود الخدمة الرئيسي"
    },
    {
      "cidr": "198.51.100.10/32",
      "description": "مزود الخدمة الاحتياطي"
    }
  ],
  "sites": []
}'
{
  "id": "prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw",
  "name": "عناوين IP للمكتب الرئيسي",
  "description": "نطاقات IP العامة للمكتب الرئيسي.",
  "status": "active",
  "sites": [
    "site_12345"
  ],
  "prefixes": [
    {
      "id": "prfx_0ujsswThIGTUYm2K8FjOOfxcYpw",
      "cidr": "192.0.2.0/24",
      "description": "الشبكة الفرعية للخادم الرئيسي"
    }
  ]
}

Authorizations

Authorization
string
header
required

تتم المصادقة عبر رمز ويب JSON (JWT) صادر عن Auth0. قدم الرمز في ترويسة Authorization مع مخطط Bearer.

Body

application/json

تفاصيل قائمة البادئات الجديدة.

يحدد الخصائص القابلة للكتابة لإنشاء أو تحديث قائمة بادئات.

name
string
required

اسم يمكن للإنسان قراءته لقائمة البادئات.

Maximum length: 255
Example:

"نقاط نهاية API للطرف الثالث"

prefixes
object[]
required

قائمة بالبادئات (كتل CIDR). يتم استبدال القائمة بأكملها عند التحديث.

Maximum length: 500
sites
string[]
required

قائمة بمعرفات المواقع التي يجب تطبيق قائمة البادئات هذه عليها مباشرة. يتم استبدال القائمة الكاملة للمواقع عند التحديث.

description
string | null

وصف اختياري لقائمة البادئات.

Maximum length: 1000
Example:

"عناوين IP الثابتة للخدمات التي نتكامل معها."

Response

تم إنشاء قائمة البادئات بنجاح.

يمثل مجموعة مسماة وقابلة لإعادة الاستخدام من عناوين IP وكتل CIDR.

id
string

المعرف الفريد لقائمة البادئات، مسبوقًا بـ prfx_lst_.

Example:

"prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw"

name
string

اسم يمكن للإنسان قراءته لقائمة البادئات.

Example:

"عناوين IP للمكتب الرئيسي"

description
string

وصف اختياري لقائمة البادئات.

Example:

"نطاقات IP العامة للمكتب الرئيسي."

status
enum<string>

حالة المزامنة الحالية لقائمة البادئات.

الخيارات المتاحة:
active,
syncing,
failed
Example:

"active"

sites
string[]

قائمة بمعرفات المواقع التي يتم تطبيق قائمة البادئات هذه عليها مباشرة.

prefixes
object[]

قائمة كتل CIDR في قائمة البادئات هذه.