Tüm Ürünler
Search
Belge Merkezi

API Gateway:VPC erişim yetkilendirme bağlantı testi

Son Güncelleme:Oct 04, 2026

VPC erişim yetkilendirme bağlantı testi, bir API Gateway örneğinden yetkilendirdiğiniz VPC'deki bir arka uç örneğine ağ bağlantısını doğrular. Bu sayede API hata ayıklama aşamasının başında bağlantı kaynaklı çağrı hatalarını erken tespit edebilirsiniz.

VPC erişim yetkilendirme

VPC erişim yetkilendirmesi, API Gateway'in VPC'nizde dağıtılan arka uç hizmetlerine erişmesine olanak tanıyan bir kayıttır. Yetkilendirme oluşturmak için VPC kimliğinizi (ID), hizmeti barındıran CLB veya ECS örneğinin örnek kimliğini ve hizmet bağlantı noktası numarasını sağlamanız gerekir. Bu değerler birlikte bir arka uç hizmetini benzersiz şekilde tanımlar ve API Gateway'in bu hizmete erişmesini yetkilendirir. Daha fazla bilgi için bkz. API arka ucu olarak VPC'deki bir kaynağı kullanma.

Bağlantı testi

  1. API Gateway konsoluna giriş yapın. Sol gezinme bölmesinde Manage APIs > VPC Authorization seçeneğini belirleyin ve bir VPC erişim yetkilendirmesi oluşturun.

  2. Test Connectivity öğesine tıklayın ve hedef API Gateway örneğini seçin.

    Önemli

    Seçilen örnekte yapılandırılmış bir erişim kontrol ilkesi olmadığından emin olun. Aksi takdirde bağlantı testi başarısız olabilir.

  3. Test düğmesine tıklayın. Seçilen API Gateway örneğinden VPC erişim yetkilendirmesinde belirtilen arka uç hizmetine bir ağ probu gönderilir. Test tamamlandığında sonucu aynı sayfada görüntüleyebilirsiniz.

    • Test başarılı

      Örnek açılır listesinin solunda görünen yeşil onay işareti, ağ bağlantısının kurulduğunu ve bağlantı testinin başarılı olduğunu gösterir.

      Bu özellik yalnızca ağ geçidi örnek sürümleri 3.5.3.791 ve üzeri için kullanılabilir. Özellik kullanılamıyorsa örnek sürümünüzü kontrol edin veya yükseltme talep etmek için bizimle iletişime geçin.

    • Test başarısız

      Başarısız bir bağlantı testi genellikle API Gateway örneği ile VPC erişim yetkilendirmenizdeki hizmet arasında ağ bağlantısı kurulamadığını belirten bir ileti gösterir. Test başarısız olursa Sorun Giderme Kılavuzu bağlantısına tıklayın ve sorun gidermek için talimatları izleyin.

      Bağlantı testi iletişim kutusunda Instance alanının solunda kırmızı bir hata simgesi (×) görünür; bu durum bir ağ hatası olduğunu gösterir.

Sorun Giderme

Bağlantı testi başarısız olursa Sorun Giderme Kılavuzuna tıklayarak çözüm adımlarını içeren bir iletişim kutusu açın. İletişim kutusunun içeriği, VPC erişim yetkilendirmenizde belirtilen örnek türüne (CLB veya ECS) göre değişir.

Sorun giderme süreci üç ana adımdan oluşur:

  1. VPC erişim yetkilendirme bilgilerini doğrulayın.

    VPC erişim yetkilendirmesi oluştururken VPC kimliğini, örnek kimliğini ve hizmet bağlantı noktası numarasını belirtmeniz gerekir. Bu adımda ilgili cloud hizmetinin konsoluna giderek girdiğiniz bilgilerin doğru olup olmadığını doğrulayın.

    VPC kimliğini doğrulayın: VPC konsoluna giriş yapın. Sol gezinme bölmesinde VPC öğesine tıklayın. Hedef VPC'nin kimliğini örnek listesinde bulun. Örnek kimliğini doğrulayın: ECS konsoluna giriş yapın. Sol gezinme bölmesinde Instances öğesine tıklayın. Hedef ECS örneğinin kimliğini örnek listesinde bulun. Hizmet bağlantı noktası numarasını doğrulayın: Arka uç hizmetinin dinleme bağlantı noktasının VPC erişim yetkilendirmesinde belirtilen bağlantı noktası numarasıyla eşleştiğinden emin olun.

  2. ECS örneğinin güvenlik grubunu veya CLB örneğinin engelleme ve izin listelerini kontrol edin.

    • VPC erişim yetkilendirmeniz yapılandırılmış bir güvenlik grubuna sahip bir ECS örneğini işaret ediyorsa API Gateway örneğinin giden IP adresini güvenlik grubunun gelen kurallarına ekleyin.

    • VPC erişim yetkilendirmeniz izin listesi tabanlı bir erişim kontrol ilkesi kullanan bir CLB örneğini işaret ediyorsa API Gateway örneğinin giden IP adresini ilgili erişim kontrol ilke grubunun adres girişlerine ekleyin.

  3. Arka uç hizmetinin çalışma durumunu kontrol edin.

    Bu adımda arka uç hizmetinin çalışma durumunu ve sağlık durumunu kontrol edin. VPC erişim yetkilendirmesinde belirtilen örnek bir ECS örneği ise sağlık durumunu kontrol edin. Örnek bir CLB örneği ise yapılandırılmış dinleyicisinin çalışma durumunu kontrol edin ve sağlık kontrollerinden geçtiğinden emin olun. Bağlantı noktasının geçerli olduğunu doğrulamak için VPC'nizdeki herhangi bir sunucuya giriş yapabilir ve curl komutunu çalıştırarak ECS veya CLB örneğindeki belirtilen bağlantı noktasının dinleme yapıp yapmadığını kontrol edebilirsiniz.