Configurare un metodo utilizzando la console API Gateway

Nel riquadro Risorse, scegliete il metodo, quindi scegliete la scheda Richiesta metodo.

Nella sezione Impostazioni della richiesta del metodo scegli Modifica.

Per Autorizzazione seleziona un sistema di autorizzazione disponibile.

1. Per abilitare l'accesso aperto al metodo per qualsiasi utente, scegli Nessuno. Questa fase può essere ignorata se l'impostazione predefinita non è stata modificata.

2. Per utilizzare IAM le autorizzazioni per controllare l'accesso del client al metodo, selezionateAWS_IAM. Con questa scelta, solo gli utenti dei IAM ruoli a cui è associata la IAM politica corretta possono chiamare questo metodo.

   Per creare il IAM ruolo, specifica una politica di accesso con un formato simile al seguente:

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "execute-api:Invoke"
         ],
         "Resource": [
           "resource-statement"
         ]
       }
     ]
   }  

   In questa politica di accesso, resource-statement è ARN il tuo metodo. È possibile trovare il ARN metodo desiderato selezionando il metodo nella pagina Risorse. Per ulteriori informazioni sull'impostazione delle IAM autorizzazioni, consultaControlla l'accesso a un REST API con IAM autorizzazioni.

   Per creare il IAM ruolo, puoi adattare le istruzioni nel seguente tutorial,Creazione di una funzione Lambda per l'integrazione non proxy Lambda.

3. Per utilizzare un sistema di autorizzazione Lambda, seleziona un token o un sistema di autorizzazione di richiesta. Affinché questa scelta sia visualizzata nel menu a discesa, è necessario creare un sistema di autorizzazione Lambda. Per informazioni su come creare un'autorizzazione Lambda, consulta Usa gli API autorizzatori Gateway Lambda.

4. Per utilizzare un pool di utenti di Amazon Cognito, sceglierne uno disponibile in Cognito user pool authorizers (Autorizzazioni pool di utenti Cognito). Crea un pool di utenti in Amazon Cognito e un autorizzatore del pool di utenti Amazon Cognito API in Gateway per visualizzare questa scelta nel menu a discesa. Per informazioni su come creare un'autorizzazione del pool di utenti di Amazon Cognito, consulta Controlla l'accesso alle API REST utilizzando i pool di utenti di Amazon Cognito come autorizzatore.

Per specificare la convalida della richiesta, seleziona un valore dal menu a discesa Validatore richiesta. Per disattivare la convalida della richiesta, seleziona Nessuno. Per ulteriori informazioni su ciascuna opzione, consulta Richiedi la convalida per REST APIs in API Gateway.

Seleziona la APIchiave richiesta per richiedere una chiave. API Se abilitate, API le chiavi vengono utilizzate nei piani di utilizzo per limitare il traffico dei clienti.

(Facoltativo) Per assegnare un nome SDK di operazione in un Java generato da API GatewayAPI, in Nome operazione, immettete un nome. Ad esempio, per la richiesta del metodo diGET /pets/{petId}, il nome dell'SDKoperazione Java corrispondente è, per impostazione predefinita,GetPetsPetId. Questo nome è costituito dal HTTP verbo (GET) del metodo e dai nomi delle variabili del percorso della risorsa (PetsandPetId). Se impostate il nome dell'operazione comegetPetById, il nome dell'SDKoperazione diventaGetPetById.

Per aggiungere un parametro stringa di query al metodo, procedi come indicato di seguito:

1. Scegliete Parametri della stringa di URL query, quindi scegliete Aggiungi stringa di query.

2. In Nome digita il nome del parametro della stringa di query.

3. Se il parametro della stringa di query appena creato viene usato per la convalida della richiesta, scegli l'opzione Obbligatorio. Per ulteriori informazioni sulla convalida della richiesta, consulta Richiedi la convalida per REST APIs in API Gateway.

4. Se il parametro della stringa di query appena creato viene usato come parte di una chiave di caching, seleziona l'opzione Caching. Per ulteriori informazioni sul caching, consulta Uso dei parametri di metodo o di integrazione come chiavi di cache per indicizzare le risposte memorizzate nella cache.

Per rimuovere il parametro della stringa di query, scegli Rimuovi.

Per aggiungere un parametro di intestazione al metodo, procedi come indicato di seguito:

1. Scegliete le intestazioni della HTTP richiesta, quindi scegliete Aggiungi intestazione.

2. Per Nome immetti il nome dell'intestazione.

3. Se l'intestazione appena creata viene usata per la convalida della richiesta, scegli l'opzione Obbligatorio. Per ulteriori informazioni sulla convalida della richiesta, consulta Richiedi la convalida per REST APIs in API Gateway.

4. Se l'intestazione appena creata viene usata come parte di una chiave di caching, scegli l'opzione Caching. Per ulteriori informazioni sul caching, consulta Uso dei parametri di metodo o di integrazione come chiavi di cache per indicizzare le risposte memorizzate nella cache.

Per rimuovere l'intestazione, scegli Rimuovi.

Per dichiarare il formato del payload di una richiesta di metodo con il PATCH HTTP verbo, o POSTPUT, scegliete Request body ed effettuate le seguenti operazioni:

1. Scegliere Add model (Aggiungi modello).

2. Per Content-type, inserite un MIME -type (ad esempio,). application/json

3. Per Modello seleziona un modello dal menu a discesa. I modelli attualmente disponibili per la API includono i modelli di default Empty e Error i modelli, nonché tutti i modelli che avete creato e aggiunto alla collezione Models di. API Per ulteriori informazioni sulla creazione di un modello, consulta Modelli di dati per REST APIs.

   Nota

   Il modello è utile per informare il client del formato dati previsto di un payload, nonché per generare un modello di mappatura. È importante generare un codice fortemente tipizzato SDK API in linguaggi come Java, C#, Objective-C e Swift. È obbligatorio solo se la convalida di richiesta è abilitata per il payload.

Seleziona Salva.

Nel riquadro Risorse, scegli il metodo, quindi scegli la scheda Metodo di risposta. Potrebbe essere necessario scegliere il pulsante freccia destra per visualizzare la scheda.

Nella sezione Impostazioni risposta metodo scegli Crea risposta.

Per il HTTPcodice di HTTP stato, inserisci un codice di stato come 200400, o500.

Quando per una risposta restituita dal backend non è definito un metodo di risposta corrispondente, API Gateway non riesce a restituire la risposta al client. Restituisce invece una risposta di errore 500 Internal server error.

Seleziona Add header (Aggiungi intestazione).

Per Nome intestazione immetti un nome.

Per restituire un'intestazione dal back-end al client, aggiungi l'intestazione nella risposta del metodo.

Scegli Aggiungi modello per definire un formato del corpo della risposta del metodo.

Immetti il tipo di supporto del payload della risposta per Tipo di contenuto e seleziona un modello dal menu a discesa Modelli.

Seleziona Salva.