Conversioni dei tipi di contenuto in API Gateway

La combinazione di binaryMediaTypes dell'API, le intestazioni nelle richieste del client e la proprietà contentHandling di integrazione determinano il modo in cui API Gateway codifica i payload.

La tabella seguente mostra come API Gateway converte il payload della richiesta per configurazioni specifiche dell'Content-Typeintestazione di una richiesta, l'binaryMediaTypeselenco di una RestApirisorsa e il valore della contentHandling proprietà della risorsa di integrazione.

La tabella seguente mostra come API Gateway converte il payload di risposta per configurazioni specifiche dell'Acceptintestazione di una richiesta, l'binaryMediaTypeselenco di una RestApirisorsa e il valore della contentHandling proprietà della risorsa. IntegrationResponse

Quando converti un payload di testo in un BLOB binario, API Gateway assume che i dati di testo siano una stringa con codifica base64 e genera un output dei dati binari come BLOB con codifica base64. Se la conversione non va a buon fine, viene restituita una risposta 500 che indica un errore di configurazione dell'API. Non fornisci un modello di mappatura per una conversione di questo tipo, sebbene tu debba abilitare i comportamenti passthrough sull'API.

Quando converti un payload binario in una stringa di testo, API Gateway applica sempre una codifica base64 ai dati binari. Per tale payload puoi definire un modello di mappatura, ma puoi accedere alla stringa con codifica base64 nel modello di mappatura solo attraverso $input.body, come viene mostrato nel seguente estratto di un modello di mappatura di esempio.

{   
    "data": "$input.body"
}

Per fare in modo che il payload binario venga passato senza alcuna modifica, devi abilitare i comportamenti passthrough sull'API.