Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi
Giriş
Ayarlanabilir bir bildirim planında, API sağlayıcı her uygulama geliştiricinin hedef işlem sayısını ayarlayabilir. Hedef sayının belirli bir yüzdesine (ör. %90, %100 veya %150) ulaşıldığında bildirim gönderilip gönderilmeyeceğini ve gönderilecekse ne zaman gönderileceğini yapılandırabilirsiniz. Hedef sayıya ulaşıldıktan sonra ek işlemler engellenmez.
Kullanıcı arayüzünü kullanarak ayarlanabilir bir bildirim planı yapılandırma
Aşağıda açıklandığı şekilde ayarlanabilir bildirim planlarını yapılandırın.
Edge
Edge kullanıcı arayüzünü kullanarak ayarlanabilir bir bildirim planı yapılandırmak için bir ücret planı eklerken veya düzenlerken Ayarlanabilir Bildirim ücret planı türünü seçin ve Ayarlanabilir Bildirim bölümünde aşağıdaki bilgileri yapılandırın:
| Alan | Açıklama | Varsayılan |
|---|---|---|
| Hesaplama sıklığı | İşlem hacminin (veya özel özellikle ilgili hacmin) hesaplandığı dönem. Ay sayısı seçin (1-24 ay). | 1 ay |
API ürününüz için özel özellikler tanımladıysanız özel bir özelliğe dayalı işlem sayacı tanımlamak üzere özel bir derecelendirme parametresi yapılandırabilirsiniz.
Örneğin, şunları yapmanız gerekebilir:
- Geliştiricilerden, bir API çağrısının mesajında sağlanan değere göre değişken bir tutar alın.
Örneğin, uygulama geliştiricilerden API isteğinde iletilen bayt sayısına göre ücret almak isteyebilirsiniz. - Birden fazla API çağrısını tek bir işlemde paketleyin.
Bu durumda, Özel derecelendirme parametresini kullan'ı seçin ve açılır listeden özel özelliği belirleyin.
Daha fazla bilgi için Özel özelliklerle fiyat planı yapılandırma başlıklı makaleyi inceleyin.
Classic Edge (Private Cloud)
Klasik Edge kullanıcı arayüzünü kullanarak ayarlanabilir bildirim planlarını yapılandırmak için:
- Ücret Planı penceresindeki Plan Ayrıntıları sekmesinde Ücret Planı Türü alanında Ayarlanabilir Bildirim'i seçin.
Ücret planı penceresine erişme hakkında bilgi için Kullanıcı arayüzünü kullanarak ücret planı oluşturma başlıklı makaleyi inceleyin.
- Yenileme Dönemi alanını, planın otomatik olarak yenileneceği ay sayısına ayarlayın (geliştirici bu tarihten önce sözleşmeyi feshetmediği sürece). Bu değeri 0 olarak ayarlarsanız plan, geliştirici sonlandırmayı seçene kadar geçerli kalır.
- Genel Fiyat Planı bölümünde Ayrıntılar'ı tıklayın.
- Toplama Temeli'ni, işlem hacminin toplandığı süre olarak ayarlayın. 1 ile 24 ay arasında bir sayı seçin. Bu değer varsayılan olarak 1 ay olur.
- Uygula ve Kapat'ı tıklayın.
- Taslağı Kaydet'i tıklayın.
- Planı yalnızca kesinleştiğinden emin olduğunuzda yayınlayın. Yayınlama tarihi ayarlama ve planı yayınlama hakkında bilgi için Yayınlama fiyat planları başlıklı makaleyi inceleyin.
Bir fiyat planını yayınladıktan sonra yalnızca bitiş tarihini değiştirebilirsiniz. Yayınlanan bir ücret planını silemezsiniz ancak Yayınlanan bir ücret planının geçerliliğini sona erdirme başlıklı makalede açıklandığı gibi ücret planının geçerliliğini sona erdirebilir ve gelecekteki bir ücret planıyla değiştirebilirsiniz.
API'yi kullanarak ayarlanabilir bildirim planı yapılandırma
/organizations/{org_name}/monetization-packages/{package_id}/rate-plans adresine gönderilen bir POST isteğinin istek gövdesindeki
ratePlanDetails özelliğinde ayarlanabilir bildirim planı ayrıntılarını belirtin.
Ayarlanabilir bir bildirim planı belirtmek için istek gövdesinin ratePlanDetails bölümünde aşağıdaki değerleri belirtin:
| Mülk | Değer |
|---|---|
type |
USAGE_TARGET olarak ayarlayın. |
meteringType |
DEV_SPECIFIC olarak ayarlayın. |
duration |
Toplama temeli için zaman aralığına ayarlanır ve durationType ile birlikte kullanılır. Ayarlanabilir bildirimli tarifelerde bunu 1 ile 24 arasında bir tam sayı değerine ayarlayın. |
durationType |
|
Ayarlanabilir bildirim planı ayrıntıları belirtilirken ayarlanabilecek yapılandırma özellikleri hakkında daha fazla bilgi için Fiyat planı ayrıntıları yapılandırma ayarları başlıklı makaleyi inceleyin.
Örneğin, aşağıda toplama temeli 1 ay olarak ayarlanmış, ayarlanabilir bir bildirim planı tanımlanmaktadır.
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "AdjustableNotification",
"displayName": "Adjustable notification plan",
"description": "Adjustable notification plan",
"published": "true",
"organization": {
"id": "myorg"
},
"startDate": "2016-04-15 00:00:00",
"type": "STANDARD",
"monetizationPackage": {
"id": "p1",
"name": "test"
},
"currency": {
"id" : "usd",
"name" : "USD"
},
"ratePlanDetails": [
{
"type": "USAGE_TARGET",
"meteringType": "DEV_SPECIFIC",
"duration": 1,
"durationType": "MONTH",
"ratingParameter": "VOLUME",
"organization": {
"id": "myorg"
},
"currency": {
"id": "usd",
"name": "USD"
}
}
]
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/monetization-packages/p1/rate-plans" \
-u email:password
API'yi kullanan her uygulama geliştirici için hedef işlem sayısını ayarlama
Uygulama geliştirici, ödeme planını kabul ettiğinde geliştirici için hedef işlem sayısını belirleyebilir ve değeri daha sonra güncelleyebilirsiniz.
Ücret planını kabul ederken hedef işlem sayısını ayarlama
Ücret planını kabul ederken hedef işlem sayısını ayarlamak için /organizations/{org_name}/developers/{developer_id}/developer-rateplans kaynağına yönelik bir POST isteğinde istek gövdesindeki quotaTarget özelliğini belirtin.
quotaTarget değerini pozitif bir tam sayı veya 0 olarak ayarlayarak uygulama geliştiricisi için bildirimleri devre dışı bırakın. Belirtilmezse quotaTarget varsayılan olarak 0 olur.
Örneğin, aşağıdaki istek, uygulama geliştiricisi ayarlanabilir bildirim planını kabul ettiğinde hedef işlem sayısını 4.000 olarak ayarlar.
$ curl -H "Content-Type:application/json" -X POST -d \
'{
"developer":{
"id":"dev@mycompany.org"
},
"ratePlan":{
"id":"p1_adjustable-notification-plan"
},
"startDate": "2016-03-24 00:00:00",
"quotaTarget": 4000,
"suppressWarning": false
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/developers/dev@mycompany.com/developer-rateplans" \
-u email:password
Kabul edilen fiyat planı güncellenirken hedef işlem sayısını ayarlama
Hedef işlem sayısını ayarlamak için kabul edilen fiyat planını güncelleyebilir ve /organizations/{org_name}/developers/{developer_id}/developer-rateplans/{developer_rateplan_id} kaynağına yönelik bir PUT isteğinde istek gövdesinde quotaTarget özelliğini belirtebilirsiniz. Uygulama geliştiricisi için bildirimleri devre dışı bırakmak üzere quotaTarget değerini pozitif bir tam sayı veya 0 olarak ayarlayın. Belirtilmezse quotaTarget varsayılan olarak 0 olur.
Yayınlanan fiyat planını kabul ettiğinizde yanıtta {developer_rateplan_id} döndürülür.
Örneğin:
{
"created": "2016-03-31 18:59:54",
"developer": {
...
},
"id": "b1c600b8-f871-496d-8173-12b9950d6ab1",
"quotaTarget": 3000,
"ratePlan": {
...
},
"startDate": "2016-03-31 00:00:00",
"updated": "2016-03-31 18:59:54",
"waiveTerminationCharge": false
}
Alternatif olarak, geliştirici ücreti
planı için
/organizations/{org_name}/developers/{developer_id}/developer-accepted-rateplans adresine GET isteği göndererek {developer-rateplan-id} değerini alabilirsiniz.
Burada {developer_id}, geliştiricinin e-posta adresidir. Daha fazla bilgi için Bir geliştirici tarafından kabul edilen tüm fiyat planlarını görüntüleme başlıklı makaleyi inceleyin.
Örneğin:
{
"developerRatePlan": [
{
"created": "2016-03-31 14:52:30",
"developer": {
...
},
"id": "b1c600b8-f871-496d-8173-12b9950d6ab1",
"quotaTarget": 3000,
"ratePlan": {
...
},
"startDate": "2016-03-31 00:00:00",
"updated": "2016-03-31 18:59:54"
}
],
"totalRecords": 1
}
Aşağıdaki istek, hedef işlem sayısını 4.000 olarak günceller.
$ curl -H "Content-Type:application/json" -X PUT -d \
'{
"id" : "b1c600b8-f871-496d-8173-12b9950d6ab1",
"developer":{
"id":"dev@mycompany.com"
},
"ratePlan":{
"id":"p1_adjustable-notification-plan"
},
"startDate": "2016-04-15 00:00:00",
"quotaTarget": 4000,
"suppressWarning":false
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/myorg/developers/dev@mycompany.com/developer-rateplans/b1c600b8-f871-496d-8173-12b9950d6ab1"
-u email:password