Halaman ini berlaku untuk Apigee dan Apigee Hybrid.
Lihat dokumentasi
Apigee Edge.
Organisasi adalah penampung tingkat teratas di Apigee. Organisasi Apigee berisi semua proxy API dan resource terkait Anda. Meskipun bagian selanjutnya dari topik ini membahas organisasi secara lebih mendalam, berikut beberapa poin praktisnya:
- Organisasi Apigee berbeda dari dan merupakan anak perusahaan organisasi Google Cloud. Saat Anda membuat organisasi untuk Apigee X atau Apigee Hybrid, organisasi tersebut dipetakan ke tepat satu project Google Cloud, dan organisasi Apigee serta project Google Cloud memiliki nama yang sama. Tidak semua project Google Cloud memiliki organisasi Apigee terkait.
- Jika dokumentasi Apigee menggunakan istilah "organisasi", istilah tersebut secara khusus merujuk pada organisasi Apigee. Dokumentasi Apigee menggunakan frasa "organisasi Google Cloud" untuk merujuk pada alternatif tersebut.
- Setelah dibuat, Anda tidak dapat mengganti nama organisasi Apigee.
- Nama organisasi Apigee Anda ditampilkan sebagai project di URL untuk bagian Apigee di the Google Cloud console.
Contoh:
https://console.cloud.google.com/apigee/overview?project=ORG_ID
- Saat Anda memanggil REST API Apigee, ID organisasi adalah bagian yang wajib ada di
jalur. Misalnya, permintaan
curl
berikut menampilkan daftar semua proxy API dalam organisasi menggunakan API organisasi:curl https://apigee.googleapis.com/v1/organizations/ORG_ID/apis
- Meskipun Anda hanya membuat satu organisasi, Anda dapat diberi otorisasi di organisasi lain sebagai pengguna atau administrator dengan izin tertentu. Di konsol cloud, Anda dapat beralih ke organisasi lain seperti yang dijelaskan dalam Beralih antar-organisasi Anda.
Video: Tonton video singkat untuk mempelajari cara organisasi mendukung arsitektur multi-tenant untuk pengelolaan API.
Jenis organisasi
Ada dua jenis organisasi:
Berbayar: Organisasi permanen dengan skalabilitas penuh. Juga dikenal sebagai organisasi produksi. Organisasi berbayar mencakup organisasi yang dibuat sebagai bagian dari model harga Apigee Berlangganan atau Bayar sesuai penggunaan.
Evaluasi: Organisasi sementara layanan mandiri untuk menguji Apigee. Terkadang disebut sebagai organisasi evaluasi, organisasi ini memiliki batas waktu dan tidak memiliki skalabilitas dan fleksibilitas organisasi produksi.
Lihat juga Membandingkan organisasi evaluasi dan berbayar.
Masa aktif organisasi evaluasi
Masa berlaku organisasi evaluasi terbatas:
- Hari ke-0: Buat organisasi evaluasi.
- Hari ke-30: Google mengirimkan email notifikasi yang memperingatkan tentang masa berlaku yang akan segera berakhir.
- Hari ke-60: Google menghapus organisasi evaluasi.
Organisasi Apigee dalam hierarki Google Cloud
Diagram berikut menunjukkan hubungan antara organisasi dan lingkungan Apigee, serta project dan folder Google Cloud.
Komponen dalam organisasi
Gambar berikut menunjukkan komponen utama model organisasi Apigee. Model ini menentukan hubungan antara API, produk API, aplikasi, dan developer aplikasi Anda dalam Apigee.
Model ini tidak menampilkan semua fitur Apigee, tetapi dimaksudkan untuk menunjukkan bahwa organisasi adalah root deployment.
Tabel berikut menjelaskan komponen model organisasi secara lebih mendetail:
Komponen | Deskripsi |
---|---|
Organisasi |
Setiap organisasi Apigee termasuk dalam tepat satu project Google Cloud, dan sebuah project dapat berisi paling banyak satu organisasi. Organisasi berisi lingkungan, proxy API, produk API, paket API, aplikasi, dan pengguna. Pemegang akun tidak dibatasi untuk satu organisasi. Beberapa pemegang akun mungkin menentukan atau menjadi anggota beberapa organisasi yang mendukung komunitas developer aplikasi yang berbeda. |
Lingkungan dan grup lingkungan | Lingkungan adalah lingkungan software terisolasi, dalam organisasi, tempat Anda men-deploy proxy API. Anda dapat membuat beberapa lingkungan dalam organisasi. Grup lingkungan adalah grup lingkungan dengan satu atau beberapa nama host. Nama host adalah bagian dari URL yang digunakan untuk memanggil proxy API yang di-deploy ke lingkungan mana pun dalam grup lingkungan. |
Proxy API |
Proxy API adalah antarmuka antara permintaan masuk dan layanan backend. Entitas proxy berisi petunjuk dan kebijakan yang dijalankan Apigee saat memproses permintaan dari klien dan respons dari backend. |
Produk API |
Entitas untuk memublikasikan API. Produk API dipublikasikan ke portal developer untuk digunakan oleh developer eksternal. Produk API menyajikan antarmuka untuk mengakses satu atau beberapa API yang dipublikasikan. Antarmuka (yang dapat dijelaskan menggunakan spesifikasi OpenAPI) dapat mencakup kombinasi satu atau beberapa permintaan API yang ditangani oleh satu atau beberapa proxy API. Pengguna dalam organisasi membuat produk API. Dengan demikian, mereka dapat melampirkan metadata arbitrer ke setiap Produk API. Salah satu jenis metadata yang umum digunakan dapat menentukan paket layanan, yang dapat menentukan batas akses pada panggilan API, menetapkan persyaratan keamanan, memungkinkan pemantauan dan analisis, serta menyediakan fitur tambahan. Apigee mengumpulkan data untuk analisis tentang produk API. |
Penyedia API |
Orang atau entitas yang membuat dan mengelola proxy dan produk API. Developer aplikasi klien mengakses API yang dipublikasikan ini. |
Developer Aplikasi |
Organisasi berisi satu atau beberapa developer yang membangun aplikasi yang menggunakan API (dipublikasikan sebagai produk API) yang ditentukan oleh organisasi Anda. Developer menggunakan API, tetapi tidak dapat membuat API atau melakukan tindakan lain di organisasi. Developer dapat berasal dari internal perusahaan Anda, partner, atau developer eksternal yang mungkin atau mungkin tidak membayar untuk mengakses API Anda. Anda dapat menganggap developer sebagai pelanggan yang menggunakan API Anda. Developer harus terdaftar di organisasi Anda sebelum mereka dapat mendaftarkan aplikasi dan menerima kunci API atau kredensial klien lainnya yang memungkinkan akses ke API Anda. Sebagai penyedia API, Anda yang menentukan cara menambahkan, memperbarui, atau menghapus developer di organisasi Anda. Anda dapat menambahkannya secara manual melalui UI, membuat portal developer untuk mendaftarkannya melalui situs, atau menentukan dan menerapkan mekanisme pendaftaran Anda sendiri dengan menggunakan Apigee API. |
Aplikasi Apigee (atau Aplikasi) |
Developer Apigee membuat satu atau beberapa aplikasi klien yang menggunakan API Anda. Developer yang membuat aplikasi klien yang memanggil API yang memerlukan pemeriksaan kredensial (seperti kunci API atau token OAuth) harus membuat Pendaftaran aplikasi terlebih dahulu dengan organisasi Anda. Pendaftaran Aplikasi memberi developer kunci API, pasangan kunci/secret, atau kredensial lain yang harus digunakan saat aplikasi klien memanggil API Anda. Karena semua aplikasi terdaftar di organisasi Anda, Anda dapat menggunakan Apigee untuk memantau dan mengumpulkan informasi analisis tentang aplikasi dan penggunaannya atas API Anda. |
Komponen tambahan Apigee yang tidak ditampilkan adalah kunci API dan token OAuth.
Apigee mendukung berbagai jenis autentikasi, seperti kunci API sederhana, OAuth dua kaki, OAuth tiga kaki, dan lainnya.
Jika penyedia API menentukan verifikasi kunci API sebagai mekanisme otorisasi, aplikasi klien harus meneruskan kunci API dengan setiap permintaan ke API Anda. Jika kunci tersebut valid, Apigee akan mengizinkan permintaan. Atau, jika penyedia API menentukan verifikasi token OAuth sebagai mekanisme otorisasi, aplikasi klien harus mendapatkan token OAuth terlebih dahulu, lalu meneruskan token tersebut dengan setiap permintaan ke API Anda. Jika token tersebut valid, Apigee akan mengizinkan permintaan. Skema otorisasi kustom lainnya juga dapat digunakan.
Sebagai penyedia API, Anda harus menentukan cara bagi developer untuk mendaftarkan aplikasi mereka. Setiap pendaftaran aplikasi akan memiliki satu atau beberapa kunci atau kredensial yang terkait dengannya. Jika Anda mengizinkan developer mendaftarkan aplikasi mereka sendiri melalui portal developer, developer dapat mengambil kunci atau kredensial yang diperlukan untuk mengakses API Anda, melalui pengalaman layanan mandiri yang mudah.
Pada saat pendaftaran aplikasi, developer dapat memilih untuk mengakses satu produk API atau beberapa produk API. Aplikasi developer menggunakan kunci/kredensial yang sama untuk mengakses semua produk API yang terkait dengan aplikasi.
Kapan saja, Anda dapat mencabut kunci sehingga aplikasi developer tidak lagi memiliki akses ke API Anda (meskipun representasi terdaftar aplikasi developer masih ada di organisasi Anda). Atau, Anda dapat mencabut akses developer, yang dalam hal ini semua kredensial untuk aplikasi apa pun yang terdaftar untuk developer tersebut tidak dapat dioperasikan. Pencabutan dapat dibatalkan. Pada saat Apigee membuat kredensial aplikasi, Anda dapat menentukan masa berlaku agar developer harus mendapatkan kunci atau kredensial baru setelah waktu tertentu.
Pengguna Apigee
Pengguna Apigee membentuk tim API organisasi, yang dapat mencakup orang-orang seperti administrator, pembuat proxy API dan produk API, atau pengguna yang memantau analisis dan statistik lainnya. Pengguna akhir adalah orang yang menggunakan aplikasi yang dibuat oleh developer Apigee. Dalam sebagian besar kasus, dokumentasi ini menggunakan istilah "pengguna" untuk merujuk pada pengguna Apigee.
Administrator dapat menambahkan pengguna ke organisasi.
Pengguna yang berbeda dapat memiliki peran dan hak istimewa akses yang berbeda. Misalnya, tetapkan beberapa pengguna sebagai Administrator Organisasi dan Administrator Operasi dengan hak istimewa untuk mengubah organisasi dan komponennya, serta tetapkan pengguna lain dengan izin untuk membuat proxy API dan produk API, tetapi tanpa hak istimewa untuk mengubah pengguna lain.
Pengguna dapat menjadi anggota beberapa organisasi. Misalnya, perusahaan Anda dapat menentukan beberapa organisasi di Apigee untuk mendukung komunitas developer yang berbeda, meskipun secara internal, orang yang sama membangun semua proxy API dan produk API, sehingga mereka menjadi anggota semua organisasi Anda.
Anda tidak harus membuat organisasi Apigee untuk menjadi pengguna. Administrator dapat menambahkan Anda ke organisasi yang sudah ada.
Di Google Cloud console, buka halaman Apigee.
Hak dan penagihan
Baik organisasi berbayar menggunakan model harga Langganan atau Bayar sesuai penggunaan, item yang diukur untuk tujuan penagihan adalah: lingkungan, panggilan API, dan deployment proxy.
Paket langganan memungkinkan Anda membayar di muka untuk hak, dengan imbalan diskon yang signifikan. Paket langganan lebih masuk akal pada volume penggunaan yang lebih tinggi - dengan jumlah lingkungan yang lebih besar, volume panggilan API yang tinggi, atau sejumlah besar proxy API yang dikelola oleh Apigee. Dengan model Bayar sesuai penggunaan, Anda hanya membayar resource yang Anda gunakan, tetapi Anda tidak menikmati diskon volume.
Hak langganan
Organisasi |
Anda dapat mengaktifkan Apigee di project Google Cloud mana pun. Dengan melakukannya, organisasi Apigee akan dibuat untuk project tersebut. Anda dapat membuat organisasi sebanyak yang Anda inginkan. Sama seperti tidak ada hak atau biaya yang diperlukan untuk membuat project Google Cloud, tidak ada persyaratan hak untuk membuat organisasi Apigee. |
---|---|
Lingkungan |
Hak untuk Lingkungan dinyatakan dalam unit. Ada proses dua langkah untuk menggunakan hak unit lingkungan: pertama, Anda membuat lingkungan, lalu melampirkan lingkungan tersebut ke organisasi. Lingkungan dihitung berdasarkan hak unit lingkungan Anda jika lingkungan telah dilampirkan ke organisasi. Lihat Batas untuk jumlah maksimum lingkungan dalam satu organisasi. Anda dapat memilih untuk membuat lingkungan Apigee di satu atau beberapa region Google Cloud yang tersedia. Setiap region yang dipetakan ke lingkungan menggunakan satu unit lingkungan dari hak Anda. Lingkungan yang disediakan di satu region menggunakan satu unit lingkungan dari hak Anda. Lingkungan yang disediakan di dua region menggunakan dua unit lingkungan dari hak Anda. Total penggunaan unit lingkungan adalah gabungan dari jumlah unit lingkungan yang digunakan di semua organisasi. Total hak unit lingkungan Anda adalah jumlah hak yang diberikan di Tingkat langganan ditambah hak tambahan yang diperoleh melalui Paket Lingkungan. Google menerapkan hak untuk lingkungan; Anda tidak dapat melampaui batas hak. Jika Anda mencoba membuat lingkungan yang melebihi batas hak, Anda akan menerima error. Anda dapat memperluas hak Anda dengan membeli Paket Lingkungan tambahan. |
Panggilan API |
Google menghitung setiap panggilan API yang diproses oleh Apigee. Total hak panggilan API Anda adalah jumlah hak yang diberikan di tingkat Langganan Anda ditambah hak tambahan yang diperoleh melalui Paket Panggilan. Dalam paket Langganan, Google tidak menerapkan batas hak untuk panggilan API. Jika Anda melampaui hak panggilan API, Apigee akan terus melayani panggilan API. Google menagih Anda atas penggunaan yang melebihi hak yang ada. Anda dapat memperluas hak panggilan API kapan saja dengan membeli Paket Panggilan tambahan. |
Deployment Proxy |
Google menghitung setiap proxy API yang Anda deploy. Total hak penayangan proxy Anda adalah jumlah hak yang diberikan dalam Tingkat langganan Anda ditambah hak tambahan yang diperoleh melalui Paket Penayangan Proxy. Dalam paket Langganan, Google tidak membatasi deployment proxy untuk hak Anda. Jika Anda men-deploy lebih banyak proxy daripada yang diizinkan oleh hak Anda, sehingga melebihi hak deployment proxy, Apigee akan terus mengizinkan Anda men-deploy proxy baru, dan Apigee akan terus melayani panggilan API. Google akan menagih Anda untuk penggunaan Anda yang melebihi hak yang ada. Anda dapat memperluas hak Proxy Deployment dengan membeli Paket Panggilan tambahan. |
Untuk mengetahui detail selengkapnya, lihat Hak langganan.
Hak bayar sesuai penggunaan
Organisasi |
Anda dapat mengaktifkan Apigee di project Google Cloud mana pun. Dengan melakukannya, organisasi Apigee akan dibuat untuk project tersebut. Anda dapat membuat organisasi sebanyak yang Anda inginkan. Sama seperti tidak ada biaya untuk membuat project Google Cloud, berdasarkan model harga Bayar sesuai penggunaan, tidak ada biaya untuk membuat organisasi Apigee. |
---|---|
Lingkungan |
Anda dapat melampirkan beberapa lingkungan ke organisasi Apigee. Ada proses dua langkah untuk menggunakan lingkungan: pertama, Anda membuat lingkungan, lalu Anda melampirkan lingkungan tersebut ke organisasi. Google menagih Anda untuk lingkungan yang terlampir ke organisasi. Anda dapat membuat hingga 85 lingkungan dalam satu organisasi. Untuk lingkungan multi-region, Google akan menagih Anda untuk setiap region tempat lingkungan tersedia. Anda dapat memilih salah satu region Google Cloud yang tersedia. |
Panggilan API |
Google menghitung setiap panggilan API yang diproses oleh Apigee. Google menagih Anda berdasarkan jumlah panggilan API yang diproses oleh lingkungan Apigee Anda. Tidak ada batasan. Apigee menskalakan otomatis dan terus melayani panggilan API, bahkan saat beban meningkat. |
Deployment Proxy |
Google menghitung setiap proxy API yang Anda deploy. Google menagih Anda untuk jumlah proxy API yang di-deploy di lingkungan Apigee Anda. |
Untuk mengetahui detail selengkapnya, lihat Hak penggunaan bayar sesuai penggunaan.