ID region
REGION_ID
adalah kode singkat yang ditetapkan Google berdasarkan region yang Anda pilih saat membuat aplikasi. Kode ini tidak sesuai dengan negara atau provinsi, meskipun beberapa ID region mungkin tampak mirip dengan kode negara dan provinsi yang umum digunakan. Untuk aplikasi yang dibuat setelah Februari 2020, REGION_ID.r
disertakan dalam URL App Engine. Untuk aplikasi lama yang dibuat sebelum tanggal tersebut, ID region bersifat opsional dalam URL.
Pelajari ID region lebih lanjut.
Dokumen ini mencantumkan kuota dan batas sistem yang berlaku untuk App Engine.
- Kuota menentukan jumlah resource bersama yang dapat dihitung dan dapat Anda gunakan. Kuota ditentukan oleh layanan Google Cloud seperti App Engine.
- Batas sistem adalah nilai tetap yang tidak dapat diubah.
Google Cloud menggunakan kuota untuk membantu memastikan keadilan dan mengurangi lonjakan penggunaan dan ketersediaan resource. Kuota membatasi jumlah resource Google Cloud yang dapat digunakan project Google Cloud Anda. Kuota berlaku untuk berbagai jenis resource, termasuk komponen hardware, software, dan jaringan. Misalnya, kuota dapat membatasi jumlah panggilan API ke layanan, jumlah load balancer yang digunakan secara bersamaan oleh project Anda, atau jumlah project yang dapat Anda buat. Kuota melindungi komunitas pengguna Google Cloud dengan mencegah kelebihan beban layanan. Kuota juga membantu Anda mengelola resource Google Cloud Anda sendiri.
Sistem Kuota Cloud melakukan hal berikut:
- Memantau pemakaian produk dan layanan Google Cloud oleh Anda
- Membatasi pemakaian resource tersebut
- Memberikan cara untuk meminta perubahan pada nilai kuota
Pada umumnya, saat Anda mencoba menggunakan resource lebih dari kuota yang diizinkan, sistem akan memblokir akses ke resource, dan tugas yang Anda coba lakukan akan gagal.
Kuota umumnya berlaku di level project Google Cloud. Penggunaan resource di satu project tidak memengaruhi kuota yang tersedia di project lain. Dalam project Google Cloud, kuota dibagikan ke semua aplikasi dan alamat IP.
Ada juga batas sistem pada resource App Engine. Batas sistem tidak dapat diubah.
Aplikasi App Engine dapat memakai resource hingga kuota tertentu. Anda dapat melihat konsumsi harian aplikasi Anda di halaman Detail Kuota konsol Google Cloud.
Jenis kuota
Jenis kuota berikut berlaku untuk aplikasi App Engine:
- Kuota gratis memberi aplikasi Anda setiap resource secara gratis dalam jumlah tertentu. Detail
tentang kuota gratis dapat ditemukan di bagian resource di halaman
ini. Setelah aplikasi Anda melebihi kuota gratis, Anda akan ditagih
untuk penggunaan tambahan atas resource tersebut.
Hanya lingkungan standar App Engine yang menyediakan kuota gratis.
- Kuota harian melindungi integritas sistem App Engine dengan memastikan bahwa tidak ada aplikasi yang memakai resource secara berlebihan sehingga merugikan aplikasi lain. Jika melebihi batas ini, Anda akan mendapatkan error. Kuota harian diperbarui setiap hari pada tengah malam Waktu Pasifik.
- Kuota per menit melindungi aplikasi Anda agar tidak memakai semua resource-nya dalam jangka waktu yang sangat singkat, dan mencegah agar aplikasi lain tidak memonopoli resource tertentu. Jika aplikasi Anda memakai resource dengan terlalu cepat dan menghabiskan kuota per menit, kata "Terbatas" akan muncul di sebelah kuota yang sesuai pada halaman Kuota di Konsol Google Cloud. Permintaan untuk resource yang menjangkau batas maksimum per menit akan ditolak.
Project Owner dan administrator penagihan dapat mengaktifkan penagihan untuk sebuah project.
Untuk mengetahui detail tentang apa yang akan terjadi jika kuota terlampaui dan cara menangani kondisi kelebihan kuota, lihat Saat resource habis.
Tips: Kuota maksimum per menit mengakomodasi tingkat traffic yang tinggi, cukup untuk menangani lonjakan traffic dari situs Anda yang disebutkan dalam artikel berita. Jika Anda yakin bahwa kuota tertentu tidak memenuhi persyaratan ini, kirimkan masukan di issue tracker. Perlu diketahui bahwa pengajuan masukan bukanlah
permintaan untuk menambah kuota, tetapi akan membantu kami memahami kuota mana
yang kemungkinan terlalu rendah untuk kasus penggunaan
umum.
Jika Anda memperkirakan tingkat traffic yang sangat tinggi, atau karena alasan tertentu aplikasi Anda memerlukan kuota yang sangat tinggi (misalnya, karena peluncuran produk yang signifikan atau pengujian beban yang besar), sebaiknya Anda mendaftar untuk
paket dukungan.
Bagaimana resource dipulihkan
App Engine melacak penggunaan resource aplikasi Anda terhadap kuota sistem. App Engine mereset semua pengukuran resource di awal setiap hari kalender (kecuali untuk Data Tersimpan, yang selalu menunjukkan jumlah penyimpanan datastore yang digunakan).
Kuota harian diisi ulang setiap hari pada tengah malam Waktu Pasifik. Kuota per menit diperbarui setiap 60 detik.
Ketika resource habis
Jika aplikasi menghabiskan semua resource yang dialokasikan, resource tersebut akan menjadi tidak tersedia sampai kuota dipulihkan. Artinya, aplikasi Anda tidak akan berfungsi sampai kuota dipulihkan.
Untuk resource yang diperlukan guna memulai permintaan, ketika resource habis, App Engine secara default akan menampilkan kode error 403
atau 503
HTTP untuk permintaan tersebut, bukannya memanggil pengendali permintaan. Perilaku ini berlaku untuk resource Jam kerja instance.
Tips: Anda dapat mengonfigurasi aplikasi agar menampilkan halaman error kustom saat aplikasi melebihi kuota. Untuk mengetahui detailnya, lihat referensi file konfigurasi untuk Python (2.7, 3), Java, Go, PHP (5.5, 7), atau Node.js .
Untuk semua resource lainnya, jika resource habis, upaya dalam aplikasi untuk memakai
resource akan menghasilkan pengecualian. Pengecualian ini dapat dideteksi oleh aplikasi dan ditangani,
seperti dengan menampilkan pesan error yang mudah dipahami kepada pengguna. Di Python API, pengecualian ini adalah
apiproxy_errors.OverQuotaError
. Di API untuk Java, pengecualian ini adalah
com.google.apphosting.api.ApiProxy.OverQuotaException
. Di Go API, fungsi
appengine.IsOverQuota
melaporkan apakah error menunjukkan kegagalan panggilan API
karena kuota yang tersedia tidak mencukupi.
Contoh berikut menggambarkan cara mendeteksi OverQuotaError
, yang dapat dipicu oleh metode SendMessage()
jika kuota terkait email telah terlampaui:
try: mail.SendMessage(to='test@example.com', from='admin@example.com', subject='Test Email', body='Testing') except apiproxy_errors.OverQuotaError, message: # Log the error. logging.error(message) # Display an informative message to the user. self.response.out.write('The email could not be sent. ' 'Please try again later.')
Apakah aplikasi Anda melebihi batas default? Anda dapat menghubungi Cloud Customer Care untuk meminta batas throughput yang lebih tinggi. Jika memerlukan kuota email yang lebih tinggi, Anda dapat menggunakan SendGrid untuk mengirim email.
Kuota untuk lingkungan fleksibel App Engine
Saat Anda men-deploy aplikasi ke lingkungan fleksibel App Engine, beberapa resource Google Cloud akan dipakai. Anda mungkin tidak dapat memodifikasi resource ini; akan tetapi, resource ini mengurangi kuota Anda.
Misalnya, Anda dapat menemukan penggunaan resource instance layanan di halaman kuota Resource Compute Engine.Resource
Aplikasi dapat menggunakan resource berikut, bergantung pada kuota. Resource yang diukur berdasarkan batas yang dapat ditagih ditunjukkan dengan "(dapat ditagih)". Jumlah resource mewakili alokasi selama periode 24 jam.
Biaya resource tambahan tercantum di halaman Harga.
Layanan, versi, dan instance
Ada batasan jumlah layanan, versi, dan instance (untuk layanan dengan penskalaan manual) bagi setiap aplikasi. Baik lingkungan standar maupun lingkungan fleksibel memiliki batas yang sama untuk layanan dan versi. Misalnya, jika Anda memiliki versi standar dan versi fleksibel di aplikasi yang sama, versi tersebut akan diperhitungkan dalam batas yang sama.
Deskripsi | Batas |
---|---|
Layanan maksimum per aplikasi | 210 |
Versi maksimum per aplikasi | 210 * |
Instance maksimum per versi dengan penskalaan manual | 20 |
*Layanan backend, seperti layanan backend yang digunakan oleh load balancer HTTP eksternal, dapat memengaruhi batas versi maksimum Anda.
Ada juga batasan jumlah karakter di URL aplikasi Anda.Deskripsi | Batas |
---|---|
Karakter maksimum di URL Project untuk URL VERSION-dot-SERVICE-dot-PROJECT_ID |
63 |
Tidak semua project memiliki batas yang disebutkan di atas. Seiring dengan meningkatnya penggunaan Google Cloud Platform dari waktu ke waktu, batas Anda mungkin meningkat. Jika Anda memperkirakan adanya peningkatan penggunaan yang signifikan di masa mendatang, Anda dapat secara proaktif meminta penyesuaian dari halaman App Engine Quotas di Google Cloud Console.
Bucket Cloud Storage default
Bucket Cloud Storage Default memiliki kuota gratis untuk penggunaan harian seperti yang ditunjukkan di bawah ini. Anda dapat membuat bucket default gratis ini di halaman Setelan App Engine dari Konsol Google Cloud untuk project Anda.
Kuota berikut berlaku secara khusus untuk penggunaan bucket default. Baca harga bucket Cloud Storage Multi-Region untuk mengetahui deskripsi kuota ini.
Resource | Batas default |
---|---|
Data yang Disimpan Bucket Cloud Storage Default | Gratis 5 GB pertama; tidak ada maksimum |
Bucket Cloud Storage Default Operasi Class A | 20.000 operasi/hari pertama gratis; tidak ada maksimum |
Bucket Cloud Storage Default Operasi Class B | Gratis 50.000 operasi/hari pertama; tidak ada maksimum |
Traffic Keluar Jaringan Bucket Cloud Storage Default | Gratis 1 GB pertama; tidak ada maksimum |
Blobstore
Kuota berikut berlaku khusus untuk penggunaan blobstore.
- Data yang disimpan blobstore
- Jumlah total data yang disimpan di blobstore. Tersedia untuk aplikasi berbayar dan gratis.
Resource | Batas default |
---|---|
Data yang Disimpan Blobstore | Gratis 5 GB pertama; tidak ada maksimum |
Kode dan penyimpanan data statis
- Batas data statis
- Dalam semua bahasa kecuali Go, tidak boleh ada satu file data statis yang berukuran lebih besar dari 32 MB. Batas untuk Go adalah 64 MB.
- Total penyimpanan
- Kuota penyimpanan berlaku untuk jumlah total kode dan data statis yang disimpan oleh semua versi aplikasi Anda. Total ukuran kode dan file statis yang tersimpan tercantum di tabel Dasbor Utama. Ukuran masing-masing ditampilkan di layar Versi dan Backend. Aplikasi akan dikenai biaya $ 0,026 per GB per bulan untuk semua penyimpanan data statis dan kode yang melebihi 1 GB.
Firestore dalam mode Datastore (Datastore)
Kuota Data Tersimpan (dapat ditagih) mengacu pada semua data yang disimpan untuk aplikasi di Datastore dan Blobstore. Kuota lainnya di bagian "Datastore" pada layar Detail Kuota di konsol Google Cloud merujuk secara khusus ke layanan Datastore.
- Data tersimpan (dapat ditagih)
-
Jumlah total data yang disimpan dalam entity datastore dan indeks terkait, serta Blobstore.
Penting untuk diperhatikan bahwa data yang disimpan di datastore dapat menimbulkan overhead yang signifikan. Overhead ini bergantung pada jumlah dan jenis properti yang terkait, serta mencakup ruang yang digunakan oleh indeks bawaan dan kustom. Setiap entity yang disimpan di datastore memerlukan metadata berikut:
- Kunci entity, termasuk jenis, ID, atau nama kunci, serta kunci ancestor entity.
- Nama dan nilai setiap properti. Karena datastore tidak memiliki skema, nama setiap properti harus disimpan dengan nilai properti untuk entity tertentu.
- Setiap baris indeks bawaan dan kustom yang merujuk ke entity ini. Setiap baris mencakup jenis entity, sejumlah nilai properti bergantung pada definisi indeksnya, dan kunci entity.
- Jumlah indeks
- Jumlah indeks Datastore yang ada untuk aplikasi. Ini termasuk indeks yang dibuat di masa lalu dan tidak lagi muncul dalam konfigurasi aplikasi, tetapi belum dihapus. Baca halaman batas Datastore untuk mengetahui detail selengkapnya tentang batas.
- Operasi tulis
- Jumlah total operasi tulis Datastore.
- Operasi baca
- Jumlah total operasi baca Datastore.
- Operasi kecil
- Jumlah total operasi kecil Datastore. Operasi kecil mencakup panggilan untuk mengalokasikan ID Datastore atau kueri khusus kunci.
Resource | Batas default |
---|---|
Data Tersimpan (dapat ditagih) | Gratis 1 GiB; tidak ada batas maksimum.
Di luar kuota gratis, berlaku tarif penagihan. |
Jumlah Indeks | 200 |
Operasi Pembacaan Entity | Gratis 50.000; tidak ada batas maksimum.
Di luar kuota gratis, berlaku tarif penagihan. |
Operasi Penulisan Entity | Gratis 20.000; tidak ada batas maksimum.
Di luar kuota gratis, berlaku tarif penagihan. |
Operasi Penghapusan Entity | Gratis 20.000; tidak ada batas maksimum.
Di luar kuota gratis, berlaku tarif penagihan. |
Operasi Kecil | Tak terbatas |
Catatan: Operasi Datastore yang dihasilkan oleh Admin Datastore dan Viewer Datastore mengurangi kuota aplikasi Anda.
Deployment
Di setiap aplikasi App Engine, Anda dapat men-deploy hingga 10.000 kali per hari.
Saat Anda men-deploy, Cloud Build akan mem-build image container, dan menyimpan image tersebut di Artifact Registry. Anda akan dikenakan biaya jika total ruang penyimpanan yang dipakai oleh gambar melebihi paket gratis.
File
Kuota berikut berlaku untuk jumlah total file deployment aplikasi.
File | Maksimum |
---|---|
File default per aplikasi | 10.000 file Hubungi Dukungan untuk meminta penambahan. |
Jam kerja instance
Penggunaan instance ditagih berdasarkan waktu beroperasi instance, dengan tarif per jam yang ditentukan.
Ada kuota gratis terpisah untuk class instance "F" dan "B" (juga dikenal sebagai class instance "frontend" dan "backend"). Perhatikan bahwa ketika Anda menggunakan Layanan App Engine, class instance layanan akan menentukan kuota yang berlaku.
Resource | Kuota Gratis |
---|---|
Instance F1 | 28 jam kerja instance gratis per hari |
Instance B1 | 9 jam kerja instance gratis per hari |
Pencatatan jam kerja instance dimulai ketika instance mulai dijalankan dan berakhir seperti yang dijelaskan di bawah, bergantung pada jenis penskalaan yang Anda tentukan untuk instance tersebut:
- Penskalaan dasar atau otomatis: pencatatan berakhir lima belas menit setelah instance selesai memproses permintaan terakhirnya.
- Penskalaan manual: pencatatan berakhir lima belas menit setelah instance dihentikan.
Jika jumlah instance yang tidak memiliki aktivitas yang dibuat oleh App Engine melebihi jumlah maksimum yang Anda tentukan di tab Setelan Performa pada Cloud Console, kelebihan instance tidak akan menambah jam kerja instance.
Log
Logs API diukur saat data log diambil.
Alokasi penyerapan log mengacu pada log permintaan dan data log aplikasi untuk aplikasi. Logging untuk aplikasi App Engine disediakan oleh Google Cloud Observability. Lihat harga Google Cloud Observability untuk mengetahui informasi selengkapnya tentang tarif dan batasan.
Pemakaian Mail API dapat dilihat di halaman Kuota IAM.
Catatan: Untuk melihat pemakaian kuota aplikasi di halaman Kuota IAM, pastikan Layanan Pelaporan App Engine diaktifkan untuk project tersebut. Jika Anda tidak dapat mengaktifkan layanan, harap periksa izin Anda dan batasan kebijakan org constraints/serviceuser.services.
Catatan: Anda dapat mengikuti langkah-langkah yang diuraikan di halaman ini untuk meminta batas yang lebih tinggi.
App Engine menagih penggunaan email "berdasarkan pesan", dengan menghitung setiap email ke setiap penerima. Misalnya, mengirim satu email ke sepuluh penerima dihitung sebagai 10 pesan.
- Pesan yang dikirim ke nonadmin
- Total jumlah pesan yang dikirim oleh aplikasi ke admin non-aplikasi.
- Pesan yang dikirim ke admin
- Total jumlah pesan ke admin aplikasi yang telah dikirim oleh aplikasi. Batas ukuran total untuk setiap email admin, termasuk header, lampiran, dan isi adalah 16 KB.
- Data isi pesan yang dikirim
- Jumlah data yang dikirim dalam isi pesan email.
- Lampiran yang dikirim
- Total jumlah lampiran yang dikirim dengan pesan email.
- Data lampiran yang dikirim
- Jumlah data yang dikirim sebagai lampiran pada pesan email.
Resource | Batas harian default | Laju maksimum |
---|---|---|
Penerima yang dikirimi email | 100 pesan | 8 pesan/menit |
Admin yang dikirimi email | 5.000 email | 24 email/menit |
Data isi pesan yang dikirim | 60 MB | 340 KB/menit |
Lampiran yang dikirim | 2.000 lampiran | 8 lampiran/menit |
Data lampiran yang dikirim | 100 MB | 10 MB/menit |
Anda dapat menambahkan hingga maksimum 50 pengirim resmi untuk Mail API.
Mengirim email melebihi kuota email harian Anda
Jika aplikasi memerlukan kuota lebih tinggi untuk mengirim email, Anda dapat menggunakan penyedia email pihak ketiga, seperti SendGrid, Mailjet, atau Mailgun.
Permintaan
- Bandwidth keluar (dapat ditagih)
-
Jumlah data yang dikirim oleh aplikasi sebagai respons atas permintaan.
Hal ini mencakup:
- data yang ditayangkan sebagai respons terhadap permintaan aman dan permintaan tidak aman oleh server aplikasi, server file statis, atau Blobstore
- data yang dikirim dalam pesan email
- data dalam permintaan HTTP keluar yang dikirim oleh layanan URL-fetch.
- Bandwidth masuk
-
Jumlah data yang diterima oleh aplikasi dari permintaan. Setiap permintaan HTTP masuk tidak boleh lebih dari 32 MB.
Hal ini mencakup:
- data yang diterima aplikasi dalam permintaan aman dan dalam permintaan tidak aman
- upload ke Blobstore
- data yang diterima sebagai respons terhadap permintaan HTTP oleh layanan URL-fetch
- Bandwidth keluar aman
- Jumlah data yang dikirim oleh aplikasi melalui koneksi aman sebagai tanggapan terhadap permintaan.
- Bandwidth masuk aman
- Jumlah data yang diterima oleh aplikasi melalui koneksi yang aman dari permintaan.
Penelusuran
Kuota gratis untuk Penelusuran tercantum dalam tabel di bawah. Rujuk dokumentasi Java, Python, dan Go untuk mengetahui deskripsi mendetail setiap jenis panggilan Penelusuran.
Resource Search API dikenai biaya sesuai dengan tarif pada jadwal harga.
Panggilan API atau resource | Kuota Gratis |
---|---|
Total penyimpanan (dokumen dan indeks) | 0,25 GB |
Kueri | 1000 kueri per hari |
Menambahkan dokumen ke indeks | 0,01 GB per hari |
Bagian kuota konsol aplikasi menampilkan jumlah mentah permintaan API. Perhatikan bahwa saat mengindeks beberapa dokumen dalam satu panggilan, jumlah panggilan akan bertambah sesuai dengan jumlah dokumen.
Search API menerapkan batas ini untuk memastikan keandalan layanan:
- 100 menit gabungan waktu eksekusi kueri per menit, dalam aplikasi dan indeks.
- 15.000 Dokumen ditambahkan/dihapus per menit
Catatan: Meskipun batasan ini diterapkan berdasarkan menit, konsol Google Cloud menampilkan total harian untuk setiap batasan. Pelanggan dengan dukungan Silver, Gold, atau Platinum dapat meminta batas throughput yang lebih tinggi dengan menghubungi perwakilan dukungan mereka.
Antrean Tugas
Saat tugas dijalankan, permintaan yang terkait dengannya akan dihitung dalam kuota permintaan aplikasi
Batas ini berlaku untuk semua task queue:
Resource | Batas harian | Laju maksimum |
---|---|---|
Panggilan pengelolaan Task Queue (menggunakan Konsol Google Cloud) | 10.000 | t/a |
Resource | Batas default |
---|---|
Jumlah maksimum queue (termasuk push dan pull queue, tetapi bukan queue default) | 100 antrean. |
Catatan: Setelah tugas dijalankan atau dihapus, penyimpanan yang digunakannya akan dikosongkan. Kuota penyimpanan Anda diperbarui secara berkala dan mungkin tidak langsung menampilkan ruang yang diperoleh kembali. Lihat dokumentasi Python, Java, atau Go, atau PHP untuk detail selengkapnya.
Batas berikut berlaku untuk task queue sesuai dengan jenisnya:
Batas Push Queue | |
---|---|
Ukuran tugas maksimum | 100 KB |
Kecepatan eksekusi queue | 500 pemanggilan tugas per detik per queue |
Hitung mundur/PWT maksimum untuk tugas | 30 hari dari tanggal dan waktu saat ini |
Jumlah tugas maksimum yang dapat ditambahkan dalam batch | 100 tugas |
Jumlah tugas maksimum yang dapat ditambahkan dalam transaksi | 5 tugas |
Jumlah task queue maksimum default | 100 antrean. Hubungi Dukungan untuk meminta penambahan kuota. |
Cron
Kuota berikut berlaku khusus untuk Cron job.
- Cron job
- Jumlah cron job.
Resource | Batas default |
---|---|
Tugas cron | 250 cron job |
URL-Fetch
- Panggilan API URL-Fetch
- Total frekuensi aplikasi mengakses layanan URL-fetch untuk melakukan permintaan HTTP atau HTTPS.
- Data URL-Fetch yang dikirim
- Jumlah data yang dikirim ke layanan URL-fetch dalam permintaan.
- Data URL-Fetch yang diterima
- Jumlah data yang diterima dari layanan URL-fetch dalam respons. Ini juga memengaruhi kuota Bandwidth Masuk.
Resource | Batas harian | Laju maksimum |
---|---|---|
Panggilan API UrlFetch | 860.000.000 panggilan | 660.000 panggilan/menit |
Data UrlFetch yang dikirim | 4,5 TB | 3.600 MB/menit |
Data UrlFetch yang diterima | 4,5 TB | 3.600 MB/menit |