الانتقال إلى المحتوى الرئيسي
GET
/
sites
/
{siteId}
/
jobs
/
{jobId}
استرداد مهمة
curl --request GET \
  --url https://api.altostrat.io/sites/{siteId}/jobs/{jobId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "8b8b2e5e-1a19-4a19-8b19-1e1919191919",
  "token": "2jP5kLqWnZ",
  "site_id": "9a9a3e6f-1b1a-4b1a-8c1a-1e1a1a1a1a1a",
  "idempotency_key": "7c7c1e4e-1918-4918-8a18-1e1818181818",
  "description": "إضافة قاعدة جدار حماية جديدة لشبكة الضيوف",
  "express_execute": false,
  "needs_acknowledgement": true,
  "should_backup": true,
  "associated_backup": "9a9a3e6f-1b1a-4b1a-8c1a-1e1a1a1a1a1a/1667888400.rsc",
  "started_at": "2025-10-29T12:05:10Z",
  "completed_at": null,
  "failed_at": null,
  "created_at": "2025-10-29T12:00:00Z",
  "log_url": "logs?group=sites&streams=9a9a...&start=...&end=...&filter={$.message=*2jP5kLqWnZ*}",
  "script": "/ip firewall filter add chain=forward action=accept src-address-list=guests"
}

Authorizations

​
Authorization
string
header
required

توثيق الطلبات من خلال توفير رمز ويب JSON (JWT) في ترويسة Authorization. مثال: Authorization: Bearer <YOUR_JWT>

Path Parameters

​
siteId
string<uuid>
required

معرف UUID للموقع.

​
jobId
string<uuid>
required

معرف UUID للمهمة المراد استردادها.

Response

كائن المهمة المطلوب.

أمر أو نص برمجي غير متزامن ليتم تنفيذه على موقع.

​
id
string<uuid>

المعرف الفريد (UUID) للمهمة.

Example:

"8b8b2e5e-1a19-4a19-8b19-1e1919191919"

​
token
string

رمز قصير وفريد وسهل القراءة للمهمة، يُستخدم غالبًا في تصفية السجلات.

Example:

"2jP5kLqWnZ"

​
site_id
string<uuid>

معرف الموقع الذي تستهدفه هذه المهمة.

Example:

"9a9a3e6f-1b1a-4b1a-8c1a-1e1a1a1a1a1a"

​
idempotency_key
string<uuid>

مفتاح فريد يوفره العميل لمنع إنشاء مهام مكررة.

Example:

"7c7c1e4e-1918-4918-8a18-1e1818181818"

​
description
string

وصف سهل القراءة لغرض المهمة.

Example:

"إضافة قاعدة جدار حماية جديدة لشبكة الضيوف"

​
express_execute
boolean

إذا كانت القيمة true، فستحاول المنصة تشغيل تسجيل وصول فوري من الجهاز لتنفيذ هذه المهمة في وقت أسرع.

Example:

false

​
needs_acknowledgement
boolean

إذا كانت القيمة true، تتطلب المهمة إشعارًا صريحًا بالنجاح/الفشل من الجهاز ليتم تمييزها على أنها مكتملة.

Example:

true

​
should_backup
boolean

إذا كانت القيمة true، فقد تم إنشاء نسخة احتياطية من التكوين تلقائيًا قبل وضع هذه المهمة في قائمة الانتظار.

Example:

true

​
associated_backup
string | null

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

Example:

"9a9a3e6f-1b1a-4b1a-8c1a-1e1a1a1a1a1a/1667888400.rsc"

​
started_at
string<date-time> | null

الطابع الزمني عندما بدأ الجهاز في تنفيذ المهمة.

Example:

"2025-10-29T12:05:10Z"

​
completed_at
string<date-time> | null

الطابع الزمني عندما أبلغ الجهاز عن إتمام المهمة بنجاح.

Example:

null

​
failed_at
string<date-time> | null

الطابع الزمني عندما أبلغ الجهاز عن فشل أثناء تنفيذ المهمة.

Example:

null

​
created_at
string<date-time>

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

Example:

"2025-10-29T12:00:00Z"

​
log_url
string

عنوان URL نسبي لواجهة مستخدم Altostrat SDX لعرض السجلات المتعلقة بتنفيذ هذه المهمة.

Example:

"logs?group=sites&streams=9a9a...&start=...&end=...&filter={$.message=*2jP5kLqWnZ*}"

​
script
string

حمولة نص RouterOS البرمجي الخام للمهمة.

Example:

"/ip firewall filter add chain=forward action=accept src-address-list=guests"