الانتقال إلى المحتوى الرئيسي
PUT
/
scheduled
/
{scheduledScriptId}
تحديث اسكربت مجدول
curl --request PUT \
  --url https://api.altostrat.io/scheduled/{scheduledScriptId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "test_site_id": "site_2Al5z3gXyY5f6Z7h8j9k0l1m",
  "make_backup": true,
  "description": "صيانة نظير BGP الليلية (مُحدَّث)",
  "script": "/routing bgp peer enable [find name=peer1]",
  "sites": [
    "site_1AbCdEfGhIjKlMnOpQrStUv"
  ],
  "notify": [
    "auth0|5f9d4b3c2e1a0b006f8b4c5d",
    "auth0|6a0e5c4d3f2b1c007g9c5d6e"
  ]
}'
{
  "id": "018f5bda-4690-4432-8472-358b2734f19b",
  "created_by": "auth0|642b7f3b8b3b3e3e3e3e3e3e",
  "test_site_id": "site_2Al5z3gXyY5f6Z7h8j9k0l1m",
  "make_backup": true,
  "abort_if_offline": false,
  "description": "تحديث قاعدة جدار الحماية الأسبوعي",
  "summary": "يضيف هذا الاسكربت قاعدة تصفية في جدار الحماية لإسقاط المدخلات من قائمة عناوين محددة تسمى \"blacklist\".",
  "script": "/ip firewall filter add action=drop chain=input src-address-list=blacklist",
  "status": "scheduled",
  "authorized_at": "2025-10-30T10:00:00.000000Z",
  "cancelled_at": null,
  "launch_at": "2025-11-01T02:00:00.000000Z",
  "t_minus": "بعد يومين",
  "started_at": "2025-11-01T02:00:05.000000Z",
  "sites": [
    "site_1AbCdEfGhIjKlMnOpQrStUv"
  ],
  "notify": [
    "auth0|5f9d4b3c2e1a0b006f8b4c5d"
  ],
  "progress": {
    "completed": [
      "site_1AbCdEfGhIjKlMnOpQrStUv"
    ],
    "failed": [
      "site_2BcDeFgHiJkLmNoPqRsTuVw"
    ],
    "pending": [
      "site_3CdEfGhIjKlMnOpQrStUvWx"
    ]
  },
  "created_at": "2025-10-29T12:44:27.000000Z",
  "updated_at": "2025-10-29T13:05:00.000000Z"
}

Authorizations

​
Authorization
string
header
required

تستخدم واجهة برمجة تطبيقات Altostrat SDX رموز Bearer من نوع JWT للمصادقة. احصل على رمز عبر واجهة برمجة تطبيقات المصادقة وأدرجه في ترويسة Authorization كـ 'Bearer {token}'.

Path Parameters

​
scheduledScriptId
string<uuid>
required

المعرف الفريد للسكريبت المجدول المراد تحديثه.

Example:

"018f5bda-4690-4432-8472-358b2734f19b"

Body

application/json
​
make_backup
boolean
required

إذا كانت القيمة true، قم بإنشاء نسخة احتياطية من التكوين قبل تنفيذ الاسكربت.

Example:

true

​
description
string
required

اسم قابل للقراءة البشرية للسكريبت المجدول.

Example:

"صيانة نظير BGP الليلية (مُحدَّث)"

​
script
string
required

المحتوى الكامل لاسكربت MikroTik RouterOS.

Example:

"/routing bgp peer enable [find name=peer1]"

​
sites
string<uuid>[]
required

مصفوفة من معرفات المواقع المراد استهدافها.

Example:
["site_1AbCdEfGhIjKlMnOpQrStUv"]
​
notify
string<uuid>[]
required

مصفوفة من معرفات المستخدمين لتلقي الإشعارات.

Example:
[
  "auth0|5f9d4b3c2e1a0b006f8b4c5d",
  "auth0|6a0e5c4d3f2b1c007g9c5d6e"
]
​
test_site_id
string<uuid> | null

المعرف الفريد للموقع المخصص للتشغيل الاختباري.

Example:

"site_2Al5z3gXyY5f6Z7h8j9k0l1m"

Response

تم تحديث الاسكربت المجدول بنجاح.

​
id
string<uuid>

المعرف الفريد للسكريبت المجدول.

Example:

"018f5bda-4690-4432-8472-358b2734f19b"

​
created_by
string<uuid>

معرف المستخدم الذي أنشأ جدول الاسكربت.

Example:

"auth0|642b7f3b8b3b3e3e3e3e3e3e"

​
test_site_id
string<uuid> | null

المعرف الفريد للموقع المخصص للتشغيل الاختباري.

Example:

"site_2Al5z3gXyY5f6Z7h8j9k0l1m"

​
make_backup
boolean

إذا كانت القيمة true، سيتم إنشاء نسخة احتياطية من التكوين على كل جهاز مستهدف قبل تنفيذ الاسكربت.

Example:

true

​
abort_if_offline
boolean

إذا كانت القيمة true، سيتم إحباط تنفيذ الاسكربت لموقع ما إذا كان غير متصل بالإنترنت في وقت الإطلاق.

Example:

false

​
description
string

اسم أو وصف قابل للقراءة البشرية لجدول الاسكربت.

Example:

"تحديث قاعدة جدار الحماية الأسبوعي"

​
summary
string | null

ملخص تم إنشاؤه بواسطة الذكاء الاصطناعي لغرض الاسكربت.

Example:

"يضيف هذا الاسكربت قاعدة تصفية في جدار الحماية لإسقاط المدخلات من قائمة عناوين محددة تسمى \"blacklist\"."

​
script
string

المحتوى الكامل لاسكربت MikroTik RouterOS المراد تنفيذه.

Example:

"/ip firewall filter add action=drop chain=input src-address-list=blacklist"

​
status
enum<string>

الحالة الحالية للسكريبت المجدول.

الخيارات المتاحة:
unauthorized,
scheduled,
launched,
cancelled
Example:

"scheduled"

​
authorized_at
string<date-time> | null

الطابع الزمني الذي تم فيه تفويض تنفيذ الاسكربت. يكون null إذا لم يتم تفويضه بعد.

Example:

"2025-10-30T10:00:00.000000Z"

​
cancelled_at
string<date-time> | null

الطابع الزمني الذي تم فيه إلغاء الاسكربت.

Example:

null

​
launch_at
string<date-time>

التاريخ والوقت المجدولان (بتوقيت UTC) لتنفيذ الاسكربت.

Example:

"2025-11-01T02:00:00.000000Z"

​
t_minus
string | null

عد تنازلي قابل للقراءة البشرية حتى وقت الإطلاق.

Example:

"بعد يومين"

​
started_at
string<date-time> | null

الطابع الزمني الذي بدأ فيه تنفيذ الاسكربت بالفعل.

Example:

"2025-11-01T02:00:05.000000Z"

​
sites
string<uuid>[]

قائمة بمعرفات المواقع التي سيتم تنفيذ الاسكربت عليها.

​
notify
string<uuid>[]

قائمة بمعرفات المستخدمين لإعلامهم بتقدم الاسكربت وطلبات التفويض.

​
progress
object

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

​
created_at
string<date-time>

الطابع الزمني الذي تم فيه إنشاء الاسكربت المجدول.

Example:

"2025-10-29T12:44:27.000000Z"

​
updated_at
string<date-time>

الطابع الزمني الذي تم فيه آخر تحديث للسكريبت المجدول.

Example:

"2025-10-29T13:05:00.000000Z"