Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Integrasi pribadi memungkinkan Anda membuat integrasi API dengan sumber daya pribadi di VPC, seperti Application Load Balancers atau aplikasi berbasis container Amazon ECS.
Anda dapat mengekspos sumber daya Anda dalam VPC untuk diakses oleh klien di luar VPC dengan menggunakan integrasi pribadi. Anda dapat mengontrol akses ke API Anda dengan menggunakan salah satu metode otorisasi yang didukung API Gateway.
Untuk membuat integrasi pribadi, Anda harus terlebih dahulu membuat tautan VPC. Untuk mempelajari lebih lanjut tentang tautan VPC, lihat. Siapkan tautan VPC untuk HTTP APIs di API Gateway
Setelah membuat tautan VPC, Anda dapat mengatur integrasi pribadi yang terhubung ke Application Load Balancer, Network Load Balancer, atau sumber daya yang terdaftar dengan layanan. AWS Cloud Map
Untuk membuat integrasi pribadi, semua sumber daya harus dimiliki oleh AWS akun yang sama (termasuk penyeimbang beban atau AWS Cloud Map layanan, tautan VPC, dan HTTP API).
Secara default, lalu lintas integrasi pribadi menggunakan protokol HTTP. Anda dapat menentukan tlsConfig
jika Anda memerlukan lalu lintas integrasi pribadi untuk menggunakan HTTPS. Untuk melakukan ini menggunakan AWS Management Console, ketika Anda membuat integrasi pribadi Anda, pilih Pengaturan lanjutan dan kemudian masukkan nama server yang aman.
catatan
Untuk integrasi pribadi, API Gateway menyertakan bagian tahap titik akhir API dalam permintaan ke sumber daya backend Anda. Misalnya, permintaan ke test
tahap API termasuk test/
dalam permintaan untuk integrasi pribadi Anda. Untuk menghapus nama panggung dari permintaan ke sumber daya backend Anda, gunakan pemetaan parameter untuk menimpa jalur permintaan. route-path
$request.path
Buat integrasi pribadi menggunakan Application Load Balancer atau Network Load Balancer
Sebelum Anda membuat integrasi pribadi, Anda harus membuat tautan VPC. Untuk mempelajari lebih lanjut tentang tautan VPC, lihat. Siapkan tautan VPC untuk HTTP APIs di API Gateway
Untuk membuat integrasi pribadi dengan Application Load Balancer atau Network Load Balancer, buat integrasi proxy HTTP, tentukan tautan VPC yang akan digunakan, dan berikan ARN pendengar penyeimbang beban.
Perintah create-integration berikut membuat integrasi pribadi yang terhubung ke penyeimbang beban dengan menggunakan tautan VPC:
aws apigatewayv2 create-integration --api-id
api-id
--integration-type HTTP_PROXY \ --integration-method GET --connection-type VPC_LINK \ --connection-idVPC-link-ID
\ --integration-uriarn:aws:elasticloadbalancing:us-east-2:123456789012:listener/app/my-load-balancer/50dc6c495c0c9188/0467ef3c8400ae65
--payload-format-version 1.0
Buat integrasi pribadi menggunakan penemuan AWS Cloud Map layanan
Sebelum Anda membuat integrasi pribadi, Anda harus membuat tautan VPC. Untuk mempelajari lebih lanjut tentang tautan VPC, lihat. Siapkan tautan VPC untuk HTTP APIs di API Gateway
Untuk integrasi dengan AWS Cloud Map, API Gateway digunakan DiscoverInstances
untuk mengidentifikasi sumber daya. Anda dapat menggunakan parameter kueri untuk menargetkan sumber daya tertentu. Atribut sumber daya terdaftar harus menyertakan alamat IP dan port. API Gateway mendistribusikan permintaan di seluruh sumber daya sehat yang dikembalikan. DiscoverInstances
Untuk mempelajari lebih lanjut, lihat DiscoverInstancesdi Referensi AWS Cloud Map API.
catatan
Jika Anda menggunakan Amazon ECS untuk mengisi entri AWS Cloud Map, Anda harus mengonfigurasi tugas Amazon ECS untuk menggunakan catatan SRV dengan Amazon ECS Service Discovery atau mengaktifkan Amazon ECS Service Connect. Untuk informasi selengkapnya, lihat Layanan interkoneksi di Panduan Pengembang Layanan Kontainer Elastis Amazon.
Untuk membuat integrasi pribadi dengan AWS Cloud Map, buat integrasi proxy HTTP, tentukan tautan VPC yang akan digunakan, dan berikan ARN layanan. AWS Cloud Map
Perintah create-integration berikut menciptakan integrasi pribadi yang menggunakan penemuan AWS Cloud Map layanan untuk mengidentifikasi sumber daya:
aws apigatewayv2 create-integration --api-id
api-id
--integration-type HTTP_PROXY \ --integration-method GET --connection-type VPC_LINK \ --connection-idVPC-link-ID
\ --integration-uriarn:aws:servicediscovery:us-east-2:123456789012:service/srv-id?stage=prod&deployment=green_deployment
--payload-format-version 1.0