Pianificare job di monetizzazione

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X. Informazioni

Panoramica dei job pianificati

La monetizzazione fornisce un programma di pianificazione dei job e una serie di job pre-programmati per l'esecuzione e orari designati.

Nella tabella seguente sono elencati i lavori preprogrammati forniti dalla monetizzazione e gli orari in cui vengono pianificata per l'esecuzione (tutti gli orari indicati sono nel fuso orario UTC). Viene indicato anche il trigger per ogni job.

Oltre ai job elencati sopra, esistono job che puoi abilitare tramite evento di notifica, come indicato nella tabella seguente. Per ulteriori informazioni, vedi Configurare le notifiche.

Gestione della pianificazione del job di monetizzazione tramite l'API

Le seguenti sezioni descrivono come gestire la pianificazione del job di monetizzazione utilizzando l'API:

• Configurare i trigger
• Creazione di espressioni cron
• Visualizzazione dei job pianificati utilizzando l'API
• Aggiornare i job pianificati utilizzando l'API
• Disattivare e riattivare un job pianificato utilizzando il dell'API

Per ulteriori informazioni sulle API descritte in questa sezione, consulta Job pianificati nell'API. riferimento.

Configurazione dei trigger

Lo scheduler si basa sui trigger per l'esecuzione dei job. Un job pianificato viene eseguito quando è associato del trigger. Le proprietà di un trigger configurano l'esecuzione del job e impostano di queste proprietà, puoi controllare le caratteristiche dell'esecuzione del job, ad esempio vengono eseguiti e con quale frequenza.

I due tipi più comuni di trigger sono cron trigger e semplici trigger. Un trigger cron ha una proprietà cronExpression che specifica un la pianificazione dell'esecuzione. Un attivatore semplice non ha una proprietà cronExpression. tu specificare startTime per indicare quando l'attivatore entra in vigore e facoltativamente il endTime.

Le proprietà dell'attivatore sono le seguenti (tutti gli orari sono nel fuso orario UTC):

Creazione di espressioni cron

Un'espressione cron è una stringa contenente sei o sette campi separati da uno spazio. La rappresenta un insieme di volte, solitamente come una programmazione per eseguire una routine. Cron vengono utilizzate espressioni specificate nella proprietà cronExpression di un trigger per pianificare l'esecuzione del trigger.

Dove:

I caratteri speciali sono definiti come segue:

Ecco alcuni esempi di espressioni cron (tutti gli orari sono nel fuso orario UTC):

Visualizzazione dei job pianificati utilizzando l'API

Puoi visualizzare tutti i job attualmente pianificati inviando una richiesta GET a /triggers?orgid={org_name}.

Ad esempio:

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

Di seguito viene fornito un esempio della risposta:

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

Puoi anche visualizzare un job pianificato specifico inviando una richiesta GET a /triggers/{trig_id}, dove {trig_id} è l'identificazione del job come descritto in Panoramica dei job pianificati. Ad esempio:

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

Di seguito viene fornito un esempio della risposta:

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

Aggiornamento dei job pianificati mediante l'API

Puoi aggiornare un job pianificato modificando le proprietà del relativo trigger. Ad esempio, potrebbe essere necessario modificare la pianificazione dell'esecuzione del trigger.

Per i job cron trigger (ovvero job che includono un valore di espressione cron), puoi solo Modifica i valori di cronExpression e le proprietà attivate. Altre modifiche sono ignorato. Per i job che non specificano un valore di espressione cron, puoi modificare altre proprietà come startTime o priority.

Per aggiornare un job pianificato, invia una richiesta PUT a /triggers/{trig_id}, dove {trig_id} è l'identificazione del trigger di job, come descritto in Panoramica dei job pianificati. Quando esegui l'aggiornamento, devi specificare del corpo della richiesta, le impostazioni aggiornate e l'ID del trigger.

Ad esempio, la seguente richiesta aggiorna l'espressione cron per il nuovo piano tariffario per gli sviluppatori Job di rinnovo da eseguire ogni giorno alle 05: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

Disabilitazione e riattivazione di un job pianificato utilizzando l'API

Per disattivare un job pianificato, imposta il valore della proprietà enabled del relativo trigger su false. Ad esempio:

$ 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

Per riattivare un job disattivato, imposta il valore della proprietà enabled del relativo trigger su vero.

Passaggi successivi

È consigliabile risincronizzarsi periodicamente con la monetizzazione dell'organizzazione e di qualsiasi sviluppatori, applicazioni e prodotti creati con i servizi API Edge. Scopri come in Sincronizza Dati Apigee Edge con monetizzazione.