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à.

# Tutorial: creazione di un'API HTTP con un'integrazione privata con un servizio Amazon ECS
<a name="http-api-private-integration"></a>

In questo tutorial, si crea un'API serverless che si connette a un servizio Amazon ECS eseguito in un VPC Amazon. I clienti al di fuori del tuo Amazon VPC possono utilizzare l'API per accedere al tuo servizio Amazon ECS. 

Questo tutorial dura circa un'ora. Innanzitutto, utilizzi un CloudFormation modello per creare un servizio Amazon VPC e Amazon ECS. Usa la console API Gateway per creare un link VPC. Il link VPC consente ad API Gateway di accedere al servizio Amazon ECS eseguito nel tuo VPC Amazon. Successivamente, si crea un'API HTTP che utilizza il link VPC per connettersi al servizio Amazon ECS. Infine, si esegue il dell'API.

Quando si richiama l'API HTTP, API Gateway invia la richiesta al tuo servizio Amazon ECS tramite il link VPC e poi restituisce la risposta dal servizio.

![\[Panoramica dell'API HTTP creata in questo tutorial.\]](http://docs.aws.amazon.com/it_it/apigateway/latest/developerguide/images/private-integration.png)


Per completare questo tutorial, sono necessari un AWS account e un AWS Identity and Access Management utente con accesso alla console. Per ulteriori informazioni, consulta [Configurazione per l'utilizzo di Gateway API](setting-up.md).

In questo tutorial utilizzerai Console di gestione AWS. Per un CloudFormation modello che crea questa API e tutte le risorse correlate, vedi [template.yaml](samples/private-integration-full-template.zip).

**Topics**
+ [Fase 1: Creazione di un servizio Amazon ECS](#http-api-private-integration-create-ecs-service)
+ [Fase 2: Creazione di un link VPC](#http-api-private-integration-vpc-link)
+ [Fase 3: creazione un'API HTTP](#http-api-private-integration-create-api)
+ [Fase 4: Creazione di una route](#http-api-private-integration-create-routes)
+ [Fase 5: creazione di un'integrazione](#http-api-private-integration-create-integration)
+ [Fase 6: Test dell'API](#http-api-private-integration-invoke-api)
+ [Fase 7: pulizia](#http-api-private-integration-cleanup)
+ [Passaggi successivi: automatizza con CloudFormation](#http-api-private-integration-next-steps)

## Fase 1: Creazione di un servizio Amazon ECS
<a name="http-api-private-integration-create-ecs-service"></a>

Amazon ECS è un servizio di gestione dei container che facilita l'esecuzione, l'arresto e la gestione di container Docker in un cluster. In questo tutorial eseguirai il cluster su un'infrastruttura serverless gestita da Amazon ECS.

Scarica e decomprimi [questo CloudFormation modello](samples/private-integration-cfn.zip), che crea tutte le dipendenze per il servizio, incluso un Amazon VPC. Si utilizza il modello per creare un servizio Amazon ECS che utilizza un Application Load Balancer.

**Per creare uno stack CloudFormation**

1. Apri la CloudFormation console in [https://console.aws.amazon.com/cloudformation.](https://console.aws.amazon.com/cloudformation/)

1. Scegliere **Create stack (Crea stack)**, quindi **With new resources (standard) (Con nuove risorse (standard))**.

1. In **Specificare modello**, scegliere **Carica un file modello**.

1. Selezionare il modello scaricato.

1. Scegli **Next (Successivo)**. 

1. Per **Stack name (Nome stack)**, inserire **http-api-private-integrations-tutorial**, quindi scegliere **Next (Avanti)**.

1. Per **Configure stack options (Configura opzioni di stack)**, scegliere **Next (Successivo)**.

1. Per quanto riguarda **le funzionalità**, riconosci che CloudFormation puoi creare risorse IAM nel tuo account.

1. Scegli **Avanti**, quindi scegli **Invia**.

CloudFormation esegue il provisioning del servizio ECS, operazione che può richiedere alcuni minuti. Quando lo stato del tuo CloudFormation stack è **CREATE\$1COMPLETE**, sei pronto per passare alla fase successiva.

## Fase 2: Creazione di un link VPC
<a name="http-api-private-integration-vpc-link"></a>

Un link VPC consente ad API Gateway di accedere alle risorse private in un VPC Amazon. Si utilizza un link VPC per consentire ai client di accedere al tuo servizio Amazon ECS tramite l'API HTTP.

**Per creare un link VPC**

1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. Nel pannello di navigazione principale scegli **Collegamenti VPC** e quindi **Crea**.

   È possibile che per aprire il pannello di navigazione principale sia necessario scegliere l'icona del menu.

1. Per **Scegli una versione di collegamento VPC, seleziona Link** **VPC** per HTTP. APIs

1. In **Name (Nome)**, immettere **private-integrations-tutorial**.

1. Per **VPC** scegliere il VPC creato nella fase 1. Il nome deve iniziare con **PrivateIntegrationsStack**.

1. Per **Sottoreti**, selezionare le due sottoreti private nel VPC. I nomi finiscono con `PrivateSubnet`.

1. Per **Gruppi di sicurezza** seleziona l'ID gruppo che inizia con `private-integrations-tutorial` e ha la descrizione `PrivateIntegrationsStack/PrivateIntegrationsTutorialService/Service/SecurityGroup`.

1. Scegli **Create** (Crea).

Dopo aver creato il link VPC, API Gateway consente alle interfacce di rete elastiche di accedere al VPC. Il processo può richiedere alcuni minuti. Nel frattempo, puoi creare la tua API.

## Fase 3: creazione un'API HTTP
<a name="http-api-private-integration-create-api"></a>

L'API HTTP fornisce un endpoint HTTP per il Servizio Amazon ECS. In questa fase si crea un'API vuota. Nelle fasi 4 e 5, si configura un percorso e un'integrazione per connettere l'API e il servizio Amazon ECS.



**Come creare un’API HTTP**

1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. Scegli **Create API (Crea API)**, quindi per **API HTTP**, scegli **Build (Crea)**.

1. Per **API name (Nome API)**, immettere **http-private-integrations-tutorial**.

1. Per il tipo di **indirizzo IP**, selezionare. **IPv4**

1. Scegli **Next (Successivo)**.

1. Per **Configura route**, scegli **Avanti** per ignorare la creazione della route. È possibile creare route in un secondo momento.

1. Esamina la fase creata da API Gateway. API Gateway crea una `$default` fase con distribuzioni automatiche abilitate, che è la scelta migliore per questo tutorial. Scegli **Next (Successivo)**.

1. Seleziona **Crea**.

## Fase 4: Creazione di una route
<a name="http-api-private-integration-create-routes"></a>

Le route inviano le richieste API in entrata alle risorse di back-end. Le route sono costituite da due parti: un metodo HTTP e un percorso della risorsa, ad esempi, `GET /items`. Per questa API di esempio, creiamo una route.

**Per creare una route**

1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. Scegliere l'API.

1. Scegliere **Percorsi**.

1. Seleziona **Crea**.

1. Per **Method (Metodo)** seleziona **ANY**.

1. Per il percorso, immetti **/\$1proxy\$1\$1**. Il`{proxy+}` alla fine del percorso è una variabile di percorso greedy. API Gateway invia tutte le richieste per l'API a questa route.

1. Seleziona **Crea**.

## Fase 5: creazione di un'integrazione
<a name="http-api-private-integration-create-integration"></a>

Si crea un'integrazione per connettere una route alle risorse di back-end.

**Per creare un'integrazione**

1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. Scegliere l'API.

1. Scegli **Integrations (Integrazioni)**.

1. Scegli **Manage integrations (Gestisci integrazioni)**, quindi scegli **Create (Crea)**.

1. Per **Allega questa integrazione a una route**, selezionare la route **ANY/\$1proxy\$1\$1** creata in precedenza.

1. Per **Tipo di integrazione**scegliere **Risorsa privata**.

1. Per **Dettagli sull'integrazione**, scegliere **Seleziona manualmente**.

1. Per **Servizio Target**, scegliere **ALB/NLB**.

1. Per **load balancer**, scegliere il load balancer creato con il modello CloudFormation nella fase 1. Il suo nome dovrebbe iniziare con **HTTP-Priva**.

1. Per **Listener**, scegliere **HTTP 80**.

1. Per **Link VPC**, scegliere il link VPC creato nella fase 2. Dovrebbe chiamarsi `private-integrations-tutorial`.

1. Seleziona **Crea**.

Per verificare che il percorso e l'integrazione siano configurati correttamente, selezionare **Allega integrazioni alle route**. La console mostra che si dispone di una route `ANY /{proxy+}` con un'integrazione a un load balancer VPC.

![\[La console mostra che si dispone di una route /{proxy+} con un'integrazione a un load balancer in un VPC.\]](http://docs.aws.amazon.com/it_it/apigateway/latest/developerguide/images/private-integration-tutorial-route.png)


Ora siamo pronti per testare l'API.

## Fase 6: Test dell'API
<a name="http-api-private-integration-invoke-api"></a>

Successivamente, viene verificata l'API per assicurarsi che funzioni. Per semplicità, usa un browser Web per richiamare l'API.

**Per testare l'API**

1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. Scegliere l'API.

1. Prendere nota del valore URL di chiamata per l'API.  
![\[Dopo aver creato l'API, la console mostra il valore URL di chiamata per l'API.\]](http://docs.aws.amazon.com/it_it/apigateway/latest/developerguide/images/getting-started-invoke-url.png)

1. In un browser web, vai all'URL di chiamata dell'API.

   L'URL completo dovrebbe essere del tipo `https://abcdef123.execute-api.us-east-2.amazonaws.com`.

   Il tuo browser invia una richiesta `GET` all'API.

1. Verifica che la risposta della tua API sia un messaggio di benvenuto che indica che la tua app è in esecuzione su Amazon ECS.

   Se visualizzi il messaggio di benvenuto, hai creato correttamente un servizio Amazon ECS eseguito in un VPC Amazon e hai utilizzato un'API HTTP di API Gateway con un link VPC per accedere al servizio Amazon ECS.

## Fase 7: pulizia
<a name="http-api-private-integration-cleanup"></a>

Per evitare costi non necessari, eliminare le risorse create nell'ambito di questo tutorial. I seguenti passaggi eliminano il link VPC, lo CloudFormation stack e l'API HTTP.

**Per eliminare un'API HTTP**

1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. Nella **APIs**pagina, seleziona un'API. Scegliere **Azioni**, scegliere **Elimina**, quindi confermare la scelta.

**Per eliminare un link VPC**

1. Accedi alla console API Gateway all'indirizzo [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. Scegliere **link VPC**.

1. Selezionare il link VPC, scegliere **Elimina**, quindi confermare la scelta.

**Per eliminare uno stack CloudFormation**

1. Apri la CloudFormation console in [https://console.aws.amazon.com/cloudformation.](https://console.aws.amazon.com/cloudformation/)

1. Seleziona il tuo stack. CloudFormation 

1. Scegli **Elimina** e conferma la tua scelta.

## Passaggi successivi: automatizza con CloudFormation
<a name="http-api-private-integration-next-steps"></a>

Puoi automatizzare la creazione e la pulizia di tutte le AWS risorse coinvolte in questo tutorial. Per un modello CloudFormation di esempio completo, consulta [template.yaml](samples/private-integration-full-template.zip).