Para kazanma işlerini planlama

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Planlanmış işlere genel bakış

Para kazanma özelliği, belirli zamanlarda çalışacak şekilde önceden planlanmış bir dizi iş ve bir iş planlayıcı sağlar.

Aşağıdaki tabloda, para kazanma tarafından sağlanan önceden planlanmış işler ve bunların çalıştırılmak üzere planlandığı zamanlar listelenmiştir (listelenen tüm zamanlar UTC'dir). Her işin tetikleyicisi de listelenir.

Yukarıda listelenen işlere ek olarak, aşağıdaki tabloda listelendiği gibi etkinlik bildirimleri aracılığıyla etkinleştirebileceğiniz işler de vardır. Daha fazla bilgi için Bildirimleri ayarlama başlıklı makaleyi inceleyin.

API'yi kullanarak para kazanma işi planını yönetme

Aşağıdaki bölümlerde, API'yi kullanarak para kazanma işi planının nasıl yönetileceği açıklanmaktadır:

• Tetikleyicileri yapılandırma
• Cron ifadeleri oluşturma
• API'yi kullanarak planlanmış işleri görüntüleme
• API'yi kullanarak planlanmış işleri güncelleme
• API'yi kullanarak planlanmış bir işi devre dışı bırakma ve yeniden etkinleştirme

Bu bölümde açıklanan API'ler hakkında daha fazla bilgi için API referansındaki Planlanmış işler bölümüne bakın.

Tetikleyicileri yapılandırma

Planlayıcı, işleri yürütmek için tetikleyicilere dayanır. Planlanmış bir iş, ilişkili tetikleyicisi yürütüldüğünde çalışır. Bir tetikleyicinin özellikleri, işin yürütülmesini yapılandırır ve bu özelliklerin değerini ayarlayarak işin yürütülmesinin özelliklerini (ör. işin ne zaman ve ne sıklıkta yürütüleceği) kontrol edebilirsiniz.

En yaygın iki tetikleyici türü cron tetikleyicileri ve basit tetikleyicilerdir. Cron tetikleyicisinde, çalıştırma zamanını belirten bir cronExpression özelliği bulunur. Basit tetikleyicinin cronExpression özelliği yoktur. Tetikleyicinin ne zaman geçerli olacağını belirtmek için startTime'ı ve isteğe bağlı olarak endTime'ı belirtirsiniz.

Tetikleyici özellikleri aşağıdaki gibidir (listelenen tüm saatler UTC'dir):

Cron ifadeleri oluşturma

Cron ifadesi, beyaz boşlukla ayrılmış altı veya yedi alandan oluşan bir dizedir. İfade, normalde bir rutini yürütmek için plan olarak bir dizi zamanı temsil eder. Bir tetikleyicinin cronExpression özelliğinde belirtilen Cron ifadeleri, tetikleyicinin yürütülmesini planlamak için kullanılır.

Burada:

Özel karakterler aşağıdaki şekilde tanımlanır:

Cron ifadelerine ilişkin bazı örnekler (listelenen tüm saatler UTC'dir):

API'yi kullanarak planlanmış işleri görüntüleme

Şu anda planlanmış tüm işleri /triggers?orgid={org_name} adresine bir GET isteği göndererek görüntüleyebilirsiniz.

Örneğin:

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

Aşağıda, yanıta dair bir örnek verilmiştir:

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

Ayrıca, Planlanmış işlere genel bakış bölümünde açıklandığı gibi, /triggers/{trig_id} adresine bir GET isteği göndererek belirli bir planlanmış işi de görüntüleyebilirsiniz. Burada {trig_id}, iş tetikleyicisinin kimliğidir. Örneğin:

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

Aşağıda, yanıta dair bir örnek verilmiştir:

{
    "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'yi kullanarak planlanmış işleri güncelleme

Planlanmış bir işi, tetikleyicisinin özelliklerini değiştirerek güncelleyebilirsiniz. Örneğin, tetikleyicinin çalıştırma zamanını değiştirmeniz gerekebilir.

Cron tetikleyici işler (yani cron ifadesi değeri içeren işler) için yalnızca cronExpression ve etkin özelliklerin değerlerini değiştirebilirsiniz. Diğer değişiklikler yok sayılır. Cron ifadesi değeri belirtilmeyen işler için startTime veya priority gibi diğer özellikleri değiştirebilirsiniz.

Planlanmış bir işi güncellemek için /triggers/{trig_id} adresine bir PUT isteği gönderin. Burada {trig_id}, Planlanmış işlere genel bakış bölümünde açıklandığı gibi iş tetikleyicisinin kimliğidir. Güncelleme yaptığınızda, istek gövdesinde güncellenen ayarları ve tetikleyicinin kimliğini belirtmeniz gerekir.

Örneğin, aşağıdaki istek, Yeni Geliştirici Ücret Planı Yenileme işinin cron ifadesini her gün saat 05:00'te (UTC) çalışacak şekilde günceller:

$ 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'yi kullanarak planlanmış bir işi devre dışı bırakma ve yeniden etkinleştirme

Planlanmış bir işi devre dışı bırakmak için tetikleyicisinin enabled özellik değerini false olarak ayarlayın. Örneğin:

$ 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

Devre dışı bırakılan bir işi yeniden etkinleştirmek için tetikleyicisinin enabled özellik değerini true olarak ayarlayın.

Sonraki adımlar

Kuruluşunuzu ve Edge API Hizmetleri'ni kullanarak oluşturduğunuz tüm geliştiricileri, uygulamaları ve ürünleri düzenli olarak para kazanma ile yeniden senkronize etmeniz önerilir. Apigee Edge verilerini para kazanma ile senkronize etme başlıklı makalede nasıl yapılacağını öğrenin.