Trasmetti in streaming la risposta di integrazione per le integrazioni proxy in API Gateway - Gateway Amazon API
Considerazioni sullo streaming del payload di risposta

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

Trasmetti in streaming la risposta di integrazione per le integrazioni proxy in API Gateway

Puoi configurare l’integrazione del proxy per controllare in che modo API Gateway restituisce la tua risposta di integrazione. Per impostazione predefinita, API Gateway attende di ricevere la risposta completa prima di iniziare la trasmissione. Tuttavia, se imposti la modalità di trasferimento delle risposte dell'integrazione suSTREAM, API Gateway non attende che una risposta sia completamente calcolata prima di inviarla al client. Lo streaming di risposte funziona per tutti i tipi di endpoint di REST API.

Utilizza lo streaming di risposte per i seguenti casi d'uso:

  • Riduci il time-to-first-byte valore (TTFB) per le applicazioni di intelligenza artificiale generativa come i chatbot.

  • Trasmetti in streaming immagini, video o file musicali di grandi dimensioni senza utilizzare un URL prefirmato S3.

  • Esegui operazioni di lunga durata segnalando progressi incrementali come gli eventi inviati dal server (SSE).

  • Supera il limite di payload di risposta di 10 MB di API Gateway.

  • Supera il limite di timeout di 29 secondi di API Gateway senza richiedere un aumento del limite di timeout di integrazione.

  • Ricevi un payload binario senza configurare i tipi di supporti binari.

Considerazioni sullo streaming del payload di risposta

Le seguenti considerazioni potrebbero influire sull'utilizzo dello streaming di payload di risposta:

  • È possibile utilizzare lo streaming di payload di risposta solo per HTTP_PROXY tipi di integrazione. AWS_PROXY Ciò include le integrazioni proxy Lambda e le integrazioni private che utilizzano integrazioni. HTTP_PROXY

  • L'impostazione predefinita della modalità di trasferimento è. BUFFERED Per utilizzare lo streaming di risposta, è necessario modificare la modalità di trasferimento della risposta inSTREAM.

  • Lo streaming di risposte è supportato solo per REST APIs.

  • Lo streaming delle richieste non è supportato.

  • Puoi trasmettere in streaming la tua risposta per un massimo di 15 minuti.

  • I tuoi stream sono soggetti a timeout di inattività. Per gli endpoint regionali o privati, il timeout è di 5 minuti. Per gli endpoint ottimizzati per l'edge, il timeout è di 30 secondi.

  • Se utilizzi lo streaming di risposta per un'API REST regionale con la tua CloudFront distribuzione, puoi ottenere un timeout di inattività superiore a 30 secondi aumentando il timeout di risposta della tua distribuzione. CloudFront Per ulteriori informazioni, consulta Timeout di risposta.

  • Quando la modalità di trasferimento della risposta è impostata suSTREAM, API Gateway non può supportare funzionalità che richiedono il buffering dell'intera risposta di integrazione. Per questo motivo, le seguenti funzionalità non sono supportate con lo streaming di risposta:

    • Memorizzazione nella cache degli endpoint

    • Codifica dei contenuti. Se desideri comprimere la tua risposta di integrazione, esegui questa operazione nella tua integrazione.

    • Trasformazione della risposta con VTL

  • All'interno di ogni risposta in streaming, i primi 10 MB di payload di risposta non sono soggetti ad alcuna restrizione di larghezza di banda. I dati di payload di risposta superiori a 10 MB sono limitati a 2 MB/s.

  • Quando la connessione tra il client e API Gateway o tra API Gateway e Lambda viene chiusa a causa di un timeout, la funzione Lambda potrebbe continuare a essere eseguita. Per ulteriori informazioni, consulta Configurare il timeout della funzione Lambda.

  • Lo streaming delle risposte comporta un costo. Per ulteriori informazioni, consulta Prezzi di API Gateway.