Kuota dan batas

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 quotas dan quotas yang berlaku untuk App Engine.

Kuota membatasi jumlah resource Google Cloud bersama yang dapat digunakan project Google Cloud Anda, termasuk komponen hardware, software, dan jaringan. Oleh karena itu, kuota adalah bagian dari sistem yang melakukan hal berikut:

  • Memantau penggunaan atau pemakaian produk dan layanan Google Cloud oleh Anda.
  • Membatasi Anda konsumsi resource tersebut, karena alasan yang mencakup memastikan keadilan dan mengurangi lonjakan penggunaan.
  • Mempertahankan konfigurasi yang secara otomatis menerapkan pembatasan yang telah ditentukan.
  • Menyediakan sarana untuk meminta atau membuat perubahan pada kuota.

Pada umumnya, jika kuota terlampaui, sistem akan langsung memblokir akses ke resource Google yang relevan, dan tugas yang Anda coba lakukan akan gagal. Pada umumnya, kuota berlaku untuk setiap project Google Cloud serta digunakan bersama oleh semua aplikasi dan alamat IP yang menggunakan project Google Cloud tersebut.

Ada juga batas untuk resource App Engine. Batasan ini tidak terkait dengan sistem kuota. Batasan tidak dapat diubah kecuali jika dinyatakan lain.

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.

Referensi

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

Jumlah layanan dan versi maksimum yang dapat di-deploy bergantung pada harga aplikasi Anda. Lingkungan fleksibel dan lingkungan standar 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.

Batas Aplikasi gratis Aplikasi berbayar
Layanan maksimum per aplikasi 5 210
Versi maksimum per aplikasi 15 210

Ada juga batasan jumlah instance untuk setiap layanan dengan penskalaan dasar atau manual:

Instance maksimum per versi penskalaan manual/dasar
Aplikasi gratis Aplikasi berbayar Amerika Serikat Aplikasi berbayar Uni Eropa
20 25 (200 untuk us-central) 25
Ada juga batas jumlah karakter di URL aplikasi Anda.
Deskripsi Batas
Karakter maksimum di URL Project untuk URL VERSION-dot-SERVICE-dot-PROJECT_ID 63

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 membangun image container yang disimpan di Container 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 Kemampuan Observasi Google Cloud. Lihat Harga Kemampuan observasi Google Cloud untuk mengetahui informasi selengkapnya tentang tarif dan batas.

Email

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.

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.

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
Selain itu, ada batas penyimpanan sebesar 10 GB per indeks. Jika aplikasi mencoba melebihi jumlah ini, error kuota tidak memadai akan ditampilkan. Batas ini dapat ditingkatkan hingga 200 GB dengan mengirimkan permintaan dari halaman App Engine Search konsol Google Cloud.

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 maksimum100KB
Kecepatan eksekusi queue500 pemanggilan tugas per detik per queue
Hitung mundur/PWT maksimum untuk tugas30 hari dari tanggal dan waktu saat ini
Jumlah tugas maksimum yang dapat ditambahkan dalam batch100 tugas
Jumlah tugas maksimum yang dapat ditambahkan dalam transaksi5 tugas
Jumlah task queue maksimum default100 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