Tüm Ürünler
Search
Belge Merkezi

API Gateway:Backend internal DNS resolution (dedicated instances only)

Son Güncelleme:Oct 04, 2026

Dahili alan adı, API Gateway'de yapılandırdığınız bir arka uç hizmetinin adresidir. Bir arka uç hizmet dahili bir alan adı kullanıyorsa API Gateway bu ad için örnek düzeyinde DNS çözümlemesi yapar.

Genel Bakış

Örneğin, arka uç hizmetinizin dahili alan adı PrivateZone kullanılarak çözümleniyorsa çözümleme yalnızca belirtilen VPC içinde geçerlidir. API Gateway VPC'nizde bulunmadığından dahili alan adını çözümleyemez. Dahili alan adına erişimi etkinleştirmek için API Gateway'de dahili DNS çözümlemesini yapılandırın. VPC entegrasyon örneği için her bir DNS kaydına trafik dağıtımı amacıyla ağırlık da atayabilirsiniz. Aşağıdaki şekilde işlem akışı gösterilmektedir.

image

Adım 1: Dahili DNS çözümlemesini yapılandırma

1. Dahili DNS kaydı oluşturma

  1. API Gateway konsolu oturumunu açın. Sol gezinme bölmesinde Instances and Clusters seçeneğini tıklayın ve Dedicated Instances öğesini seçin.

  2. Dahili DNS kayıtlarını yönetmek için Internal DNS Resolution sekmesini tıklayın.

  3. Sayfanın sağ üst köşesinde Add DNS Record seçeneğini tıklayın. Instance Type değerini ve hedef Instance öğesini belirtin; ardından Internal Domain Name bilgisini girin. VPC entegrasyon örneği için Record Value ve Weight ayarlarını da yapılandırmanız gerekir. Geleneksel özel örneklerde dahili alan adının vpc access authorization içindeki Host değeriyle eşleştiğinden emin olun.

    Önemli

    Ağırlık 0 ile 100 arasında bir değer olarak atanabilir. Örneğin iki IP adresinin ağırlıkları sırasıyla 1 ve 2 ise trafik bu adreslere 1:2 oranında dağıtılır. Ağırlığı 0 olarak ayarlarsanız ilgili IP adresine hiçbir trafik yönlendirilmez.

İletişim kutusunda Record Type varsayılan olarak A (maps a domain name to an IPv4 address) olarak gelir. DNS kaydını ekledikten veya güncelledikten sonra değişiklikler yaklaşık 10 dakika içinde etkili olur.

2. Dahili DNS kaydını değiştirme

Mevcut bir kaydın Record Value ve Weight değerlerini değiştirmek için İşlemler sütununda Edit seçeneğini tıklayın.

Not

Dahili DNS kaydını ekledikten veya değiştirdikten sonra değişiklikler yaklaşık 10 dakika içinde etkili olur.

Adım 2: Özel örnekle ilişkilendirme

Bir dahili DNS kaydını özel bir örnekle iki farklı yöntemle ilişkilendirebilirsiniz.

Oluşturma sırasında ilişkilendirme

Dahili bir DNS kaydı oluştururken Instance açılan listesinden hedef örneği seçin. Kayıt otomatik olarak seçilen özel örnekle ilişkilendirilir.

Örnek listesinden ilişkilendirme

  1. API Gateway konsolu oturumunu açın. Sol gezinme bölmesinde Instances and Clusters seçeneğini tıklayın ve Dedicated Instances öğesini seçin.

  2. Instances sekmesini tıklayın. Örnek ayrıntılarının Associated Internal Domain Name Resolutions bölümünde Associate seçeneğini tıklayın. Açılan iletişim kutusunda ilişkilendirmek istediğiniz dahili DNS kaydını seçin.

Not

Özel bir örneği dahili bir DNS kaydıyla ilişkilendirdikten veya kaydın değerini ya da ağırlığını güncelledikten sonra değişiklikler yaklaşık 10 dakika içinde etkili olur.

Kullanım notları

Bir dahili DNS kaydı özel bir örnekle ilişkilendirildiğinde söz konusu örnekten belirtilen dahili alan adına yapılan tüm istekler kayıtta yapılandırılan IP adresine çözülür. Bu durum alan adı için genel DNS çözümlemesini geçersiz kılar.

VPC entegrasyon örnekleri

  • Dahili alan adı kullanan HTTP tabanlı arka uç hizmetleri için mutlaka dahili DNS kaydı yapılandırmanız gerekir; aksi takdirde API Gateway alan adını çözümleyemez.

  • Kayıt değeri, arka uç hizmetinin VPC'sindeki erişilebilir bir CIDR bloğu içinde yer alan bir IP adresi olmalıdır.

  • Tek bir IP adresi içeren ve ağırlığı 0 olan dahili DNS kaydı etkisizdir çünkü IP adresine herhangi bir trafik iletilmez.

Geleneksel özel örnekler

Geleneksel özel örnek kullanırken dahili DNS kaydındaki dahili alan adının vpc access authorization içinde yapılandırılan Host değeriyle eşleştiğinden emin olun. API Gateway, vpc access authorization içinde tanımlanan hizmete HTTPS isteği gönderirken TLS el sıkışmasındaki Sunucu Adı Göstergesini (SNI) yapılandırılan Host değerine ayarlar.

Not

Geleneksel özel örnek HTTPS üzerinden vpc access authorization kullanır ancak dahili DNS kaydı yapılandırılmamışsa TLS el sıkışması sırasında SNI gönderilmez.

Sınırlamalar

  • Bu özellik yalnızca özel örnekler için kullanılabilir.

  • Her bölgede en fazla 100 dahili DNS kaydı oluşturabilirsiniz.

  • Bir dahili DNS kaydı aynı türdeki birden çok özel örnekle ilişkilendirilebilir.

  • Dahili DNS kayıtları özel örnek kümesiyle ilişkilendirilemez.

  • VPC entegrasyon örneği için:

    • Yalnızca alan adını bir IPv4 adresiyle eşleyen A kayıtları desteklenir.

    • Bir dahili alan adı için en fazla 20 A kaydı yapılandırabilirsiniz.

  • Geleneksel özel örnek için:

    • Yalnızca vpc access authorization türündeki dahili DNS kayıtları desteklenir.

    • Kayıt değeri ekleyemezsiniz. Trafik varsayılan olarak VPC erişim yetkilendirmesi tarafından eşlenen IP adresine yönlendirilir.