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.

Oke

Dokumen ini mencantumkan kuota dan batas sistem yang berlaku untuk App Engine. Kuota menentukan jumlah resource bersama yang dapat dihitung dan dapat Anda gunakan, dan 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 untuk 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='[e-mail]', from='[e-mail]',
            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.

Perhatian: Container Registry tidak digunakan lagi dan dijadwalkan untuk dihentikan. Organisasi yang belum menggunakan Container Registry sebelum 8 Januari 2024 memiliki repositori gcr.io baru yang dihosting di Artifact Registry secara default. Mulai 15 Mei 2024, project Google Cloud yang sebelumnya tidak menggunakan Container Registry hanya akan mendukung hosting dan pengelolaan image untuk domain gcr.io di Artifact Registry.

Container Registry dijadwalkan untuk dihentikan pada 18 Maret 2025. Untuk mengetahui detail penghentian penggunaan ini, lihat Penghentian penggunaan Container Registry.

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.

Penting: Saat melihat tagihan, Anda tidak akan melihat nama setiap class instance di item baris penagihan. Sebagai gantinya, Anda melihat jam kerja instance dari class "B" yang dilaporkan sebagai "Backend Instance", dan jam kerja instance dari class "F" yang dilaporkan sebagai "Frontend Instance". Tagihan tersebut akan menerapkan kelipatan jam kerja instance yang sesuai untuk setiap class instance yang Anda gunakan. Misalnya, jika menggunakan instance F4 selama satu jam, Anda akan melihat penagihan "Frontend Instance" untuk empat jam kerja instance pada tarif F1.

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.

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.

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.

Catatan: Bandwidth keluar adalah resource yang dapat ditagih, yang mencakup permintaan HTTP/HTTPS. Gratis 1 GB pertama bandwidth keluar per hari. Tidak ada batas harian atau kuota maksimum untuk bandwidth keluar atau masuk.

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

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 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