Header permintaan

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.

Gunakan halaman referensi ini untuk mengetahui detail tentang header HTTP yang didukung. Untuk memahami cara App Engine menerima permintaan dan mengirim respons, lihat Cara Penanganan Permintaan.

Header permintaan

Permintaan HTTP yang masuk menyertakan header HTTP yang dikirim oleh klien. Untuk tujuan keamanan, beberapa header dibersihkan, diubah, atau dihapus oleh proxy perantara sebelum sampai ke aplikasi.

Header yang dihapus dari permintaan masuk

Header berikut akan dihapus dari permintaan masuk jika klien mengirimkannya:

  • Header dengan nama yang cocok dengan pola X-Google-*. Pola nama ini dicadangkan untuk Google.

  • Header dengan nama yang cocok dengan header khusus App Engine. Hanya pencocokan persis yang tidak peka huruf besar/kecil yang akan dihapus. Misalnya, header bernama X-Appengine-Country atau X-AppEngine-Country akan dihapus, tetapi X-Appengine-Cntry tidak.

Header khusus App Engine

Sebagai layanan ke aplikasi, App Engine menambahkan header berikut ke semua permintaan:

X-Appengine-Country
Negara tempat permintaan berasal, sebagai kode negara ISO 3166-1 alpha-2. App Engine menentukan kode ini dari alamat IP klien. Perlu diperhatikan bahwa informasi negara tidak berasal dari database WHOIS; ada kemungkinan bahwa alamat IP yang memiliki informasi negara di database WHOIS tidak akan memiliki informasi negara di header X-Appengine-Country. Aplikasi Anda harus menangani kode negara khusus ZZ (negara tidak diketahui).
X-Appengine-Region
Nama region tempat permintaan berasal. Nilai ini hanya berlaku dalam konteks negara di X -Appengine-Country. Misalnya, jika negaranya adalah "US" dan region-nya adalah "ca", maka "ca" berarti "California", bukan Kanada. Daftar lengkap nilai region yang valid dapat ditemukan di standar ISO-3166-2.
X-Appengine-City
Nama kota tempat permintaan berasal. Misalnya, permintaan dari kota Mountain View mungkin memiliki nilai header mountain view. Tidak ada daftar kanonis nilai valid untuk header ini. Jika kota tidak dapat diselesaikan, nilai header akan ditetapkan ke ?.
X-Appengine-CityLatLong
Lintang dan bujur kota tempat permintaan berasal. String ini mungkin terlihat seperti "37.386051,-122.083851" untuk permintaan dari Mountain View. Jika kota tidak dapat diselesaikan, nilai header ditetapkan ke 0.000000,0.000000.
X-Cloud-Trace-Context
ID unik untuk permintaan yang digunakan untuk Cloud Trace dan Cloud Logging. Tidak ada opsi untuk menonaktifkan header ini atau memilih frekuensi sampling untuk pelacakan karena semua aplikasi lingkungan standar App Engine akan dilacak secara otomatis.
X-Forwarded-For: [CLIENT_IP(s)], [global forwarding rule IP]

Daftar alamat IP yang dipisahkan koma yang digunakan untuk merutekan permintaan klien. IP pertama dalam daftar ini umumnya adalah IP klien yang membuat permintaan. IP berikutnya memberikan informasi tentang server proxy yang juga menangani permintaan sebelum mencapai server aplikasi. Misalnya:

X-Forwarded-For: clientIp, proxy1Ip, proxy2Ip
X-Forwarded-Proto [http | https]

Menampilkan http atau https berdasarkan protokol yang digunakan klien untuk terhubung ke aplikasi Anda.

Load Balancer Google Cloud menghentikan semua koneksi https, lalu meneruskan traffic ke instance App Engine melalui http. Misalnya, jika pengguna meminta akses ke situs Anda melalui https://PROJECT_ID.REGION_ID.r.appspot.com, nilai header X-Forwarded-Proto adalah https.

Selain itu, App Engine dapat menetapkan header berikut untuk penggunaan internal oleh App Engine:

  • X-Appengine-Https
  • X-Appengine-User-IP
  • X-Appengine-Api-Ticket
  • X-Appengine-Request-Log-Id
  • X-Appengine-Default-Version-Hostname
  • X-Appengine-Timeout-Ms