Tutorial: creare un'API REST con un' AWS integrazione

1. Completa le fasi descritte in Configurazione per l'utilizzo di API Gateway.

2. Crea una nuova API denominata MyDemoAPI. Per ulteriori informazioni, consulta Tutorial: creare un file REST API con un'HTTPintegrazione non proxy.

3. Distribuisci l'API almeno una volta in una fase denominata test. Per ulteriori informazioni, consulta la pagina relativa alla distribuzione dell'API in Scegli un tutorial di integrazione AWS Lambda.

4. Completa le altre fasi descritte in Scegli un tutorial di integrazione AWS Lambda.

5. Crea almeno un argomento in Amazon Simple Notification Service (Amazon SNS). Utilizzerai l'API distribuita per ottenere un elenco di argomenti in Amazon SNS associati AWS al tuo account. Per informazioni su come creare un argomento in Amazon SNS, consulta Creazione di un argomento. Non devi copiare l'ARN dell'argomento citato nella fase 5.

Per creare il ruolo di esecuzione del proxy di AWS servizio

1. Accedi AWS Management Console e apri la console IAM all'indirizzo https://console.aws.amazon.com/iam/.

2. Scegliere Roles (Ruoli).

3. Scegli Crea ruolo.

4. Scegli il AWS servizio in Seleziona il tipo di entità affidabile, quindi seleziona API Gateway e seleziona Consenti a API Gateway di inviare i log ai CloudWatch log.

5. Scegli Successivo e di nuovo Successivo.

6. In Role name (Nome ruolo) immettere APIGatewaySNSProxyPolicy e quindi selezionare Create role (Crea ruolo).

7. Nell'elenco Roles (Ruoli) scegliere il ruolo appena creato. Potrebbe essere necessario scorrere o utilizzare la barra di ricerca per trovare il ruolo.

8. Per il ruolo selezionato, seleziona la scheda Aggiungi autorizzazioni.

9. Dall'elenco a discesa scegli Collega policy.

10. Nella barra di ricerca inserisci AmazonSNSReadOnlyAccess e scegli Aggiungi autorizzazioni.

    Nota

    Per semplicità, questo tutorial utilizza una policy gestita. Come best practice, dovresti creare la tua policy IAM per concedere le autorizzazioni minime richieste.

11. Annota l'ARN del ruolo appena creato, lo utilizzerai in seguito.

Per creare la risorsa

1. Accedere alla console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway.

2. Scegliere l'API.

3. Seleziona la risorsa root /, rappresentata da una singola barra (/), quindi scegli Crea risorsa.

4. Mantieni l'opzione Risorsa proxy disattivata.

5. Mantieni Percorso risorsa impostato su /.

6. Per Resource Name (Nome risorsa) immetti mydemoawsproxy.

7. Mantieni CORS (Cross Origin Resource Sharing) disattivato.

8. Scegli Crea risorsa.

Per creare il metodo GET

1. Seleziona la risorsa /mydemoawsproxy, quindi scegli Crea metodo.

2. Per Tipo di metodo seleziona GET.

3. Per Tipo di integrazione seleziona Servizio AWS.

4. Per Regione AWS, seleziona l'argomento Regione AWS in cui hai creato il tuo Amazon SNS.

5. Per Servizio AWS seleziona Amazon SNS.

6. Lascia vuoto Sottodominio AWS .

7. Per Metodo HTTP seleziona GET.

8. Per Tipo di operazione scegli Usa nome operazione.

9. Per Nome azione immetti ListTopics.

10. Per Ruolo di esecuzione immetti l'ARN del ruolo per APIGatewaySNSProxyPolicy.

11. Scegli Crea metodo.

Test del metodo GET

1. Seleziona la scheda Test. Potrebbe essere necessario scegliere il pulsante freccia destra per visualizzare la scheda.

2. Scegli Test (Esegui test).

   Il risultato mostra una risposta simile a quella riportata di seguito:

   {
     "ListTopicsResponse": {
       "ListTopicsResult": {
         "NextToken": null,
         "Topics": [
           {
             "TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-1"
           },
           {
             "TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-2"
           },
           ...
           {
             "TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-N"
           }
         ]
       },
       "ResponseMetadata": {
         "RequestId": "abc1de23-45fa-6789-b0c1-d2e345fa6b78"
       }
     }
   }

Per distribuire l'API

1. Seleziona Deploy API (Distribuisci API).

2. In Fase, seleziona Nuova fase.

3. In Stage name (Nome fase) immettere test.

4. (Facoltativo) In Description (Descrizione), immettere una descrizione.

5. Selezionare Deploy (Distribuisci).

1. Nel pannello di navigazione principale scegli Fase.

2. In Dettagli fase, scegli l'icona Copia per copiare l'URL di richiamo dell'API.

   L'URL dovrebbe essere simile a questo:

   https://my-api-id.execute-api.region-id.amazonaws.com/test

3. Immetti l'URL nella barra degli indirizzi di una nuova scheda del browser.

4. Aggiungi /mydemoawsproxy in modo che l'URL sia simile al seguente:

   https://my-api-id.execute-api.region-id.amazonaws.com/test/mydemoawsproxy

   Accedi all'URL. Verranno visualizzate informazioni simili alle seguenti:

   {"ListTopicsResponse":{"ListTopicsResult":{"NextToken": null,"Topics":[{"TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-1"},{"TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-2"},...{"TopicArn": "arn:aws:sns:us-east-1:80398EXAMPLE:MySNSTopic-N}]},"ResponseMetadata":{"RequestId":"abc1de23-45fa-6789-b0c1-d2e345fa6b78}}}

Per eliminare le risorse IAM associate

1. Aprire la console IAM all'indirizzo https://console.aws.amazon.com/iam/.

2. Nell'area Details (Dettagli) scegliere Roles (Ruoli).

3. Seleziona APIGateway AWSProxyExecRole, quindi scegli Role Actions, Delete Role. Quando viene richiesto, scegliere Yes, Delete (Sì, elimina).

4. Nell'area Details (Dettagli) scegliere Policies (Policy).

5. Seleziona ApiGateway AWSProxyExecPolicy, quindi scegli Azioni politiche, Elimina. Quando viene richiesto, scegliere Delete (Elimina).