Tüm Ürünler
Search
Belge Merkezi

API Gateway:Configure the Host header

Son Güncelleme:Oct 04, 2026

API Gateway'in istekleri hangi arka uç uygulamasına yönlendireceğini kontrol etmek için Host üstbilgisini yapılandırın ve arka uç kurulumunuza uygun yöntemi seçin.

Host üstbilgisi nasıl çalışır

Host üstbilgisi, birden fazla uygulama aynı sunucu IP adresini paylaştığında API Gateway'in isteği hangi arka uç uygulamaya veya siteye yönlendireceğini belirler. Yaygın bir senaryo:

  • Arka uç hizmeti sanal özel cloud (VPC) türündedir ve ilişkili VPC içinde birden fazla uygulama veya site çalışır. Host üstbilgisi, isteğin hangisine iletileceğini tanımlar.

Host üstbilgisini ne zaman yapılandırmalısınız: Yalnızca arka ucunuz sanal ana bilgisayar tabanlı yönlendirme kullanıyorsa (tek bir IP arkasında birden fazla uygulama). Arka ucunuz özel bir sunucuyaysa varsayılan davranış genellikle yeterlidir; API Gateway, Host üstbilgisini yapılandırdığınız arka uç adresine ayarlar.

API Gateway beş yapılandırma yöntemi sunar. Birden fazla yöntem etkin olduğunda, hangisinin geçerli olacağını aşağıdaki öncelik sırası belirler:


Öncelik


Yöntem


1 (en yüksek)


Arka uç yönlendirme eklentisi (httpTargetHostName / vpcTargetHostName)


2


Arka uç hizmeti yapılandırması


3


VPC erişim yetkilendirmesi


4


API grubu yapılandırması (Pass Host Header)


5 (en düşük)


API tanımı (sabit host parametresi)

Host üstbilgisini yapılandırın

Arka uç kurulumunuza uygun yöntemi seçin ve ilgili adımları izleyin.

Yöntem 1: API grubu için Pass Host Header özelliğini etkinleştirin

Bu seçenek, yapılandırdığınız arka uç adresini kullanmak yerine istemcinin orijinal Host üstbilgisini arka uca iletir.

Varsayılan davranış (Pass Host Header kapalı):

Host: backend.test.com   ← API Gateway uses your configured backend address

Pass Host Header açıkken:

Host: apigateway.test.com   ← API Gateway forwards the client's original Host header

Etkinleştirmek için:

  1. API Gateway konsoluna giriş yapın.

  2. Sol gezinme bölmesinde API Management > API Groups seçeneğini seçin.

  3. Hedef API grubunuzun adına tıklayın.

  4. Pass Host Header anahtarını bulun ve açın.

Yöntem 2: API tanımına host sabit parametresini ekleyin

Bir API oluştururken host adlı bir sabit parametre ekleyin. Parameter Location değerini Head olarak ayarlayın ve parametre değeri olarak arka uç alan adını girin.

Yöntem 3: VPC erişim yetkilendirmesi için Host parametresini yapılandırın

  1. API Gateway konsoluna giriş yapın.

  2. Sol gezinme bölmesinde API Management > VPC Access Authorizations seçeneğini seçin.

  3. Sağ üst köşede Create Authorization seçeneğine tıklayın.

  4. VPC'nin bulunduğu bölgeyi seçin ve ardından Create Authorization seçeneğine tıklayın.

  5. Create VPC Access Authorization iletişim kutusunda aşağıdaki parametreleri yapılandırın:

    • Region

    • VPC Authorization Name: 4 ila 50 karakter

    • VPC ID

    • Instance ID or Address: ECS veya SLB örnek kimliklerini, özel IP'leri veya dahili ALB alan adlarını destekler

    • Port

    • Host: Hedef Host üstbilgisi değerini girin

  6. OK seçeneğine tıklayın.

Yöntem 4: Arka uç hizmeti için bir ana bilgisayar yapılandırın

  1. API Gateway konsoluna giriş yapın.

  2. Sol gezinme bölmesinde Manage APIs > Backend Services seçeneğini seçin.

  3. Sağ üst köşede Create Backend Service seçeneğine tıklayın ve HTTP/HTTPS veya VPC türünde bir arka uç hizmeti oluşturun. Yalnızca bu iki tür ana bilgisayar yapılandırmalarını destekler.

  4. Arka uç hizmeti oluşturulduktan sonra listede bulup Actions sütunundaki Configure Backend Service and View Associated APIs seçeneğine tıklayın.

  5. Backend Service Definition sayfasında hedef ortamınızın sekmesine (örneğin Test) tıklayın.

  6. Sağ üst köşede Create seçeneğine tıklayın, ardından arka uç hizmeti URL'sini ve Host alanını tanımlayın.

Host alanı, API Gateway'in istekleri bu arka uç hizmetine iletirken gönderdiği Host üstbilgisini ayarlar.

Yöntem 5: Arka uç yönlendirme eklentisinde Host üstbilgisini yapılandırın

Host üstbilgisini ayarlamak için arka uç yönlendirme eklentisindeki httpTargetHostName veya vpcTargetHostName parametresini kullanın. Bu yöntem en yüksek önceliğe sahiptir ve diğer tüm yapılandırmaları geçersiz kılar.

Parametre ayrıntıları ve yapılandırma sözdizimi için bkz. Arka uç yönlendirme eklentileri bölüm %1,3.

Host üstbilgisi yapılandırmalarının önceliği

Host üstbilgisini birden fazla yöntem kullanarak yapılandırırsanız yapılandırmalar şu öncelik sırasına göre geçerli olur: arka uç yönlendirme eklentisi > arka uç hizmeti yapılandırması > VPC erişim yetkilendirmesi > API grubu yapılandırması > API tanımı.

Not

Bir API grubu için Pass Host Header etkinleştirildiğinde API Gateway, arka uç ana bilgisayar ayarını orijinal istemci isteğindeki Host üstbilgisiyle değiştirir. Örneğin, istemci Host: apigateway.test.com gönderirse ve yapılandırılan arka uç URL'si backend.test.com ise API Gateway isteği backend.test.com adresine değil apigateway.test.com adresine iletir.