Anda sedang melihat dokumentasi Apigee Edge.
Buka
dokumentasi Apigee X. info
Pengantar
Setelah paket tarif yang ada dipublikasikan, satu-satunya properti yang dapat Anda ubah adalah tanggal akhirnya. Namun, Anda dapat membuat versi baru rencana yang menyertakan properti yang diubah, seperti tarif paket tarif yang diubah. Anda dapat menyiapkan revisi untuk berlaku di masa mendatang. Paket tarif asli berakhir saat revisi berlaku.
Misalnya, Anda membuat paket tarif standar yang habis masa berlakunya pada 31 Desember 2019 dan ingin menggantinya dengan paket lain yang berlaku pada 1 Januari 2020. Untuk melakukannya, buat rencana tarif mendatang dan siapkan untuk berlaku pada tanggal 1 Januari 2020.
Jika tidak ada tanggal akhir yang ditetapkan untuk paket tarif saat ini, Anda dapat mengganti paket tarif yang ada dengan paket tarif mendatang yang dimulai paling cepat hari ini. Anda harus mengakhiri masa berlaku paket tarif saat ini, seperti yang dijelaskan dalam Mengakhiri paket tarif yang dipublikasikan.
Developer akan diberi tahu tentang paket tarif yang direvisi. Developer yang menyetujui paket tarif asli akan otomatis terdaftar untuk revisi (tetapi memiliki opsi untuk menolak revisi).
Anda dapat membuat paket tarif mendatang menggunakan UI pengelolaan atau monetization API, seperti yang dijelaskan di bagian berikut.
Membuat rencana tarif mendatang menggunakan UI
Buat paket tarif mendatang, seperti yang dijelaskan di bawah.
Edge
Untuk membuat versi mendatang dari paket tarif yang dimulai beberapa saat setelah hari ini menggunakan UI Edge, lakukan langkah-langkah berikut.
- Di halaman Paket Tarif,
posisikan kursor pada baris yang terkait dengan paket tarif yang ingin Anda buatkan paket tarif mendatang.
Paket tarif harus memiliki tanggal akhir. - Klik +Future.
- Di bagian Paket tarif mendatang, pilih salah satu opsi berikut:
- Mulai ulang periode kontrak penuh pada tanggal mulai berlaku yang baru: Paket tarif di masa mendatang akan berlaku pada tanggal mulai berlaku. Jangka waktu perpanjangan paket tarif mendatang sama dengan paket tarif saat ini.
- Kurangi waktu yang dihabiskan untuk kontrak sebelumnya dari periode baru, pada tanggal mulai berlaku: Paket tarif mendatang berlaku pada tanggal mulai berlaku. Waktu yang dihabiskan untuk menggunakan paket tarif saat ini dikurangi dari jangka waktu perpanjangan paket tarif mendatang. Artinya, jika developer menggunakan paket saat ini selama 3 bulan, dan periode perpanjangannya dikurangi 3 bulan.
- Konfigurasikan kolom berikut di panel atas:
Catatan: Kolom lain bersifat hanya baca.Kolom Deskripsi Default Wajib Nama paket tarif Nama paket tarif Anda.
Catatan: Nama tidak harus sama dengan nama paket tarif asli.
Nama rencana yang ada Ya Tanggal mulai Tanggal paket tarif berlaku. Masukkan tanggal mulai atau pilih tanggal menggunakan kalender. Hari ini Tidak Tanggal akhir Tanggal paket tarif berakhir. Untuk menentukan tanggal akhir, aktifkan tombol Memiliki Tanggal Akhir, lalu masukkan tanggal akhir atau pilih tanggal menggunakan kalender. Catatan: Paket tarif akan berlaku hingga akhir hari pada tanggal yang ditentukan. Misalnya, jika Anda ingin mengakhiri masa berlaku paket tarif pada 1 Desember 2018, Anda harus menetapkan nilai endDate ke 2018-11-30. Dalam hal ini, paket tarif akan berakhir pada penghujung hari pada 30 November 2018; semua permintaan pada 1 Desember 2018 akan diblokir.
Tidak ada Tidak Dapat dilihat oleh portal Tetapkan apakah paket tarif bersifat Publik atau Pribadi. Lihat Paket tarif publik versus pribadi. Diaktifkan Tidak - Konfigurasi biaya untuk paket tarif. Lihat Mengonfigurasi biaya.
Catatan: Tidak berlaku untuk paket notifikasi yang dapat disesuaikan. - Jika Anda memilih paket produk yang berisi lebih dari satu produk API, tetapkan preferensi berikut di bagian Paket tarif spesifik atau umum:
Catatan: Langkah ini tidak berlaku untuk paket notifikasi yang dapat disesuaikan.
Kolom Deskripsi Default Mengonfigurasi setiap produk satu per satu Tanda yang menentukan apakah akan mengonfigurasi paket tarif individual untuk setiap produk API. Nonaktif Konfigurasi penawaran freemium setiap produk satu per satu Tanda yang menentukan apakah akan mengonfigurasi paket freemium untuk setiap produk API. Nonaktif Pilih produk Jika mengaktifkan salah satu atau kedua tanda, Anda harus memilih setiap produk satu per satu dari menu drop-down dan mengonfigurasi detail paket tarifnya. Catatan: Pastikan Anda mengonfigurasi semua produk dalam paket produk.
T/A - Konfigurasi detail paket tarif, berdasarkan jenis paket tarif yang dipilih:
- Klik salah satu opsi berikut:
Tombol Deskripsi Perbarui Draf Simpan paket tarif sebagai draf. Paket tarif tidak akan terlihat oleh developer aplikasi hingga Anda memublikasikannya. Anda dapat mengedit kolom mana pun dalam draf rencana tarif.
Publikasikan Draf Publikasikan rencana. Catatan: Setelah memublikasikan paket tarif, Anda hanya dapat mengubah tanggal akhir jika belum ditetapkan. Anda tidak dapat menghapus paket tarif setelah dipublikasikan, tetapi Anda dapat mengakhiri masa berlaku paket tarif dan menggantinya dengan paket tarif mendatang, seperti yang dijelaskan dalam Mengakhiri paket tarif yang dipublikasikan.
Edge Klasik (Private Cloud)
Untuk membuat versi mendatang dari paket tarif yang dimulai beberapa saat setelah hari ini menggunakan UI Edge Klasik, lakukan langkah-langkah berikut.
- Dalam katalog paket, klik +Future di kolom Draft/Future untuk paket tarif yang ingin diganti.
Tindakan ini akan membuka jendela Paket Tarif.
Perbedaan utama antara periode paket tarif mendatang dan periode paket tarif saat ini adalah penambahan bagian Pelanggan Lama.
- Seperti yang Anda lakukan pada paket tarif apa pun:
- Masukkan nama untuk rencana di kolom Nama Paket Tarif. Nama tidak harus sama dengan nama paket tarif asli.
- Mengonfigurasi biaya untuk paket tarif (opsional).
- Konfigurasi detail paket tarif, berdasarkan jenis paket tarif yang dipilih:
- Tentukan tanggal mulai paket mendatang (lihat Paket tarif publikasi), dan tanggal akhir (Anda juga dapat memilih "Tanpa tanggal akhir" jika tidak ingin paket tarif mendatang berakhir pada tanggal tertentu). Jika tanggal akhir ditetapkan untuk paket saat ini, tanggal mulai berlaku rencana mendatang harus setelah tanggal akhir paket saat ini.
- Di bagian Subscriber yang Ada, pilih salah satu opsi berikut:
- Mulai ulang periode kontrak penuh pada tanggal mulai berlaku yang baru. Paket tarif mendatang berlaku pada tanggal mulai berlaku. Jangka waktu perpanjangan paket tarif mendatang sama dengan paket tarif saat ini.
- Kurangi waktu yang dihabiskan untuk kontrak sebelumnya dari periode baru, pada tanggal mulai berlaku. Paket tarif mendatang berlaku pada tanggal mulai berlaku. Waktu yang dihabiskan untuk menggunakan paket tarif saat ini dikurangi dari jangka waktu perpanjangan paket tarif mendatang. Artinya, jika developer menggunakan paket saat ini selama 3 bulan, dan periode perpanjangannya dikurangi 3 bulan.
- Di kolom Tanggal Mulai Berlaku, masukkan tanggal mulai yang jatuh setelah tanggal akhir paket tarif yang ada.
Membuat rencana tarif mendatang menggunakan API
Anda dapat membuat paket tarif mendatang menggunakan API dengan mengeluarkan permintaan POST
ke
/organizations/{org_name}/monetization-packages/{package_id}/rate-plans/{plan_Id}/revision
.
Dengan keterangan:
{org_id}
adalah nama organisasi.{package_id}
adalah identifikasi paket API.{plan_Id}
adalah identifikasi paket tarif.
parentRatePlan
menentukan ID paket tarif asli.startDate
menentukan tanggal mulai berlaku rencana baru.
Nama paket tarif mendatang tidak boleh sama dengan nama paket asli. Selain itu, untuk semua paket tarif Anda harus
unik. Jika Anda ingin menyimpan tanggal mulai awal yang dicatat untuk
developer, tetapkan tanda keepOriginalStartDate
ke true
. Flag ini
ditetapkan secara default ke false
.
Untuk mengetahui informasi selengkapnya tentang setelan konfigurasi, lihat Setelan konfigurasi untuk paket tarif.
Misalnya, permintaan berikut akan membuat paket tarif mendatang:
$ curl -H "Content-Type:application/json" -X POST -d \ '{ "parentRatePlan": { "id": "monetization_package_flat_rate_card_plan_1379513833409" }, "name": "Flat rate card plan", "developer":null, "developerCategory":null, "advance": "false", "currency": { "id" : "usd" }, "description": "Flat rate card plan", "displayName" : "Flat rate card plan", "frequencyDuration": "30", "frequencyDurationType": "DAY", "earlyTerminationFee": "10", "monetizationPackage": { "id": "location" }, "organization": { "id": "{org_name}" }, "paymentDueDays": "30", "prorate": "false", "published": "true", "ratePlanDetails": [ { "currency": { "id" : "usd" }, "paymentDueDays": "30", "meteringType": "UNIT", "organization": { "id": "myorg" }, "ratePlanRates": [ { "type": "RATECARD", "rate": "0.05", "startUnit": "0" } ], "ratingParameter": "VOLUME", "type": "RATECARD" }], "recurringStartUnit": 1, "recurringType": "CALENDAR", "recurringFee": "10", "setUpFee": "10", "startDate": "2014-01-01 00:00:00", "type": "STANDARD" }' \ "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans/monetization_package_flat_rate_card_plan_1379513833409/revision" \ -u email:password