کارهای کسب درآمد را برنامه ریزی کنید

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید .
اطلاعات

مرور کلی کارهای برنامه‌ریزی‌شده

کسب درآمد، یک برنامه‌ریز کار و مجموعه‌ای از کارها را فراهم می‌کند که از قبل برای اجرا در زمان‌های تعیین‌شده برنامه‌ریزی شده‌اند.

جدول زیر، کارهای از پیش برنامه‌ریزی‌شده‌ی ارائه‌شده توسط کسب درآمد و زمان‌هایی که برای اجرای آنها برنامه‌ریزی شده است را فهرست می‌کند (تمام زمان‌های ذکر شده بر حسب UTC هستند). همچنین، زمان شروع هر کار نیز ذکر شده است.

شغل توضیحات برنامه زمانی (UTC) ماشه
نرخ مالیات ماهانه توسعه‌دهنده نرخ مالیات را از موتور مالیات برای هر توسعه‌دهنده دریافت می‌کند و نهاد توسعه‌دهنده را با نرخ مالیات اصلاح‌شده به‌روزرسانی می‌کند. اولین روز هر ماه ساعت ۵:۴۵ صبح MINT.MONTHLY_DEV_TAXRATE@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
تمدید اشتراک هزینه‌های دوره‌ای را برای طرح‌های نرخ فعال یا هزینه‌های جدید را برای طرح‌های نرخ آینده که از روز جاری شروع می‌شوند، اعمال می‌کند. هر روز ساعت ۵ ثانیه بعد از نیمه شب MINT.RENEW_SUBSCRIPTIONS@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
به‌روزرسانی XeFeed نرخ تبدیل هر ارز پشتیبانی‌شده را به دلار آمریکا دریافت می‌کند. هر روز، ساعت ۱ ثانیه بعد از نیمه شب MINT.XEFEED@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
تمدید طرح نرخ توسعه‌دهنده تاریخ‌های تمدید برای یک طرح تعرفه‌ای را تغییر می‌دهد و هزینه‌های فسخ زودهنگام را محاسبه می‌کند. هر روز ساعت ۲:۲۰ بامداد MINT.RENEW_DEV_RATEPLAN@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
رله‌ی تراکنش را دوباره امتحان کنید توجه : این شغل منسوخ شده است و هیچ تاثیری بر کسب درآمد ندارد. هر روز ساعت ۴:۳۰ صبح MINT.RETRY_TX_RELAY@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
پاک‌کننده تراکنش توجه : این شغل منسوخ شده است و هیچ تاثیری بر کسب درآمد ندارد. هر روز ساعت ۵:۳۰ صبح MINT.TX_CLEANSER@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
حسابرسی موجودی توسعه‌دهنده موجودی حساب توسعه‌دهنده را حسابرسی می‌کند. میزان مصرف فعلی و موجودی پیش‌پرداخت/حد اعتبار پس‌پرداخت را در یک جدول حسابرسی کپی می‌کند، سپس میزان مصرف فعلی را از حساب توسعه‌دهنده کسر می‌کند و موجودی مصرف را به صفر برمی‌گرداند. اولین روز هر ماه، ساعت ۵ ثانیه از نیمه‌شب MINT.DEVELOPER_BALANCE_AUDIT@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
اسناد صورتحساب ماهانه اسناد صورتحساب را تولید می‌کند.

توجه: Apigee دیگر از تولید اسناد صورتحساب از Apigee Edge Monetization پشتیبانی نمی‌کند. به بخش بازنشستگی‌ها مراجعه کنید.

یازدهمین روز هر ماه، ساعت ۱ دقیقه بعد از نیمه شب MINT.MONTLY_BILLING_DOCS@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
پیشخوان طرح نرخ توسعه دهنده توجه : این شغل منسوخ شده است و هیچ تاثیری بر کسب درآمد ندارد. هر روز ساعت ۳ ثانیه بعد از نیمه شب MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
هزینه‌های روزانه تمام مجموع تراکنش‌های ساعتی را دوباره محاسبه می‌کند و از آنها برای محاسبه مجموع روزانه روز قبل استفاده می‌کند. هر روز ساعت ۱:۲۰ بامداد 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

علاوه بر مشاغل ذکر شده در بالا، مشاغلی وجود دارند که می‌توانید از طریق اعلان‌های رویداد فعال کنید، همانطور که در جدول زیر آمده است. برای اطلاعات بیشتر، به تنظیم اعلان‌ها مراجعه کنید.

شغل توضیحات برنامه ماشه
اعلان بسته جدید به همه توسعه‌دهندگان اعلانی مبنی بر موجود بودن بسته API جدید ارسال می‌کند. یک بار اجرا می‌شود — در روزی که کار در ساعت ۹ شب فعال می‌شود

توجه : اعلان‌ها فقط یک بار ارسال می‌شوند، صرف نظر از اینکه آیا cronExpression طوری پیکربندی کرده‌اید که منجر به اجرای چندین باره‌ی کار شود یا خیر.

MINT.NEW_PACKAGE_NOTIFY@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
اعلان ویژه جدید به همه توسعه‌دهندگان اعلانی ارسال می‌کند مبنی بر اینکه محصولات API جدید در بازارهای جغرافیایی خاص در دسترس هستند. یک بار اجرا می‌شود — در روزی که کار در ساعت ۹ شب فعال می‌شود

توجه : اعلان‌ها فقط یک بار ارسال می‌شوند، صرف نظر از اینکه آیا cronExpression طوری پیکربندی کرده‌اید که منجر به اجرای چندین باره‌ی کار شود یا خیر.

MINT.ADHOC_NOTIFY@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
اطلاع رسانی محصول جدید به همه توسعه‌دهندگان اعلانی مبنی بر موجود بودن یک محصول API جدید ارسال می‌کند. یک بار اجرا می‌شود — در روزی که کار در ساعت ۹ شب فعال می‌شود

توجه : اعلان‌ها فقط یک بار ارسال می‌شوند، صرف نظر از اینکه آیا cronExpression طوری پیکربندی کرده‌اید که منجر به اجرای چندین باره‌ی کار شود یا خیر.

MINT.NEW_PRODUCT_NOTIFY@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
اطلاعیه طرح نرخ جدید

به توسعه‌دهندگانی که تحت تأثیر قرار گرفته‌اند، اعلانی مبنی بر در دسترس بودن طرح نرخ جدید ارسال می‌کند. به همه توسعه‌دهندگانی که در طرح نرخ والد مشترک شده‌اند، اطلاع داده می‌شود که طرح نرخ جدید فعال است.

علاوه بر این:

  • اگر طرح تعرفه، یک طرح استاندارد باشد، به همه توسعه‌دهندگان اطلاع داده خواهد شد.
  • اگر این طرح مربوط به دسته‌بندی توسعه‌دهندگان باشد، فقط توسعه‌دهندگان آن دسته‌بندی مطلع خواهند شد.
  • اگر این یک طرح تعرفه توسعه‌دهنده باشد، فقط به آن توسعه‌دهنده خاص اطلاع داده می‌شود.
در تاریخ شروع طرح تعرفه جدید، ساعت ۴:۳۰ صبح، اجرا می‌شود MINT.NEW_RATEPLAN_NOTIFY@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
شرکت جدید TNC اعلانی به توسعه‌دهندگان آسیب‌دیده ارسال می‌کند مبنی بر اینکه شرایط و ضوابط جدید یا اصلاح‌شده منتشر شده‌اند (و توسعه‌دهنده هنوز آنها را نپذیرفته است). ۳۰، ۷ و ۱ روز قبل از تاریخ شروع شرایط و ضوابط جدید یا اصلاح‌شده، ساعت ۹ شب اجرا می‌شود MINT.TNC_ACCEPTANCE_NOTIFY@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT
طرح نرخ منقضی شده اعلانی را برای توسعه‌دهندگان آسیب‌دیده ارسال می‌کند تا از قبل هشدار دهد که طرح تعرفه در حال منقضی شدن است. ۳۰، ۷ و ۱ روز قبل از انقضای طرح نرخ، ساعت ۹ شب اجرا می‌شود MINT.EXPIRING_RATE_PLAN_NOTIFY@@@
management-server@@@DEFAULT@@@
management-server@@@DEFAULT

مدیریت برنامه کاری کسب درآمد با استفاده از API

بخش‌های زیر نحوه مدیریت برنامه کاری کسب درآمد با استفاده از API را شرح می‌دهند:

برای اطلاعات بیشتر در مورد API های شرح داده شده در این بخش، به بخش کارهای زمان‌بندی شده در مرجع API مراجعه کنید.

پیکربندی تریگرها

زمانبند برای اجرای کارها به تریگرها (فعال‌کننده‌ها) متکی است. یک کار زمان‌بندی‌شده زمانی اجرا می‌شود که تریگر مرتبط با آن اجرا شود. ویژگی‌های یک تریگر، اجرای کار را پیکربندی می‌کند و با تنظیم مقدار این ویژگی‌ها می‌توانید ویژگی‌های اجرای کار مانند زمان و تعداد دفعات اجرای کار را کنترل کنید.

دو نوع رایج از تریگرها، تریگرهای cron و تریگرهای ساده هستند. تریگر cron دارای ویژگی cronExpression است که برنامه اجرا را مشخص می‌کند. تریگر ساده دارای ویژگی cronExpression نیست؛ شما startTime برای نشان دادن زمان شروع فعال شدن تریگر و به صورت اختیاری endTime مشخص می‌کنید.

ویژگی‌های تریگر به شرح زیر است (تمام زمان‌های ذکر شده بر حسب UTC هستند):

ملک توضیحات
cronExpression عبارت Cron برای ایجاد یک برنامه اجرایی برای تریگر، مانند: "ساعت ۸:۰۰ صبح هر دوشنبه تا جمعه" یا "ساعت ۱:۳۰ بامداد هر جمعه آخر ماه". برای جزئیات بیشتر به بخش ساخت عبارات cron مراجعه کنید.

تعیین این ویژگی، تریگر را به عنوان یک تریگر cron تعریف می‌کند.

نکته : اگر هر دو cronExpression و startTime / endTime مشخص شده باشند، cronExpression اولویت دارد.

enabled پرچمی که نشان می‌دهد آیا تریگر برای اجرا فعال شده است یا خیر. مقدار آن می‌تواند یکی از موارد زیر باشد:
  • true . ماشه برای اجرا فعال شده است.
  • false . تریگر غیرفعال است - اجرا نخواهد شد.
endTime زمان در قالب دوره زمانی که برنامه‌ی ماشه دیگر مؤثر نیست.
group نوع سروری که trigger در آن اجرا خواهد شد. برای مثال، اگر قرار است trigger در یک سرور مدیریت اجرا شود، مقدار آن باید روی management-server تنظیم شود. اگر قرار است trigger در یک سرور پردازش پیام اجرا شود، مقدار آن باید روی message-processor تنظیم شود.
id شناسایی عامل محرک.
jobId شناسایی کاری که باید انجام شود.
name نام منحصر به فردی که برای شناسایی تریگر استفاده می‌شود.
priority اولویت اجرای نسبی تریگرها در صورتی که چندین تریگر قرار است همزمان اجرا شوند. هرچه مقدار کمتر باشد، اولویت بالاتر است. برای مثال، اگر قرار است دو تریگر همزمان اجرا شوند و اگر یکی از تریگرها اولویت ۱ و دیگری اولویت ۲ داشته باشد، تریگری که اولویت ۱ دارد ابتدا اجرا می‌شود.

این ویژگی فقط در صورتی اعمال می‌شود که چندین تریگر دقیقاً زمان اجرای یکسانی داشته باشند.

startTime فقط برای تریگرهای ساده اعمال می‌شود.

زمانی در قالب دوره زمانی که برنامه‌ی ماشه اعمال می‌شود.

نکته : اگر هر دو cronExpression و startTime / endTime مشخص شده باشند، cronExpression اولویت دارد.

suiteId پرچمی که مشخص می‌کند آیا اعلان، بخشی از مجموعه اعلان‌های سطح سیستم است یا سطح پیش‌فرض. مقادیر معتبر DEFAULT یا SYSTEM هستند، یا می‌توانید نام مجموعه منحصر به فرد خود را مشخص کنید.
triggerDataMap کلید قفل، custom_lock_key ، که از اجرای همزمان یک کار توسط چندین سرور جلوگیری می‌کند.

ساخت عبارات کرون

یک عبارت cron رشته‌ای است که شامل شش یا هفت فیلد است که با فاصله از هم جدا شده‌اند. این عبارت مجموعه‌ای از زمان‌ها را نشان می‌دهد، معمولاً به عنوان یک برنامه برای اجرای یک روال. عبارات cron که در ویژگی cronExpression یک trigger مشخص شده‌اند، برای زمان‌بندی اجرای آن trigger استفاده می‌شوند.

یک عبارت cron دارای قالب زیر است: s mh dm m dw y

کجا:

میدان توضیحات مورد نیاز مقادیر مجاز کاراکترهای ویژه مجاز
s ثانیه‌ها بله ۰-۵۹ ، - * /
m دقیقه بله ۰-۵۹ ، - * /
h ساعت‌ها بله ۰-۲۳ ، - * /
dm روز ماه بله ۰-۳۱ ، - * ? / طول موج
m ماه بله ۱-۱۲ یا ژانویه-دسامبر ، - * /
dw روز هفته بله ۱-۷ یا یکشنبه-شنبه ، - * ? / L #
y سال خیر خالی یا ۱۹۷۰-۲۰۹۹ ، - * /

کاراکترهای ویژه به صورت زیر تعریف می‌شوند:

شخصیت ویژه توضیحات
* برای انتخاب تمام مقادیر درون یک فیلد استفاده می‌شود. برای مثال، * در فیلد دقیقه به معنی هر دقیقه است.
? برای مشخص کردن چیزی در یکی از دو فیلدی که کاراکتر در آن مجاز است، اما در فیلد دیگر مجاز نیست، استفاده می‌شود. برای مثال، اگر می‌خواهید تریگر در یک روز خاص از ماه (مثلاً دهم) اجرا شود، اما برایتان مهم نیست چه روزی از هفته باشد، در فیلد روز ماه عدد ۱۰ و در فیلد روز هفته علامت ؟ را مشخص کنید.
- برای مشخص کردن محدوده‌ها استفاده می‌شود. برای مثال، ۱۰-۱۲ در فیلد ساعت به معنی ساعت‌های ۱۰، ۱۱ و ۱۲ است.
، برای تعیین مقادیر اضافی استفاده می‌شود. برای مثال، MON،WED،FRI در فیلد روز هفته به معنی روزهای دوشنبه، چهارشنبه و جمعه است.
/ برای مشخص کردن افزایش‌ها استفاده می‌شود. برای مثال، 0/15 در فیلد ثانیه به معنی ثانیه‌های 0، 15، 30 و 45 است. و 5/15 در فیلد ثانیه به معنی ثانیه‌های 5، 20، 35 و 50 است. همچنین می‌توانید / را بعد از کاراکتر " مشخص کنید. انجام این کار معادل قرار دادن 0 قبل از / است. مشخص کردن 1/3 در فیلد روز ماه به معنی اجرا هر 3 روز یکبار از روز اول ماه است.
ل در هر یک از دو فیلدی که مجاز است، معنای متفاوتی دارد. L در فیلد روز ماه به معنای آخرین روز ماه است، یعنی روز ۳۱ برای ژانویه، یا روز ۲۸ برای فوریه در سال‌های غیر کبیسه. در فیلد روز هفته، L به معنای آخرین روز هفته است، یعنی ۷ یا SAT. اما اگر در فیلد روز هفته بعد از مقدار دیگری استفاده شود، به معنای آخرین روز xxx ماه است. به عنوان مثال، ۶L به معنای آخرین جمعه ماه است.
دبلیو برای مشخص کردن نزدیکترین روز هفته (دوشنبه تا جمعه) به روز داده شده استفاده می‌شود. به عنوان مثال، اگر در فیلد روز ماه، عدد ۱۵W را مشخص کنید، به معنای نزدیکترین روز هفته به پانزدهم ماه است. بنابراین اگر پانزدهم، شنبه باشد، تریگر در جمعه چهاردهم اجرا می‌شود. اگر پانزدهم، یکشنبه باشد، تریگر در دوشنبه شانزدهم اجرا می‌شود. اگر پانزدهم، سه‌شنبه باشد، در سه‌شنبه پانزدهم اجرا می‌شود. با این حال، اگر ۱W را برای روز ماه مشخص کنید و اول، شنبه باشد، تریگر در دوشنبه سوم اجرا می‌شود زیرا از مرز روزهای یک ماه «پرش» نمی‌کند. کاراکتر W فقط زمانی قابل تعیین است که روز ماه، یک روز واحد باشد، نه یک محدوده یا لیستی از روزها.
# برای مشخص کردن nامین روز XXX ماه استفاده می‌شود. برای مثال، مقدار 6#3 در فیلد روز هفته به معنای سومین جمعه ماه است (روز 6 = جمعه و #3 = سومین روز در ماه). مثال‌های دیگر: 2#1 = اولین دوشنبه ماه، 4#5 = پنجمین چهارشنبه ماه.

در اینجا چند نمونه از عبارات cron آورده شده است (تمام زمان‌های ذکر شده بر حسب UTC هستند):

عبارت کرون برنامه اجرا
۰ ۰ ۱۲ * * ? هر روز ساعت ۱۲ ظهر (ظهر).
۰ ۱۵ ۱۰ * * ? ۲۰۱۳ ساعت ۱۰:۱۵ صبح هر روز در طول سال ۲۰۱۳.
۰ ۱۰،۴۴ ۱۴ ? ۳ چهارشنبه ساعت ۱۴:۱۰ و ۱۴:۴۴ هر چهارشنبه در ماه مارس.
۰ ۱۵ ۱۰ ؟ * ۶ لیتر ۲۰۱۳-۲۰۱۵ ساعت ۱۰:۱۵ صبح، آخرین جمعه هر ماه در طول سال‌های ۲۰۱۳، ۲۰۱۴ و ۲۰۱۵.
۰ ۱۵ ۱۰ ? * ۶#۳ ساعت ۱۰:۱۵ صبح، جمعه سوم هر ماه.

مشاهده کارهای زمان‌بندی‌شده با استفاده از API

شما می‌توانید با ارسال یک درخواست 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
}

به‌روزرسانی کارهای زمان‌بندی‌شده با استفاده از API

شما می‌توانید یک کار زمان‌بندی‌شده را با تغییر ویژگی‌های تریگر آن به‌روزرسانی کنید. برای مثال، ممکن است لازم باشد برنامه‌ی اجرای تریگر را تغییر دهید.

برای کارهای فعال‌کننده‌ی cron (یعنی کارهایی که شامل مقدار عبارت cron هستند)، فقط می‌توانید مقادیر ویژگی‌های cronExpression و enabled را تغییر دهید. سایر تغییرات نادیده گرفته می‌شوند. برای کارهایی که مقدار عبارت cron را مشخص نمی‌کنند، می‌توانید ویژگی‌های دیگری مانند startTime یا priority را تغییر دهید.

برای به‌روزرسانی یک کار زمان‌بندی‌شده، یک درخواست PUT به /triggers/{trig_id} ارسال کنید، که در آن {trig_id} شناسه‌ی تریگر کار است، همانطور که در مرور کلی کارهای زمان‌بندی‌شده توضیح داده شده است. هنگام انجام به‌روزرسانی، باید در بدنه‌ی درخواست، تنظیمات به‌روزرسانی‌شده و شناسه‌ی تریگر را مشخص کنید.

برای مثال، درخواست زیر عبارت cron مربوط به کار تمدید طرح نرخ توسعه‌دهندگان جدید را به‌روزرسانی می‌کند تا هر روز ساعت ۵ صبح به وقت جهانی اجرا شود:

$ 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

غیرفعال کردن و فعال کردن مجدد یک کار زمان‌بندی شده با استفاده از API

برای غیرفعال کردن یک کار زمان‌بندی‌شده، مقدار ویژگی enabled مربوط به تریگر آن را روی false تنظیم کنید. برای مثال:

$ 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 مربوط به تریگر آن را روی true تنظیم کنید.

مراحل بعدی

توصیه می‌شود که به صورت دوره‌ای، سازمان خود و هر توسعه‌دهنده، برنامه و محصولی را که با استفاده از خدمات API Edge ایجاد کرده‌اید، با کسب درآمد دوباره همگام‌سازی کنید. نحوه‌ی انجام این کار را در بخش «همگام‌سازی داده‌های Apigee Edge با کسب درآمد» بیاموزید.