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à. # Configurazione di una richiesta di integrazione API tramite la console API Gateway La configurazione di un metodo API definisce il metodo e descrive i suoi comportamenti. Per configurare un metodo, è necessario specificare una risorsa su cui il metodo è esposto, inclusa la root ("/"), un metodo HTTP (`GET`, `POST` e così via) e il modo in cui sarà integrato con il relativo back-end. La richiesta e la risposta di metodo specificano il contratto con l'app di chiamata e stipulano i parametri che l'API può ricevere e l'aspetto della risposta. Le seguenti procedure descrivono come utilizzare la console Gateway API per creare una richiesta di integrazione. **Topics** + [Configurazione di un'integrazione Lambda](#how-to-method-settings-console-lambda) + [Configurazione di un'integrazione HTTP](#how-to-method-settings-console-http) + [Configura un'integrazione AWS di servizi](#how-to-method-settings-console-aws) + [Configurazione di un'integrazione fittizia](#how-to-method-settings-console-mock) ## Configurazione di un'integrazione Lambda L'integrazione della funzione Lambda si utilizza per integrare l'API con una funzione Lambda. A livello di API, sarà un tipo di integrazione `AWS` se si crea un'integrazione non proxy o un tipo di integrazione `AWS_PROXY` se si crea un'integrazione proxy. **Per configurare l'integrazione Lambda** 1. Nel riquadro **Risorse** scegli **Crea metodo**. 1. Per **Tipo di metodo** seleziona un metodo HTTP. 1. Per **Integration type (Tipo di integrazione)**, scegli **Lambda Function (Funzione Lambda)**. 1. Per utilizzare un'integrazione proxy Lambda, attiva **Integrazione proxy Lambda**. Per ulteriori informazioni sulle integrazioni proxy Lambda, consulta [Informazioni sull'integrazione proxy Lambda di API Gateway](set-up-lambda-proxy-integrations.md#api-gateway-create-api-as-simple-proxy). 1. Per **Funzione Lambda** immetti il nome della funzione Lambda. Se utilizzi una funzione Lambda in una regione diversa da quella dell'API, seleziona la regione dal menu a discesa e inserisci il nome della funzione Lambda. Se usi una funzione Lambda tra diversi account immetti il nome della risorsa Amazon (ARN) della funzione. 1. Per utilizzare il valore di timeout predefinito di 29 secondi, mantieni attiva l'opzione **Timeout predefinito**. Per impostare un timeout personalizzato, scegli **Timeout predefinito** e immetti un valore di timeout compreso tra `50` e `29000` millisecondi. 1. (Facoltativo) È possibile configurare le impostazioni di richiesta del metodo utilizzando i seguenti menu a discesa. Scegli **Impostazioni della richiesta del metodo** e configura la richiesta del metodo. Per ulteriori informazioni, consulta il passaggio 3 di [Modifica di una richiesta del metodo di Gateway API nella console Gateway API](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console). È possibile configurare le impostazioni della richiesta del metodo anche dopo aver creato il metodo. 1. Scegli **Crea metodo**. ## Configurazione di un'integrazione HTTP L'integrazione HTTP si utilizza per integrare l'API con un endpoint HTTP. A livello di API, questa è un'integrazione di tipo `HTTP`. **Per configurare un'integrazione HTTP** 1. Nel riquadro **Risorse** scegli **Crea metodo**. 1. Per **Tipo di metodo** seleziona un metodo HTTP. 1. Per **Tipo di integrazione** scegli **Fittizio**. 1. Per utilizzare un'integrazione proxy HTTP, attiva **Integrazione proxy HTTP**. Per ulteriori informazioni sulle integrazioni proxy HTTP, consulta [Configurazione di integrazioni proxy HTTP in API Gateway](setup-http-integrations.md#api-gateway-set-up-http-proxy-integration-on-proxy-resource). 1. Per **HTTP method (Metodo HTTP)** scegliere il tipo di metodo HTTP che corrisponde maggiormente al metodo nel back-end HTTP. 1. Per **URL endpoint** immetti l'URL del back-end HTTP che desideri venga utilizzato dal metodo. 1. Per **Gestione contenuti** seleziona un comportamento di gestione dei contenuti. 1. Per utilizzare il valore di timeout predefinito di 29 secondi, mantieni attiva l'opzione **Timeout predefinito**. Per impostare un timeout personalizzato, scegli **Timeout predefinito** e immetti un valore di timeout compreso tra `50` e `29000` millisecondi. 1. (Facoltativo) È possibile configurare le impostazioni di richiesta del metodo utilizzando i seguenti menu a discesa. Scegli **Impostazioni della richiesta del metodo** e configura la richiesta del metodo. Per ulteriori informazioni, consulta il passaggio 3 di [Modifica di una richiesta del metodo di Gateway API nella console Gateway API](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console). È possibile configurare le impostazioni della richiesta del metodo anche dopo aver creato il metodo. 1. Scegli **Crea metodo**. ## Configura un'integrazione AWS di servizi Utilizza un'integrazione AWS di servizi per integrare la tua API direttamente con un AWS servizio. A livello di API, questa è un'integrazione di tipo `AWS`. Per configurare un'API Gateway API procedi come segue: + Crea una nuova funzione Lambda. + Imposta l'autorizzazione per le risorse alla funzione Lambda. + Esegui qualsiasi altra azione del servizio Lambda. È necessario scegliere **Servizio AWS **. **Per configurare un'integrazione AWS di servizi** 1. Nel riquadro **Risorse** scegli **Crea metodo**. 1. Per **Tipo di metodo** seleziona un metodo HTTP. 1. Per **Tipo di integrazione** scegli **Servizio AWS **. 1. Per **AWS Regione**, scegli la AWS regione che desideri utilizzare questo metodo per avviare l'azione. 1. Per l'**AWS assistenza**, scegli il AWS servizio che desideri chiamare con questo metodo. 1. Per **AWS sottodominio**, inserisci il sottodominio utilizzato dal AWS servizio. In genere, questo spazio rimane vuoto. Alcuni servizi AWS supportano i sottodomini come parte degli host. Consulta la documentazione relativa al servizio per la disponibilità e, se disponibili, ulteriori dettagli. 1. In **HTTP method (Metodo HTTP)** scegliere il tipo di metodo HTTP che corrisponde all'operazione. **Per il tipo di metodo HTTP, consulta la documentazione di riferimento dell'API per il AWS servizio che hai scelto per AWS il servizio.** 1. Per **Tipo di operazione** seleziona **Usa nome operazione** per utilizzare un'operazione API o **Utilizza sostituzione percorso** per usare un percorso personalizzato della risorsa. Per le azioni disponibili e i percorsi di risorse personalizzati, consulta la documentazione di riferimento dell'API per il AWS servizio che hai scelto per il **AWS servizio**. 1. Inserisci il **Nome azione** o la **Sostituzione percorso**. 1. In **Ruolo di esecuzione** immetti il nome della risorsa Amazon (ARN) del ruolo IAM utilizzato dal metodo per chiamare l'operazione. Per creare il ruolo IAM puoi adattare le istruzioni disponibili in [Fase 1: creare il ruolo di esecuzione del proxy del AWS servizio](getting-started-aws-proxy.md#getting-started-aws-proxy-add-roles). Specifica una policy di accesso con il numero desiderato di dichiarazioni di risorse e azioni: Per ulteriori informazioni, consulta [Come funziona Amazon API Gateway con IAM](security_iam_service-with-iam.md). Per la sintassi dell'istruzione relativa alle azioni e alle risorse, consulta la documentazione del AWS servizio che hai scelto per il **AWS servizio**. Per la relazione di fiducia del ruolo IAM, specificare quanto segue, in modo da consentire ad API Gateway di intervenire per conto dell'account AWS : ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "", "Effect": "Allow", "Principal": { "Service": "apigateway.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Per utilizzare il valore di timeout predefinito di 29 secondi, mantieni attiva l'opzione **Timeout predefinito**. Per impostare un timeout personalizzato, scegli **Timeout predefinito** e immetti un valore di timeout compreso tra `50` e `29000` millisecondi. 1. (Facoltativo) È possibile configurare le impostazioni di richiesta del metodo utilizzando i seguenti menu a discesa. Scegli **Impostazioni della richiesta del metodo** e configura la richiesta del metodo. Per ulteriori informazioni, consulta il passaggio 3 di [Modifica di una richiesta del metodo di Gateway API nella console Gateway API](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console). È possibile configurare le impostazioni della richiesta del metodo anche dopo aver creato il metodo. 1. Scegli **Crea metodo**. ## Configurazione di un'integrazione fittizia L'integrazione fittizia si utilizza affinché Gateway API agisca come backend e restituisca risposte statiche. A livello di API, questa è un'integrazione di tipo `MOCK`. In genere, puoi utilizzare l'integrazione `MOCK` quando la tua API non è ancora quella definitiva, ma vuoi generare risposte API per liberare i team relativi e dedicarli al test. Per il metodo `OPTION`, API Gateway imposta l'integrazione `MOCK` come predefinita per restituire intestazioni abilitate a CORS per la risorsa API applicata. **Per configurare un'integrazione fittizia** 1. Nel riquadro **Risorse** scegli **Crea metodo**. 1. Per **Tipo di metodo** seleziona un metodo HTTP. 1. Per **Tipo di integrazione** scegli **Fittizio**. 1. (Facoltativo) È possibile configurare le impostazioni di richiesta del metodo utilizzando i seguenti menu a discesa. Scegli **Impostazioni della richiesta del metodo** e configura la richiesta del metodo. Per ulteriori informazioni, consulta il passaggio 3 di [Modifica di una richiesta del metodo di Gateway API nella console Gateway API](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console). È possibile configurare le impostazioni della richiesta del metodo anche dopo aver creato il metodo. 1. Scegli **Crea metodo**.