Crea integrazioni private per HTTP APIs in API Gateway - Amazon API Gateway

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea integrazioni private per HTTP APIs in API Gateway

Le integrazioni private consentono di creare API integrazioni con risorse private in un ambienteVPC, come Application Load Balancers o applicazioni basate su container AmazonECS.

Puoi esporre le tue risorse in modo che possano accedervi anche clienti esterni utilizzando integrazioni private. VPC VPC Puoi controllare l'accesso al tuo dispositivo API utilizzando uno qualsiasi dei metodi di autorizzazione supportati da API Gateway.

Per creare un'integrazione privata, devi prima creare un VPC link. Per ulteriori informazioni sui VPC link, consultaConfigurare VPC i collegamenti per HTTP APIs in API Gateway.

Dopo aver creato un VPC link, puoi configurare integrazioni private che si connettono a un Application Load Balancer, Network Load Balancer o a risorse registrate con un servizio. AWS Cloud Map

Per creare un'integrazione privata, tutte le risorse devono appartenere allo stesso AWS account (inclusi il sistema di bilanciamento del carico o il AWS Cloud Map servizio, VPC il link e). HTTP API

Per impostazione predefinita, il traffico di integrazione privato utilizza il HTTP protocollo. È possibile specificare a tlsConfigse è necessario utilizzare il traffico di integrazione privatoHTTPS. A tale scopo AWS Management Console, quando crei l'integrazione privata, scegli Impostazioni avanzate e quindi inserisci un nome server sicuro.

Nota

Per le integrazioni private, API Gateway include la parte relativa alla fase dell'APIendpoint nella richiesta alle risorse di backend. Ad esempio, una richiesta allo test stadio di un API include test/route-path nella richiesta di integrazione privata. Per rimuovere il nome della fase dalla richiesta alle risorse di back-end, utilizzare parameter mapping (mappatura dei parametri) per sovrascrivere il percorso della richiesta a $request.path.

Creare un'integrazione privata utilizzando un Application Load Balancer o un Network Load Balancer

Prima di creare un'integrazione privata, devi creare un VPC link. Per ulteriori informazioni sui VPC link, consultaConfigurare VPC i collegamenti per HTTP APIs in API Gateway.

Per creare un'integrazione privata con un Application Load Balancer o Network Load Balancer, crea HTTP un'integrazione proxy, specifica VPC il link da utilizzare e fornisci il ARN listener del load balancer.

Utilizzate il comando seguente per creare un'integrazione privata che si connetta a un sistema di bilanciamento del carico tramite un collegamento. VPC

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

Crea un'integrazione privata utilizzando AWS Cloud Map Service Discovery

Prima di creare un'integrazione privata, devi creare un VPC link. Per ulteriori informazioni sui VPC link, consultaConfigurare VPC i collegamenti per HTTP APIs in API Gateway.

Per le integrazioni con AWS Cloud Map, API Gateway utilizza DiscoverInstances per identificare le risorse. È possibile utilizzare i parametri di query per fare riferimento a risorse specifiche. Gli attributi delle risorse registrate devono includere indirizzi IP e porte. APIGateway distribuisce le richieste tra risorse integre da cui vengono restituite. DiscoverInstances Per ulteriori informazioni, consulta DiscoverInstancesla sezione AWS Cloud Map API Reference.

Nota

Se usi Amazon ECS per compilare le voci AWS Cloud Map, devi configurare la tua ECS attività Amazon per utilizzare i SRV record con Amazon ECS Service Discovery o attivare Amazon ECS Service Connect. Per ulteriori informazioni, consulta Interconnecting services nella Guida per gli sviluppatori di Amazon Elastic Container Service.

Per creare un'integrazione privata con AWS Cloud Map, crea un'integrazione HTTP proxy, specifica il VPC link da utilizzare e fornisci il ARN AWS Cloud Map servizio.

Utilizza il comando seguente per creare un'integrazione privata che utilizzi il rilevamento dei AWS Cloud Map servizi per identificare le risorse.

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