Buat integrasi pribadi untuk HTTP APIs di API Gateway - APIGerbang Amazon

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Buat integrasi pribadi untuk HTTP APIs di API Gateway

Integrasi pribadi memungkinkan Anda membuat API integrasi dengan sumber daya pribadi diVPC, seperti Application Load Balancers atau aplikasi berbasis container AmazonECS.

Anda dapat mengekspos sumber daya Anda dalam a VPC untuk akses oleh klien di luar VPC dengan menggunakan integrasi pribadi. Anda dapat mengontrol akses Anda API dengan menggunakan salah satu metode otorisasi yang didukung API Gateway.

Untuk membuat integrasi pribadi, Anda harus terlebih dahulu membuat VPC tautan. Untuk mempelajari lebih lanjut tentang VPC tautan, lihatSiapkan VPC tautan untuk HTTP APIs di API Gateway.

Setelah membuat VPC tautan, 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, VPC tautan, dan HTTPAPI).

Secara default, lalu lintas integrasi pribadi menggunakan HTTP protokol. Anda dapat menentukan tlsConfigjika Anda memerlukan lalu lintas integrasi pribadi untuk digunakanHTTPS. 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 API titik akhir dalam permintaan ke sumber daya backend Anda. Misalnya, permintaan ke test tahap API termasuk test/route-path dalam permintaan untuk integrasi pribadi Anda. Untuk menghapus nama panggung dari permintaan ke sumber daya backend Anda, gunakan pemetaan parameter untuk menimpa jalur permintaan. $request.path

Buat integrasi pribadi menggunakan Application Load Balancer atau Network Load Balancer

Sebelum Anda membuat integrasi pribadi, Anda harus membuat VPC tautan. Untuk mempelajari lebih lanjut tentang VPC tautan, lihatSiapkan VPC tautan untuk HTTP APIs di API Gateway.

Untuk membuat integrasi pribadi dengan Application Load Balancer atau Network Load Balancer, buat HTTP integrasi proxy, tentukan tautan VPC yang akan digunakan, dan berikan ARN pendengar penyeimbang beban.

Gunakan perintah berikut untuk membuat integrasi pribadi yang terhubung ke penyeimbang beban dengan menggunakan VPC tautan.

aws apigatewayv2 create-integration --api-id api-id --integration-type HTTP_PROXY \ --integration-method GET --connection-type VPC_LINK \ --connection-id VPC-link-ID \ --integration-uri arn: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 VPC tautan. Untuk mempelajari lebih lanjut tentang VPC tautan, lihatSiapkan VPC tautan untuk HTTP APIs di API Gateway.

Untuk integrasi dengan AWS Cloud Map, API Gateway menggunakan 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. APIGateway mendistribusikan permintaan di seluruh sumber daya sehat yang dikembalikan. DiscoverInstances Untuk mempelajari lebih lanjut, lihat DiscoverInstancesdi AWS Cloud Map API Referensi.

catatan

Jika Anda menggunakan Amazon ECS untuk mengisi entri AWS Cloud Map, Anda harus mengonfigurasi ECS tugas Amazon untuk menggunakan SRV catatan dengan Amazon ECS Service Discovery atau mengaktifkan Amazon Service ECS Connect. Untuk informasi selengkapnya, lihat Layanan interkoneksi di Panduan Pengembang Layanan Kontainer Elastis Amazon.

Untuk membuat integrasi pribadi dengan AWS Cloud Map, buat integrasi HTTP proxy, tentukan VPC tautan yang akan digunakan, dan sediakan AWS Cloud Map layanan. ARN

Gunakan perintah berikut untuk membuat 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-id VPC-link-ID \ --integration-uri arn:aws:servicediscovery:us-east-2:123456789012:service/srv-id?stage=prod&deployment=green_deployment --payload-format-version 1.0