Monetarisierungsjobs planen

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation. Weitere Informationen

Übersicht über geplante Jobs

Die Monetarisierung bietet einen Jobplaner und eine Reihe von Jobs, deren Ausführung vorab geplant wurde. zu bestimmten Zeiten.

In der folgenden Tabelle sind die vorgeplanten Jobs, die durch die Monetarisierung bereitgestellt werden, und die Zeiten aufgeführt, zu denen sie geplante Ausführung (alle Zeiten sind in UTC angegeben). Außerdem wird der Trigger für jeden Job aufgeführt.

Zusätzlich zu den oben aufgeführten Jobs gibt es Jobs, die Sie über Ereignisse Benachrichtigungen, wie in der folgenden Tabelle aufgeführt. Weitere Informationen finden Sie unter Benachrichtigungen einrichten.

Zeitplan für Monetarisierungsjobs mithilfe der API verwalten

In den folgenden Abschnitten wird beschrieben, wie Sie den Zeitplan für Monetarisierungsjobs mithilfe der API verwalten:

• Trigger konfigurieren
• Cron-Ausdrücke erstellen
• Geplante Jobs mit der API ansehen
• Geplante Jobs mit der API aktualisieren
• Deaktivieren und Reaktivieren eines geplanten Jobs mithilfe der API

Weitere Informationen zu den in diesem Abschnitt beschriebenen APIs finden Sie unter Geplante Jobs in der API. Referenz.

Trigger konfigurieren

Der Planer benötigt Trigger, um Jobs auszuführen. Ein geplanter Job wird ausgeführt, wenn der zugehörige ausgeführt wird. Die Attribute eines Triggers konfigurieren die Jobausführung und legen die können Sie die Eigenschaften der Jobausführung steuern, z. B. wann ein Job und wie oft ausgeführt wird.

Die beiden häufigsten Triggertypen sind Cron-Trigger und einfache Trigger. Trigger. Ein Cron-Trigger hat ein cronExpression-Attribut, das eine des Ausführungszeitplans. Ein einfacher Trigger hat kein cronExpression-Attribut. ich legen Sie startTime fest, um anzugeben, wann der Trigger in Kraft tritt, und optional den endTime.

Es gibt folgende Triggereigenschaften (alle Zeiten sind in UTC angegeben):

Cron-Ausdrücke erstellen

Ein Cron-Ausdruck ist ein String, der aus sechs oder sieben Feldern besteht, die durch Leerzeichen getrennt sind. Die expression steht für eine Reihe von Zeiten, normalerweise als Zeitplan zur Ausführung einer Routine. Cron Ausdrücke, die im Attribut cronExpression eines Triggers angegeben sind, werden verwendet um die Ausführung dieses Triggers zu planen.

Wobei:

Die Sonderzeichen sind wie folgt definiert:

Hier einige Beispiele für Cron-Ausdrücke (alle Zeiten sind in UTC angegeben):

Geplante Jobs mit der API aufrufen

Sie können alle derzeit geplanten Jobs anzeigen, indem Sie eine GET-Anfrage an /triggers?orgid={org_name}

Beispiel:

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

Im Folgenden finden Sie ein Beispiel für die Antwort:

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

Sie können einen bestimmten geplanten Job auch anzeigen, indem Sie eine GET-Anfrage an /triggers/{trig_id}, wobei {trig_id} die Identifizierung des Jobs ist erstellen, wie unter Übersicht über geplante Jobs beschrieben. Beispiel:

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

Im Folgenden finden Sie ein Beispiel für die Antwort:

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

Geplante Jobs mit der API aktualisieren

Sie können einen geplanten Job aktualisieren, indem Sie die Attribute seines Triggers ändern. Zum Beispiel haben Sie muss möglicherweise den Ausführungszeitplan des Triggers ändern.

Für Cron-Triggerjobs (d. h. Jobs, die einen Cron-Ausdruckswert enthalten) können Sie nur Ändern Sie die Werte von cronExpression und aktivierten Properties. Weitere Änderungen sind ignoriert. Für Jobs, für die kein Cron-Ausdruckswert angegeben ist, können Sie andere Attribute ändern wie startTime oder priority.

Um einen geplanten Job zu aktualisieren, senden Sie eine PUT-Anfrage an /triggers/{trig_id}, wobei {trig_id} die Identifizierung des Job-Triggers ist, wie unter Übersicht über geplante Jobs beschrieben. Bei der Aktualisierung müssen Sie im Feld request body die aktualisierten Einstellungen und die ID des Triggers.

Mit der folgenden Anfrage wird beispielsweise der Cron-Ausdruck für den neuen Entwicklerpreisplan aktualisiert Verlängerungsjob, der täglich um 5:00 Uhr ausgeführt wird. 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

Geplante Jobs über die API deaktivieren und wieder aktivieren

Wenn Sie einen geplanten Job deaktivieren möchten, setzen Sie den Attributwert enabled seines Triggers auf false festlegen. Beispiel:

$ 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

Wenn Sie einen deaktivierten Job wieder aktivieren möchten, legen Sie den Attributwert enabled seines Triggers auf true fest.

Nächste Schritte

Es wird empfohlen, die Monetarisierungsstrategie für Ihre Organisation und alle Entwickler, Anwendungen und Produkte, die Sie mit Edge API-Diensten erstellt haben. Weitere Informationen unter Synchronisieren Apigee Edge-Daten mit Monetarisierung.