Planowanie zadań generowania przychodu

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

Przegląd zaplanowanych zadań

Monetyzacja udostępnia harmonogram zadań i zestaw zadań, które są wstępnie zaplanowane do uruchamiania w określonych godzinach.

W tabeli poniżej znajdziesz listę wstępnie zaplanowanych zadań związanych z zarabianiem oraz godziny, w których są one zaplanowane (wszystkie godziny są podane w czasie UTC). Podany jest też wyzwalacz każdego zadania.

Oprócz zadań wymienionych powyżej istnieją zadania, które możesz włączyć za pomocą powiadomień o zdarzeniach, jak pokazano w tabeli poniżej. Więcej informacji znajdziesz w artykule Konfigurowanie powiadomień.

Zarządzanie harmonogramem zadań zarabiania za pomocą interfejsu API

W sekcjach poniżej opisujemy, jak zarządzać harmonogramem zadań związanych z zarabianiem za pomocą interfejsu API:

• Konfigurowanie reguł
• Tworzenie wyrażeń cron
• Wyświetlanie zaplanowanych zadań za pomocą interfejsu API
• Aktualizowanie zaplanowanych zadań za pomocą interfejsu API
• Wyłączanie i ponowne włączanie zaplanowanego zadania za pomocą interfejsu API

Więcej informacji o interfejsach API opisanych w tej sekcji znajdziesz w dokumentacji interfejsu API w sekcji Zaplanowane zadania.

Konfigurowanie aktywatorów

Algorytm szeregowania polega na aktywatorach, które wykonują zadania. Zaplanowane zadanie jest wykonywane, gdy uruchamiany jest powiązany z nim wyzwalacz. Właściwości wyzwalacza konfigurują wykonanie zadania, a ustawiając wartość tych właściwości, możesz kontrolować cechy wykonania zadania, takie jak czas i częstotliwość jego wykonywania.

Dwa najpopularniejsze typy aktywatorów to aktywatory cron i proste aktywatory. Wyrażenie CRON ma właściwość cronExpression, która określa harmonogram wykonywania. Prosty aktywator nie ma właściwości cronExpression. Aby określić, kiedy aktywator ma zacząć działać, podaj właściwość startTime, a opcjonalnie – właściwość endTime.

Właściwości wyzwalacza są następujące (wszystkie podane godziny są w czasie UTC):

Tworzenie wyrażeń cron

Wyrażenie cron to ciąg znaków składający się z 6 lub 7 pól oddzielonych białymi znakami. Wyrażenie reprezentuje zestaw godzin, zwykle w formie harmonogramu wykonywania rutyny. Wyrażenia cron określone we właściwości cronExpression reguły są używane do planowania wykonania tej reguły.

Gdzie:

Znaki specjalne są zdefiniowane w ten sposób:

Oto kilka przykładów wyrażeń cron (wszystkie podane czasy są w strefie czasowej UTC):

Wyświetlanie zaplanowanych zadań za pomocą interfejsu API

Wszystkie aktualnie zaplanowane zadania możesz wyświetlić, wysyłając żądanie GET do strony /triggers?orgid={org_name}.

Na przykład:

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

Oto przykład odpowiedzi:

[ {
  "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
},
...
]

Możesz też wyświetlić konkretne zaplanowane zadanie, wysyłając żądanie GET do /triggers/{trig_id}, gdzie {trig_id} to identyfikator wyzwalacza zadania, zgodnie z opisem w omówieniu zaplanowanych zadań. Na przykład:

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

Oto przykład odpowiedzi:

{
    "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
}

Aktualizowanie zaplanowanych zadań za pomocą interfejsu API

Zaplanowane zadanie możesz zaktualizować, zmieniając właściwości jego wyzwalacza. Może na przykład zajść potrzeba zmiany harmonogramu wykonywania aktywatora.

W przypadku zadań wywoływanych przez crona (czyli zadań, które zawierają wartość wyrażenia cron) możesz zmieniać tylko wartości właściwości cronExpression i enabled. Pozostałe zmiany są ignorowane. W przypadku zadań, które nie określają wartości wyrażenia cron, możesz zmienić inne właściwości, takie jak startTime lub priority.

Aby zaktualizować zaplanowane zadanie, wyślij żądanie PUT do /triggers/{trig_id}, gdzie {trig_id} to identyfikator reguły zadania, zgodnie z opisem w omówieniu zaplanowanych zadań. Gdy wprowadzisz zmianę, musisz w treści żądania podać zaktualizowane ustawienia i identyfikator aktywatora.

Na przykład to żądanie aktualizuje wyrażenie cron dla zadania odnowienia nowego planu cenowego dla deweloperów, aby było ono uruchamiane codziennie o 5:00 UTC:

$ 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

Wyłączanie i ponowne włączanie zaplanowanego zadania za pomocą interfejsu API

Aby wyłączyć zaplanowane zadanie, ustaw wartość właściwości enabled jego wyzwalacza na false. Na przykład:

$ 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

Aby ponownie włączyć wyłączone zadanie, ustaw wartość właściwości enabled jego wyzwalacza na true.

Dalsze kroki

Zalecamy okresowe ponowne synchronizowanie z monetyzacją organizacji oraz wszystkich programistów, aplikacji i produktów utworzonych za pomocą usług API Edge. Dowiedz się, jak synchronizować dane Apigee Edge z danymi o przychodach.