Apigee Edge belgelerini görüntülüyorsunuz.
.
Git:
Apigee X belgeleri. bilgi
Planlanmış işlere genel bakış
Para kazanma, bir iş planlayıcı ile birlikte çalıştırılmak üzere önceden planlanmış bir dizi iş sunar. belirlenebilir.
kullanarakAşağıdaki tabloda, para kazanma yöntemlerine göre sağlanan önceden planlanmış işler ve bunların gerçekleşme zamanları yayınlanması planlanan (listelenen tüm saatler UTC'dir). Her işin tetikleyicisi de listelenir.
İş | Açıklama | Plan (UTC) | Tetikleyici |
---|---|---|---|
Aylık Geliştirici Vergi Oranı | Her geliştiricinin vergi motorundan vergi oranını getirir ve geliştiriciyi günceller düzenlenmiş vergi oranına sahip tüzel kişidir. | Her ayın ilk günü saat 05:45'te | MINT.MONTHLY_DEV_TAXRATE@@@ |
Aboneliği yenileyin | Etkin ücret planları için yinelenen ücretler veya geçerli olan gelecekteki ücret planları için yeni ücretler uygulanır. geçerli günde başlayın. | Her gün gece yarısından sonra 5 saniye sonra | MINT.RENEW_SUBSCRIPTIONS@@@ |
XeFeed Güncelleyici | Desteklenen her para birimi için ABD doları cinsinden döviz kurun. | Her gün gece yarısından sonra 1 saniye sonra | MINT.XEFEED@@@ |
Geliştirici Ücret Planını Yenile | Ücret planı için yenileme tarihlerini devreye alır ve erken sonlandırma ücretlerini hesaplar. | Her gün saat 02:20'de | MINT.RENEW_DEV_RATEPLAN@@@ |
İşlem Geçişini Yeniden Dene | Not: Bu işin desteği sonlandırılmıştır ve üzerinde etkisi yoktur. para kazanma. | Her gün saat 04:30'da | MINT.RETRY_TX_RELAY@@@ |
İşlem Temizleyici | Not: Bu işin desteği sonlandırılmıştır ve üzerinde etkisi yoktur. para kazanma. | Her gün saat 05:30'da | MINT.TX_CLEANSER@@@ |
Geliştirici Bakiyesi Denetimi | Geliştirici hesabı bakiyesini denetler. Mevcut kullanımı kopyalar ve ön ödemeli bakiyeyi/sonradan ödemeli kredi limitini bir denetim tablosuna alır, ardından mevcut kullanımı kullanım bakiyesini sıfıra döndürür. | Her ayın ilk günü, gece yarısından sonraki 5 saniye | MINT.DEVELOPER_BALANCE_AUDIT@@@ |
Aylık Faturalandırma Belgeleri | Faturalandırma belgeleri oluşturur. Not: Apigee, artık Apigee Edge Monetization'dan faturalandırma dokümanları oluşturmayı desteklememektedir. Emeklilikler başlıklı makaleyi inceleyin. |
Her ayın 11. günü gece yarısından sonraki 1. dakikada | MINT.MONTLY_BILLING_DOCS@@@ |
Geliştirici Ücret Planı Sayacı | Not: Bu işin desteği sonlandırılmıştır ve üzerinde etkisi yoktur. para kazanma. | Her gün gece yarısından sonraki 3 saniyede | MINT.RESET_DEVELOPER_RATE_PLAN_COUNTER@@@ |
Günlük Ödemeler | Tüm saatlik işlem toplamlarını yeniden hesaplar ve toplamları hesaplamak için bunları önceki gün. | Her gün saat 01:20'de | MINT.CHARGE_DAILY@@@ |
Saatlik Ödemeler | Bir saatin her çeyreği için tüm işlem toplamlarını hesaplar. | Her çeyrekte 1 dakika geç | MINT.CHARGE_HOURLY@@@ |
Yenileme bildirimi yapılandırması | Tüm bildirim koşullarını yeniden dizine ekler. | 5 dakikada bir | MINT.REFRESH_NOTIFICATION_CONFIG@@@ |
E-posta bildirimleri gönder | Birikmiş e-posta bildirimlerini gönderir | Saatte bir | MINT.EMAIL_NOTIFICATION@@@ |
Yenileme Sınırı | Not: Bu işin desteği sonlandırılmıştır ve üzerinde etkisi yoktur. para kazanma. | Yok (Hiçbir zaman yürütülmez) | MINT.REFRESH_LIMIT@@@ |
Yukarıda listelenen işlere ek olarak, etkinlik üzerinden etkinleştirebileceğiniz işler de vardır aşağıdaki tabloda listelenmiştir. Daha fazla bilgi için Bildirimleri ayarlama başlıklı makaleyi inceleyin.
İş | Açıklama | Planla | Tetikleyici |
---|---|---|---|
Yeni Paket Bildirimi | Tüm geliştiricilere yeni bir API paketinin kullanıma sunulduğuna dair bildirim gönderir. |
Bir kez çalıştırılır — işin etkinleştirildiği gün saat 21:00'de.
Not: Bildirimler, sizin durumunuzdan bağımsız olarak yalnızca bir kez gönderilir.
işin birden fazla yürütülmesine neden olan bir |
MINT.NEW_PACKAGE_NOTIFY@@@ |
Yeni Geçici Bildirim | Tüm geliştiricilere, yeni API ürünlerinin belirli ülkelerde kullanıma sunulduğuna dair bir bildirim gönderir yardımcı olur. |
Bir kez çalıştırılır — işin etkinleştirildiği gün saat 21:00'de.
Not: Bildirimler, sizin durumunuzdan bağımsız olarak yalnızca bir kez gönderilir.
işin birden fazla yürütülmesine neden olan bir |
MINT.ADHOC_NOTIFY@@@ |
Yeni Ürün Bildirimi | Yeni bir API ürününün kullanıma sunulduğuna dair tüm geliştiricilere bildirim gönderir. |
Bir kez çalıştırılır — işin etkinleştirildiği gün saat 21:00'de.
Not: Bildirimler, sizin durumunuzdan bağımsız olarak yalnızca bir kez gönderilir.
işin birden fazla yürütülmesine neden olan bir |
MINT.NEW_PRODUCT_NOTIFY@@@ |
Yeni Ücret Planı Bildirimi |
Etkilenen geliştiricilere yeni bir ücret planının mevcut olduğuna dair bildirim gönderir. Tümü Ebeveyn ücret planına abone olan geliştiricilere yeni bir ücret planının etkin. Ayrıca:
|
Yeni ücret planının başlangıç tarihinde saat 04:30'da çalıştırılır. | MINT.NEW_RATEPLAN_NOTIFY@@@ |
Yeni Tnc | Etkilenen geliştiricilere, yeni veya düzeltilmiş Hükümler ve Koşullar'ın bulunduğuna dair bir bildirim gönderir yayınlanmış (ve geliştirici bunları henüz kabul etmemiştir). | Yeni veya düzeltilmiş Şartlar ve Koşullar'ın başlangıç tarihinden 30, 7 ve 1 gün önce geçerliyse, saat 21:00'de | MINT.TNC_ACCEPTANCE_NOTIFY@@@ |
Süresi dolan ücret planı | Etkilenen geliştiricilere bir ücret planı hakkında ön uyarıda bulunmaları için bildirim gönderir süresi dolacak. | Ücret planının geçerlilik süresi sona ermeden 30, 7 ve 1 gün önce saat 21:00'de yayınlanır. | MINT.EXPIRING_RATE_PLAN_NOTIFY@@@ |
API'yi kullanarak para kazanma işi programını yönetme
Aşağıdaki bölümlerde, para kazanma işi programının API kullanılarak 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
Bu bölümde açıklanan API'ler hakkında daha fazla bilgi edinmek için API'deki Planlanmış işler bölümüne bakın bir referans noktası olarak kabul edilir.
Tetikleyicileri yapılandırma
Planlayıcı, işleri yürütmek için tetikleyicilerden yararlanır. Planlanmış bir iş, ilişkili olduğu tetikleyici yürütülür. Tetikleyicinin özellikleri işin yürütülmesini düzenler ve değerini belirleyebilirsiniz. Böylece, işin yürütülme özelliklerini (örneğin, bir işin ne sıklıkta yürütüleceğini belirler.
En yaygın iki tetikleyici türü cron tetikleyicileri ve basittir
tetikleyiciler hakkında daha fazla bilgi edinin. Bir cron tetikleyicisi,cronExpression
zaman çizelgesine sadık kalmanızı sağlar. Basit bir tetikleyicinin cronExpression
özelliği yoktur; siz
tetikleyicinin ne zaman etkinleşeceğini belirtmek için startTime
öğesini ve
isteğe bağlı olarak endTime
ekleyebilirsiniz.
Tetikleyici özellikleri aşağıdaki gibidir (listelenen tüm zamanlar UTC'ye göredir):
Özellik | Açıklama |
---|---|
cronExpression |
Cron ifadesi, tetikleyici için bir yürütme planı oluşturur. Örneğin: "8:00 A.M.
her pazartesiden cumaya" veya "01:30'da her ayın son cuma günü". Görüntüleyin
Daha fazla bilgi için cron ifadeleri oluşturma başlıklı makaleyi inceleyin.
Bu özelliğin belirtilmesi, tetikleyiciyi bir cron tetikleyicisi olarak tanımlar. Not: Hem |
enabled |
Tetikleyicinin yürütülmek üzere etkin olup olmadığını gösteren işaret. Değer şunlardan biri olabilir:
şu:
|
endTime |
Tetikleyicinin programının artık geçerli olmadığı dönem biçimindeki saat. |
group |
Tetikleyicinin yürütüleceği sunucunun türü. Örneğin, tetikleyici
bir yönetim sunucusunda yürütülmesi gerekiyorsa değer
management-server Tetikleyicinin bir mesajda yürütülmesi gerekiyorsa
işleme sunucusunda değer message-processor olarak ayarlanmalıdır. |
id |
Tetikleyicinin tanımlanması. |
jobId |
Yürütülecek işin kimliği. |
name |
Tetikleyiciyi tanımlamak için kullanılan benzersiz ad. |
priority |
Birden fazla tetikleyicinin yürütülmesi planlandıysa tetikleyicilerin göreceli yürütme önceliği
elde edebilirsiniz. Değer küçüldükçe öncelik düzeyi yükselir. Örneğin, iki tetikleyici
aynı anda yürütülecek şekilde programlanır ve bir tetikleyicinin önceliği 1 iken
diğeri 2'yse önceliği 1 olan tetikleyici ilk olarak yürütülür.
Bu özellik yalnızca birden fazla tetikleyici tam olarak aynı şekilde yürütülüyorsa geçerlidir gerekir. |
startTime |
Yalnızca basit tetikleyiciler için geçerlidir.
Tetikleyicinin programının yürürlüğe girdiği dönem biçimindeki zaman. Not:
hem |
suiteId |
Bildirim bölümünün sistem düzeyinde mi yoksa varsayılan düzeyde mi olduğunu belirten işaret
izin verebilirsiniz. Geçerli değerler DEFAULT veya SYSTEM ya da
kendi benzersiz süit adınızı belirtebilirsiniz. |
triggerDataMap |
Birden fazla sunucunun çalışmasını engelleyen custom_lock_key kilit anahtarı
bir arada kullanabilirsiniz. |
Cron ifadeleri oluşturma
Cron ifadesi, boşlukla ayrılmış altı veya yedi alandan oluşan bir dizedir. İlgili içeriği oluşturmak için kullanılan
ifade, normalde bir rutini yürütme programı olarak bir dizi zamanı temsil eder. Cron
Bir tetikleyicinin cronExpression
özelliğinde belirtilen ifadeler kullanılır
o tetikleyicinin yürütülmesini
planlamak için gereklidir.
s
m h dm m dw y
Burada:
Alan | Açıklama | Zorunlu | İzin verilen değerler | İzin Verilen Özel Karakterler |
---|---|---|---|---|
s |
Saniye | Evet | 0-59 | , - * / |
m |
Dakika | Evet | 0-59 | , - * / |
h |
Saat | Evet | 0-23 | , - * / |
dm |
Ayın günü | Evet | 0-31 | , - * ? / D |
m |
Ay | Evet | 1-12 veya OCAK-ARALIK | , - * / |
dw |
Haftanın günleri | Evet | 1-7 veya PAZ-CUMARTESİ | , - * ? / Sol # |
y |
Yıl | Hayır | Boş veya 1970-2099 | , - * / |
Özel karakterler şu şekilde tanımlanır:
Özel karakter | Açıklama |
---|---|
* | Bir alandaki tüm değerleri seçmek için kullanılır. Örneğin, dakika alanındaki * şu anlama gelir: 100 kat arttı. |
? | Karaktere izin verilen iki alandan birinde bir şeyi belirtmek için kullanılır, diğeri değil. Örneğin, tetikleyicinin belirli bir günde yürütülmesini istiyorsanız ayın (örneğin, ayın 10'u) ama haftanın hangi günü olduğunu düşünmüyorsanız günü 10 olarak belirtin ay alanı ve ? haftanın günü alanına girmelidir. |
- | Aralıkları belirtmek için kullanılır. Örneğin, saat alanındaki 10-12 değeri, 10, 11 ve 12. |
, | Ek değerler belirtmek için kullanılır. Örneğin, haftanın günü alanındaki PZT,ÇAR,CUMA Pazartesi, Çarşamba ve Cuma günlerini ifade eder. |
/ | Artımları belirtmek için kullanılır. Örneğin, saniye alanındaki 0/15 değeri, 0 saniyesini, 15, 30 ve 45. Saniye alanındaki 5/15 değeri ise 5, 20, 35 ve 50. saniyeleri ifade eder. Şunları yapabilirsiniz: Ayrıca, " karakteriyle ayrılır. Bunu yapmak, / işaretinin önünde 0'a sahip olmakla eşdeğerdir. Ayın günü alanında 1/3 değeri belirtildiğinde, ilk günden başlayarak 3 günde bir yürütülür günü belirir. |
L | İzin verilen iki alanın her birinde farklı bir anlama sahiptir. Gününde L ay alanı, ayın son günü, yani Ocak için 31 veya tarih aralığı için 28 gün Artık olmayan yıllarda Şubat ayında. Haftanın günü alanında L, haftanın son günü anlamına gelir. yani 7, yani SAT. Ancak haftanın günü alanında başka bir değerden sonra kullanılırsa bu, ayın son xx günü. Örneğin, 6L ayın son cuma günü anlamına gelir. |
W | Belirli bir güne en yakın hafta içi gününü (pazartesi-cuma) belirtmek için kullanılır. Örneğin, ayın günü alanında 15W belirtirse, ayın 15'ine en yakın hafta içi günü anlamına gelir. ay. Yani ayın 15'i cumartesi günüyse tetikleyici ayın 14'ü cuma günü yürütülür. Öğe Ayın 15'i Pazar günüdür ve tetikleyici ayın 16'sı Pazartesi günü yürütülür. Ayın 15'i Salı günüyse planlama ayın 15’inde, Salı günü yürürlüğe girecektir. Ancak ayın günü için 1W değerini belirtirseniz ilki cumartesi günüyse tetikleyici 3'ünün pazartesi günü yürütülecektir. "atla" bir ay günlük sınırı üzerinde. W karakteri yalnızca ayın günü, bir gün aralığı veya gün listesi değil, tek bir gündür. |
# | Ayın n. XXX gününü belirtmek için kullanılır. Örneğin, aynı günde 6#3 değeri hafta alanı, ayın üçüncü Cuma günü (6. gün = Cuma ve 3. = ayın 3. günü) ay). Diğer örnekler: 2#1 = ayın ilk pazartesi günü, 4#5 = beşinci Ayın çarşamba günü. |
Cron ifadelerine ilişkin bazı örnekleri burada bulabilirsiniz (listelenen tüm zamanlar UTC'ye göredir):
Cron ifadesi | Yürütme planı |
---|---|
0 0 12 * * ? | 12:00 her gün (öğlen). |
0 15 10 * * ? 2013 | 10:15 dönüşüm artışı sağladı. |
0 10,44 14 ? 3 ÇAR | 14:10 ve 14:44'te Mart ayında her çarşamba günü yapılır. |
0 15 10 ? * 6L 2013-2015 | 10:15 2013 2014 yılları boyunca her ayın son Cuma günü ve 2015. |
0 15 10 ? * 6#3 | 10:15 her ayın üçüncü cuma günü yapılır. |
API'yi kullanarak planlanmış işleri görüntüleme
Şu anda planlanmış olan tüm işleri görmek için,
/triggers?orgid={org_name}
Ö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ıtın bir örneği 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, her bir görev için bir GET isteği göndererek
/triggers/{trig_id}
, burada {trig_id}
işin tanımıdır
Planlanmış işlere genel bakış bölümünde açıklandığı üzere bir tetikleyici içerir. Ö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ıtın bir örneği 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 yürütme planını değiştirmesi gerekebilir.
Cron tetikleme işleri (yani bir cron ifade değeri içeren işler) için
cronExpression
ve etkin özelliklerin değerlerini değiştirin. Diğer değişiklikler
yoksayıldı. Cron ifadesi değeri belirtmeyen işler için diğer özellikleri değiştirebilirsiniz
startTime
veya priority
gibi.
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ığı üzere iş tetikleyicisinin tanımıdır. Güncellemeyi yaptığınızda,
güncellenen ayarları ve tetikleyicinin kimliğini istek gövdesine ekleyin.
Örneğin, aşağıdaki istek Yeni Geliştirici Ücret Planı için cron ifadesini günceller Her gün saat 05:00'te çalışacak yenileme işi 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
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 tetikleyicinin enabled
özellik değerini şu şekilde ayarlayın:
false (yanlış) değerini alır. Ö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ılmış bir işi yeniden etkinleştirmek için tetikleyicinin enabled
özellik değerini şu şekilde ayarlayın:
doğru.
Sonraki adımlar
Kuruluşunuzun para kazanma özelliğini düzenli aralıklarla yeniden senkronize etmeniz önerilir. Edge API Hizmetleri'ni kullanarak oluşturduğunuz geliştiriciler, uygulamalar ve ürünler. Nasıl yapılacağını öğrenin: Senkronize Et Para kazanma olanağı sunan Apigee Edge verileri.