Planowanie zadań generowania przychodu

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

Omówienie zaplanowanych zadań

Funkcja generowania przychodu udostępnia harmonogram zadań i zestaw zadań z wstępnym harmonogramem, które mają zostać wykonane w określonym czasie.

W tabeli poniżej znajdziesz wstępnie zaplanowane zadania wykonywane w ramach funkcji zarabiania oraz terminy ich realizacji jest zaplanowane (wszystkie godziny są podane w czasie UTC). Na liście znajduje się też aktywator każdego zadania.

Oprócz wymienionych powyżej zadań możesz też włączyć te zadania przez zdarzenie. powiadomień, jak podano w poniższej tabeli. Więcej informacji znajdziesz w artykule Konfigurowanie powiadomień.

Zarządzanie harmonogramem zadań związanych z generowaniem przychodu za pomocą interfejsu API

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

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

Więcej informacji o interfejsach API opisanych w tej sekcji znajdziesz w artykule Zaplanowane zadania w interfejsie API. odwołania.

Konfigurowanie aktywatorów

Algorytm szeregowania wykorzystuje aktywatory do wykonywania zadań. Zaplanowane zadanie jest wykonywane, gdy jest powiązane . Właściwości aktywatora określają wykonywanie zadania, a przez ustawienie wartości pozwalają określić właściwości wykonania zadania, np. kiedy i częstotliwość ich uruchamiania.

Dwa najpopularniejsze typy aktywatorów to reguły cron i reguły proste reguły. Aktywator cron ma właściwość cronExpression, która określa w harmonogramie wykonywania zadań. Prosta reguła nie ma właściwości cronExpression. Ty i określ startTime, aby wskazać, kiedy reguła zostanie zastosowana; (opcjonalnie) endTime.

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

Tworzenie wyrażeń cron

Wyrażenie cron to ciąg znaków zawierający 6 lub 7 pól rozdzielonych spacją. reprezentuje zestaw czasów, zwykle jako harmonogram wykonywania rutyny. cron wyrażenia określone we właściwości cronExpression aktywatora aby zaplanować wykonanie tego aktywatora.

Gdzie:

Znaki specjalne są następujące:

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

Wyświetlanie zaplanowanych zadań przy użyciu interfejsu API

Aby wyświetlić wszystkie aktualnie zaplanowane zadania, wyślij żądanie GET do /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 takiej 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 zadania aktywator, jak opisano w sekcji Przegląd 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 takiej 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ń przy użyciu interfejsu API

Zaplanowane zadanie możesz zaktualizować, zmieniając właściwości jego aktywatora. Na przykład: może być konieczna zmiana harmonogramu wykonywania aktywatora.

W przypadku zadań aktywatorów cron (czyli zadań, które zawierają wartość wyrażenia cron) możesz tylko zmień wartości cronExpression i włączonych właściwości. Pozostałe zmiany: zignorowano. W przypadku zadań, które nie mają określonej wartości wyrażenia cron, możesz zmienić inne właściwości na przykład startTime lub priority.

Aby zaktualizować zaplanowane zadanie, wyślij żądanie PUT do zadania /triggers/{trig_id}, gdzie {trig_id} to identyfikator aktywatora zadania, zgodnie z opisem w sekcji Omówienie zaplanowanych zadań. Wprowadzając aktualizację, w sekcji treść żądania zaktualizowane ustawienia oraz identyfikator aktywatora.

Na przykład to żądanie aktualizuje wyrażenie cron na potrzeby nowego abonamentu dla programistów Zadanie odnowienia każdego dnia 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 przy użyciu interfejsu API

Aby wyłączyć zaplanowane zadanie, ustaw wartość właściwości enabled jego aktywatora na false (fałsz). 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 aktywatora na true (prawda).

Dalsze kroki

Zaleca się co jakiś czas synchronizowanie danych organizacji z danymi dotyczącymi zarabiania programistów, aplikacji i usług utworzonych przez Ciebie przy użyciu usług interfejsu Edge API. Więcej informacji: Synchronizuj Dane Apigee Edge z monetyzacją.