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.

Adım 1: Dahili DNS çözümlemesini yapılandırma
1. Dahili DNS kaydı oluşturma
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.
Dahili DNS kayıtlarını yönetmek için Internal DNS Resolution sekmesini tıklayın.
-
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.
ÖnemliAğı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.
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
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.
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.
Ö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.
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.