تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

جدولة مهام تحقيق الربح

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

نظرة عامة على المهام المُجدوَلة

تتيح ميزة تحقيق الربح استخدام ميزة جدولة المهام ومجموعة من الوظائف التي تمت جدولتها مسبقًا لتنفيذها في أوقات محددة.

يسرد الجدول أدناه المهام المجدوَلة مسبقًا التي توفّرها ميزة تحقيق الربح وتلك التي تم تحديد موعد لتنفيذها (جميع الأوقات معروضة بالتوقيت العالمي المنسّق). كما تم إدراج عامل التشغيل لكل مهمة.

الوظيفة	الوصف	الجدول الزمني (التوقيت العالمي المنسق)	عامل التفعيل
معدّل الضريبة الشهري للمطوّرين	لجلب معدّل الضريبة من محرّك الضرائب لكل مطوّر، وتعديل كيان المطوّر بنسبة الضريبة المعدَّلة.	أوّل يوم من كل شهر الساعة 5:45 صباحًا	`MINT.MONTHLY_DEV_TAXRATE@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
تجديد الاشتراك	تطبّق الرسوم المتكرّرة لخطط الأسعار النشطة أو الرسوم الجديدة على خطط الأسعار المستقبلية التي تبدأ في اليوم الحالي.	كل يوم في الساعة 5 ثوانٍ بعد منتصف الليل	`MINT.RENEW_SUBSCRIPTIONS@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
أداة تحديث XeFeed	الحصول على سعر الصرف بالدولار الأمريكي لكل عملة معتمَدة	كل يوم في ثانية واحدة بعد منتصف الليل	`MINT.XEFEED@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
تجديد خطة السعر للمطوّرين	تمثّل هذه السمة تواريخ التجديد لخطة أسعار وتحتسب رسوم الإنهاء المبكر.	يوميًا الساعة 2:20 صباحًا	`MINT.RENEW_DEV_RATEPLAN@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
إعادة محاولة إرسال المعاملة	ملاحظة: تم إيقاف هذه الوظيفة نهائيًا وليس لها أي تأثير في إمكانية تحقيق الربح.	يوميًا الساعة 4:30 صباحًا	`MINT.RETRY_TX_RELAY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
منظِّف المعاملات	ملاحظة: تم إيقاف هذه الوظيفة نهائيًا وليس لها أي تأثير في إمكانية تحقيق الربح.	يوميًا الساعة 5:30 صباحًا	`MINT.TX_CLEANSER@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
التدقيق في رصيد المطوّر	التدقيق في رصيد حساب المطوّر. نسخ الاستخدام الحالي ورصيد الدفع المسبق/حد الائتمان المسبق الدفع في جدول تدقيق، ثم خصم الاستخدام الحالي من حساب المطوّر وإعادة رصيد الاستخدام إلى صفر.	اليوم الأول من كل شهر في الساعة 5 بعد منتصف الليل	`MINT.DEVELOPER_BALANCE_AUDIT@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
مستندات الفوترة الشهرية	ينشئ مستندات الفوترة. ملاحظة: لم تعُد خدمة Apigee تتيح إنشاء مستندات الفوترة من ميزة تحقيق الربح في Apigee Edge. يُرجى الاطّلاع على التقاعد.	اليوم الحادي عشر من كل شهر بعد منتصف الليل بدقيقة واحدة	`MINT.MONTLY_BILLING_DOCS@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
عدّاد خطة أسعار المطوّرين	ملاحظة: تم إيقاف هذه الوظيفة نهائيًا وليس لها أي تأثير في إمكانية تحقيق الربح.	كل يوم في الساعة 3 ثوانٍ بعد منتصف الليل	`MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
الرسوم اليومية	إعادة حساب إجمالي المعاملات بالساعة واستخدامها لحساب الإجماليات اليومية لليوم السابق	يوميًا في الساعة 1:20 صباحًا	`MINT.CHARGE_DAILY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
الرسوم كل ساعة	احتساب إجمالي المعاملات لكل ربع ساعة على مدار الساعة	دقيقة واحدة بعد كل ربع ساعة	`MINT.CHARGE_HOURLY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
إعادة تحميل إعدادات الإشعارات	إعادة فهرسة جميع شروط الإشعارات	كل ٥ دقائق	`MINT.REFRESH_NOTIFICATION_CONFIG@@@ management-server@@@SYSTEM@@@ management-server@@@SYSTEM`
إرسال إشعارات عبر البريد الإلكتروني	إرسال إشعارات مجمّعة عبر البريد الإلكتروني	كل ساعة	`MINT.EMAIL_NOTIFICATION@@@ management-server@@@SYSTEM@@@ management-server@@@SYSTEM`
حد إعادة التحميل	ملاحظة: تم إيقاف هذه الوظيفة نهائيًا وليس لها أي تأثير في إمكانية تحقيق الربح.	لا ينطبق (لا يتم تنفيذه مطلقًا)	`MINT.REFRESH_LIMIT@@@ message-processor@@@SYSTEM@@@ message-processor@@@SYSTEM`

بالإضافة إلى الوظائف المذكورة أعلاه، هناك وظائف يمكنك تفعيلها من خلال إشعارات الفعاليات، كما هو موضّح في الجدول التالي. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد الإشعارات.

الوظيفة	الوصف	ضبط موعد للعرض	عامل التفعيل
إشعار طرد جديد	يرسل إشعارًا إلى جميع المطوّرين لإبلاغهم بتوفّر حزمة جديدة من واجهة برمجة التطبيقات.	يتم تشغيل الوظيفة مرة واحدة - في اليوم الذي يتم فيه تفعيل الوظيفة في الساعة 9:00 مساءً. ملاحظة: يتم إرسال الإشعارات مرة واحدة فقط، بغض النظر عمّا إذا كنت قد ضبطت `cronExpression` يؤدي إلى تنفيذ المهمة عدة مرات.	`MINT.NEW_PACKAGE_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
إشعار مخصص جديد	يرسل إشعارًا إلى جميع مطوّري البرامج يفيد بأنّ منتجات واجهة برمجة التطبيقات الجديدة متاحة في أسواق جغرافية معيّنة.	يتم تشغيل الوظيفة مرة واحدة - في اليوم الذي يتم فيه تفعيل الوظيفة في الساعة 9:00 مساءً. ملاحظة: يتم إرسال الإشعارات مرة واحدة فقط، بغض النظر عمّا إذا كنت قد ضبطت `cronExpression` يؤدي إلى تنفيذ المهمة عدة مرات.	`MINT.ADHOC_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
إشعار بشأن منتج جديد	يرسل إشعارًا إلى جميع المطوّرين لإبلاغهم بتوفّر منتج جديد من واجهة برمجة التطبيقات.	يتم تشغيل الوظيفة مرة واحدة - في اليوم الذي يتم فيه تفعيل الوظيفة في الساعة 9:00 مساءً. ملاحظة: يتم إرسال الإشعارات مرة واحدة فقط، بغض النظر عمّا إذا كنت قد ضبطت `cronExpression` يؤدي إلى تنفيذ المهمة عدة مرات.	`MINT.NEW_PRODUCT_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
إشعار بخطة الأسعار الجديدة	إرسال إشعار إلى المطوّرين المتأثّرين لإبلاغهم بتوفّر خطة أسعار جديدة. يتم إشعار جميع المطوّرين المشتركين في خطة الأسعار الرئيسية بأنّ خطة أسعار جديدة نشطة. بالإضافة إلى ذلك: إذا كانت خطة الأسعار خطة عادية، سيتم إشعار جميع المطوّرين. إذا كانت خطة السعر لفئة مطوّري البرامج، سيتم إشعار المطوّرين في هذه الفئة فقط. إذا كانت خطة السعر الخاصة بالمطوّرين، سيتم إشعار هذا المطوّر المحدّد فقط.	يبدأ التنفيذ في تاريخ بدء خطة السعر الجديدة، في الساعة 4:30 صباحًا.	`MINT.NEW_RATEPLAN_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
جديد Tnc	يؤدي هذا الخيار إلى إرسال إشعار إلى المطوّرين المعنيّين بأنه تم نشر الأحكام والشروط الجديدة أو المعدَّلة (ولم يقبلها المطوّر بعد).	يتم تشغيله قبل 30 و7 ويوم واحد من تاريخ بدء الأحكام والشروط الجديدة أو المعدَّلة في الساعة 9:00 مساءً.	`MINT.TNC_ACCEPTANCE_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`
خطة أسعار منتهية الصلاحية	تتيح هذه السياسة إرسال إشعار إلى المطوّرين المتأثرين لتقديم تحذير مُسبق بشأن ستنتهي صلاحية خطة السعر.	يتم تنفيذ هذه العملية قبل 30 و7 ويوم واحد من انتهاء صلاحية خطة السعر، في الساعة 9:00 مساءً.	`MINT.EXPIRING_RATE_PLAN_NOTIFY@@@ management-server@@@DEFAULT@@@ management-server@@@DEFAULT`

إدارة الجدول الزمني لمهام تحقيق الربح باستخدام واجهة برمجة التطبيقات

توضّح الأقسام التالية كيفية إدارة جدول مهام تحقيق الربح باستخدام واجهة برمجة التطبيقات:

ضبط المشغِّلات
إنشاء تعبيرات cron
عرض المهام المُجدوَلة باستخدام واجهة برمجة التطبيقات
تعديل المهام المُجدوَلة باستخدام واجهة برمجة التطبيقات
إيقاف مهمة مُجدوَلة وإعادة تفعيلها باستخدام واجهة برمجة التطبيقات

لمزيد من المعلومات حول واجهات برمجة التطبيقات الموضّحة في هذا القسم، يُرجى الاطّلاع على المهام المُجدوَلة في مرجع واجهة برمجة التطبيقات.

تهيئة المشغلات

تعتمد أداة الجدولة على المشغلات لتنفيذ المهام. يتم تنفيذ مهمة مجدوَلة عند تنفيذ العامل المشغِّل المرتبط بها. تحدّد خصائص المشغِّل عملية تنفيذ المهمة، ومن خلال ضبط قيمة هذه السمات، يمكنك التحكّم في خصائص تنفيذها، مثل وقت تنفيذها وعدد مرات تنفيذها.

النوعان الأكثر شيوعًا من المشغّلات هما مشغّلات cron والمشغّلات البسيطة. يتضمّن مشغّل cron السمة cronExpression التي تحدّد جدولاً زمنيًا للتنفيذ. لا يتضمّن المشغِّل البسيط السمة cronExpression. يمكنك تحديد startTime للإشارة إلى وقت بدء المشغِّل، واختيار endTime.

في ما يلي خصائص المشغِّل (جميع الأوقات المعروضة بالتوقيت العالمي المنسّق):

الموقع	الوصف
`cronExpression`	تعبير Cron لإنشاء جدول تنفيذ للعامل المشغِّل، مثل: "في الساعة 8:00 صباحًا كل يوم من الاثنين إلى الجمعة" أو "في الساعة 1:30 صباحًا كل يوم جمعة الأخير من الشهر". راجِع إنشاء تعبيرات cron للحصول على مزيد من التفاصيل. يؤدي تحديد هذه الخاصية إلى تحديد المشغل باعتباره مشغل cron. ملاحظة: إذا تم تحديد كل من `cronExpression` و`startTime`/`endTime`، تكون الأولوية للسمة `cronExpression`.
`enabled`	علامة تشير إلى ما إذا كان المشغِّل مفعَّلاً للتنفيذ يمكن أن تكون القيمة واحدة مما يلي: `true`. المشغِّل مفعَّل للتنفيذ. `false`. المشغِّل غير مفعَّل ولن يتم تنفيذه.
`endTime`	الوقت في تنسيق الحقبة عندما لا يكون جدول المشغِّل ساري المفعول.
`group`	نوع الخادم الذي سيتم تنفيذ المشغِّل فيه. على سبيل المثال، إذا كان من المفترض أن يتم تنفيذ المشغّل في خادم إدارة، يجب ضبط القيمة على `management-server`. وإذا كان من المفترض أن يتم تنفيذ العامل المشغِّل في خادم معالجة الرسائل، يجب ضبط القيمة على `message-processor`.
`id`	تحديد العامل المشغِّل
`jobId`	تحديد الوظيفة المطلوب تنفيذها.
`name`	اسم فريد يُستخدم لتحديد المشغِّل.
`priority`	أولوية التنفيذ النسبية للمشغلات إذا تمت جدولة تنفيذ مشغّلات متعددة في الوقت نفسه. وكلما انخفضت القيمة، ارتفعت الأولوية. على سبيل المثال، إذا تمت جدولة تنفيذين عاملين في الوقت نفسه، وإذا كانت الأولوية لأحد المشغِّلين 1 والأخرى ذات الأولوية 2، سيتم تنفيذ المشغِّل ذي الأولوية 1 أولاً. لا تنطبق هذه الخاصية إلّا إذا كانت المُشغِّلات المتعددة لها وقت التنفيذ نفسه بالضبط.
`startTime`	لا ينطبق إلا على المشغلات البسيطة. الوقت في تنسيق الحقبة عندما يدخل الجدول الزمني للعامل المشغِّل حيز التنفيذ. ملاحظة: إذا تم تحديد كل من `cronExpression` و`startTime`/`endTime`، تكون الأولوية للسمة `cronExpression`.
`suiteId`	علامة تحدد ما إذا كان جزء الإشعار من مجموعة الإشعارات على مستوى النظام أو على المستوى التلقائي. والقيم الصالحة هي `DEFAULT` أو `SYSTEM`، أو يمكنك تحديد اسم المجموعة الفريد الخاص بك.
`triggerDataMap`	مفتاح قفل `custom_lock_key` يمنع خوادم متعددة من تنفيذ المهمة نفسها في الوقت نفسه.

إنشاء تعبيرات cron

تعبير cron هو سلسلة تتكون من ستة أو سبعة حقول مفصولة بمسافة بيضاء. يمثّل التعبير مجموعة من المرات، وعادةً ما يكون ذلك كجدول زمني لتنفيذ سلسلة إجراءات. ويتم استخدام تعبيرات cron المحددة في السمة cronExpression لمشغِّل لجدولة تنفيذ هذا المشغِّل.

يكون تعبير cron التنسيق التالي:

s
  m h dm m dw y

المكان:

الحقل	الوصف	مطلوبة	القيم المسموح بها	الأحرف الخاصة المسموح بها
`s`	الثواني	نعم	0-59	، - * /
`m`	الدقائق	نعم	0-59	، - * /
`h`	ساعات العمل	نعم	0-23	، - * /
`dm`	اليوم من الشهر	نعم	0-31	، - * ؟ / أسفل واط
`m`	الشهر	نعم	1-12 أو JAN-ديسمبر	، - * /
`dw`	اليوم من الأسبوع	نعم	من 1 إلى 7 أو من الأحد إلى السبت	، - * ؟ / L #
`y`	Year	لا	فارغ أو 1970-2099	، - * /

يتم تعريف الرموز الخاصة على النحو التالي:

رمز خاص	الوصف
*	يُستخدَم لتحديد جميع القيم داخل حقل. على سبيل المثال، * في حقل الدقائق تعني كل دقيقة.
?	تُستخدَم لتحديد عنصر في أحد الحقلَين اللذين يُسمح فيهما باستخدام الحرف، ولكن ليس في الآخر. على سبيل المثال، إذا كنت تريد تنفيذ المشغِّل في يوم معيّن من الشهر (على سبيل المثال، اليوم العاشر)، لكن لا تهتم بأي يوم من الأسبوع، حدِّد الرقم 10 في حقل اليوم من الشهر، و ؟ في حقل اليوم من الأسبوع.
-	يتم استخدامه لتحديد النطاقات. على سبيل المثال، تعني 10-12 في حقل الساعة الساعات 10 و11 و12.
,	يتم استخدامه لتحديد قيم إضافية. على سبيل المثال، يشير الاثنين والأربعاء والجمعة في حقل يوم الأسبوع إلى الأيام الاثنين والأربعاء والجمعة.
/	يُستخدَم لتحديد الزيادات. على سبيل المثال، يشير 0/15 في حقل الثواني إلى الثواني 0 و15 و30 و45. و5/15 في حقل الثواني تعني الثواني 5 و20 و35 و50. ويمكنك أيضًا تحديد / بعد الحرف ". يعادل ذلك وضع 0 قبل /. ويعني تحديد 1/3 في حقل "يوم من الشهر" التنفيذ كل 3 أيام بدءًا من اليوم الأول من الشهر.
L	يكون له معنى مختلف في كل حقل من الحقلين اللذين يُسمح بهما. يشير حرف L في حقل اليوم من الشهر إلى آخر يوم في الشهر، أي اليوم 31 لشهر كانون الثاني (يناير) أو اليوم 28 لشهر شباط (فبراير) في السنوات غير الكبيسة. في حقل يوم الأسبوع، يشير الحرف L إلى آخر يوم من الأسبوع، أي 7 أو SAT. أما إذا تم استخدامه في حقل يوم من الأسبوع بعد قيمة أخرى، فيعني آخر xxx يوم من الشهر. على سبيل المثال، تعني 6L يوم الجمعة الأخير من الشهر. ملاحظة: يمكن الجمع بين الحرفين L وW في حقلَي اليوم من الشهر لعرض LW، وهو ما يشير إلى آخر يوم من أيام الأسبوع.
واط	يُستخدم لتحديد يوم الأسبوع (من الاثنين إلى الجمعة) الأقرب من اليوم المحدد. على سبيل المثال، إذا حدّدت القيمة 15W في حقل "يوم من الشهر"، يعني ذلك أنّ أقرب يوم من الأسبوع إلى اليوم الخامس عشر من الشهر. ولذلك إذا كان اليوم الخامس عشر هو يوم السبت، فسيتم تنفيذ المشغِّل يوم الجمعة الموافق 14. أما إذا كان اليوم الخامس عشر هو يوم الأحد، فسيتم تنفيذ المشغِّل يوم الاثنين 16. أما إذا كان اليوم 15 هو يوم الثلاثاء، فسيتم تنفيذه يوم الثلاثاء 15. ومع ذلك، إذا حدّدت ساعة واحدة ليوم من الشهر، وكان اليوم الأول هو يوم السبت، سيتم تنفيذ المشغّل يوم الاثنين في الثالث لأنّه لن "يقفز" إلى حدّ أيام الشهر. لا يمكن تحديد الحرف W إلا عندما يكون أحد أيام الشهر يومًا واحدًا، وليس نطاقًا أو قائمة أيام. ملاحظة: يمكن الجمع بين الحرفين L وW في حقلَي اليوم من الشهر لعرض LW، وهو ما يشير إلى آخر يوم من أيام الأسبوع.
#	يُستخدم لتحديد ترتيب اليوم XXX من الشهر. على سبيل المثال، تعني القيمة 6#3 في حقل يوم الأسبوع يوم الجمعة الثالث من الشهر (اليوم 6 = الجمعة رقم 3 = اليوم الثالث في الشهر). أمثلة أخرى: 2#1 = أول اثنين من الشهر، 4#5 = خامس أربعاء من الشهر. ملاحظة: إذا حدّدت الرقم 5 ولم يكن هناك مثيل 5 من اليوم المحدد من الأسبوع في الشهر، لن تحدث أي عملية تنفيذ في ذلك الشهر.

فيما يلي بعض الأمثلة لتعبيرات cron (جميع الأوقات المدرجة بالتوقيت العالمي المنسق):

تعبير كرون	الجدول الزمني للتنفيذ
0 0 12 * * ؟	كل يوم الساعة 12 ظهرًا.
0 15 10 * * ? 2013	10:15 صباحًا كل يوم خلال عام 2013.
0 10,44 14 ؟ 3 أيام	الساعة 2:10 بعد الظهر و2:44 بعد الظهر كل أربعاء في شهر آذار (مارس).
0 15 10 ؟ * 6L من 2013 إلى 2015	الساعة 10:15 صباحًا في يوم الجمعة الأخير من كل شهر خلال الأعوام 2013 و2014 و2015.
0 15 10 ؟ * رقم 3	10:15 صباحًا يوم الجمعة الثالث من كل شهر.

عرض المهام المُجدوَلة باستخدام واجهة برمجة التطبيقات

يمكنك الاطّلاع على جميع المهام المُجدوَلة حاليًا من خلال إصدار طلب استرداد بيانات باستخدام GET إلى /triggers?orgid={org_name}.

مثلاً:

$ curl -H "Accept:application/json" -X GET \ "http://localhost:8080/v1/mint/triggers?orgid={org_name}" \ -u email:password

فيما يلي مثال على الرد:

[ {
  "createdDate" : 1457924378176,
  "cronExpression" : "3 0 0 * * ?",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server",
  "name" : "MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@management-server@@@DEFAULT",
  "priority" : "1",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.resetdeveloperrateplancounter@@@management"
  },
  "updatedDate" : 1457924378176
}, {
  "createdDate" : 1457924378014,
  "cronExpression" : "",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.ADHOC_NOTIFY@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.ADHOC_NOTIFY@@@management-server",
  "name" : "MINT.ADHOC_NOTIFY@@@management-server@@@DEFAULT",
  "priority" : "4",
  "startTime" : "1372916749000",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.adhocnotify@@@management"
  },
  "updatedDate" : 1457924378014
}, {
  "createdDate" : 1457924377877,
  "cronExpression" : "0 20 1 * * ?",
  "enabled" : true,
  "group" : "management-server",
  "id" : "MINT.CHARGE_DAILY@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
  "jobId" : "MINT.CHARGE_DAILY@@@management-server",
  "name" : "MINT.CHARGE_DAILY@@@management-server@@@DEFAULT",
  "priority" : "1",
  "suiteId" : "DEFAULT",
  "triggerDataMap" : {
    "custom_lock_key" : "mint.scheduler.__ORG_ID__.chargedaily@@@management"
  },
  "updatedDate" : 1457924377877
},
...
]

يمكنك أيضًا الاطّلاع على مهمة مُجدوَلة محدّدة من خلال إصدار طلب استرداد بيانات باستخدام GET إلى /triggers/{trig_id}، حيث يشير {trig_id} إلى تحديد عامل تشغيل الوظيفة، كما هو موضّح في القسم نظرة عامة على المهام المُجدوَلة. مثلاً:

$ curl -X GET \ "http://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT" \ -u email:password

فيما يلي مثال على الرد:

{
    "createdDate" : 1457924377925,
    "cronExpression" : "0 20 2 * * ?",
    "enabled" : true,
    "group" : "management-server",
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
    "updatedDate" : 1457924377925
}

جارٍ تعديل المهام المُجدوَلة باستخدام واجهة برمجة التطبيقات

يمكنك تعديل مهمة مُجدوَلة من خلال تغيير خصائص مشغِّلها. على سبيل المثال، قد تحتاج إلى تغيير الجدول الزمني للتنفيذ للعامل.

بالنسبة إلى مهام تشغيل cron (أي المهام التي تتضمّن قيمة تعبير cron)، يمكنك فقط تغيير قيم السمة cronExpression والسمات المفعّلة. ويتم تجاهل التغييرات الأخرى. بالنسبة إلى المهام التي لا تحدّد قيمة تعبير cron، يمكنك تغيير سمات أخرى مثل startTime أو priority.

لتعديل مهمة مُجدوَلة، عليك إرسال طلب PUT إلى /triggers/{trig_id}، حيث يشير الرمز {trig_id} إلى تحديد عامل تشغيل الوظيفة، كما هو موضّح في المقالة نظرة عامة على المهام المُجدوَلة. عند إجراء التحديث، عليك أن تحدّد في نص الطلب الإعدادات المعدَّلة ورقم تعريف المشغِّل.

على سبيل المثال، يعدِّل الطلب التالي تعبير cron لمهمة التجديد في خطة السعر الجديدة للمطوّرين، ليتم تنفيذها يوميًا في الساعة 5 صباحًا حسب التوقيت العالمي المنسَّق:

$ curl -H "Content-Type: application/json" -X PUT -d \
 '{
    "cronExpression" : "0 0 5 * * ?",
    "enabled" : true,
    "group" : "management-server", 
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
}' \
https://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT
\
-u email:password

إيقاف مهمة مُجدوَلة وإعادة تفعيلها باستخدام واجهة برمجة التطبيقات

لإيقاف مهمة مُجدوَلة، اضبط قيمة السمة enabled للمُشغِّل الخاص بها على "خطأ". مثلاً:

$ curl -H "Content-Type: application/json" -X PUT -d \
 '{
    "cronExpression" : "0 0 5 * * ?",
    "enabled" : false,
    "group" : "management-server",
    "id" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT",
    "jobId" : "MINT.RENEW_DEV_RATEPLAN@@@management-server",
    "name" : "MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT",
    "priority" : "1",
    "suiteId" : "DEFAULT",
    "triggerDataMap" : {
        "custom_lock_key" : "mint.scheduler.__ORG_ID__.renewydevrateplan@@@management"
    },
}' \
https://localhost:8080/v1/mint/triggers/MINT.RENEW_DEV_RATEPLAN@@@management-server@@@DEFAULT@@@management-server@@@DEFAULT
\
-u email:password

لإعادة تفعيل مهمة تم إيقافها، اضبط قيمة السمة enabled لمشغِّلها على "صحيح".

الخطوات التالية

كما يُنصح بإعادة المزامنة بشكل دوري مع ميزة تحقيق الربح في مؤسستك وأي مطوّرين وتطبيقات ومنتجات أنشأتها باستخدام خدمات Edge API. تعرَّف على كيفية إجراء ذلك في مزامنة بيانات Apigee Edge مع تحقيق الربح.