Comportamento della richiesta del metodo per i payload senza modelli di mappatura per REST APIs in API Gateway - Amazon API Gateway

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

Comportamento della richiesta del metodo per i payload senza modelli di mappatura per REST APIs in API Gateway

Se la richiesta di metodo ha un payload senza modello di mappatura definito per l’intestazione Content-Type, è possibile scegliere di passare il payload della richiesta fornito dal client tramite la richiesta di integrazione al backend senza trasformazione. Il processo è noto come passthrough di integrazione.

L’effettivo comportamento del passthrough di una richiesta in entrata è determinato da questa impostazione. Sono disponibili tre opzioni:

Opzione Quando nessun modello corrisponde all'intestazione Content-Type della richiesta

Selezionare questa opzione se si desidera che venga eseguito il passthrough del corpo della richiesta di metodo nella richiesta di integrazione al back-end senza trasformazione quando il tipo di contenuto della richiesta di metodo non corrisponde ai tipi di contenuto associati ai modelli di mappatura.

Durante la chiamata all'API Gateway API, scegli questa opzione impostando WHEN_NO_MATCH come valore della proprietà passthroughBehavior in Integrazione.

Quando non ci sono modelli definiti (consigliato)

Selezionare questa opzione se si desidera che venga eseguito il passthrough del corpo della richiesta di metodo nella richiesta di integrazione al back-end senza trasformazione quando nella richiesta di integrazione non è stato definito un modello di mappatura. Se viene definito un modello con questa opzione selezionata, la richiesta di metodo con un payload e un tipo di contenuto che non corrispondono ad alcun modello di mappatura definito verrà rifiutata con una risposta HTTP 415 Tipo di supporto non compatibile.

Durante la chiamata all'API Gateway API, scegli questa opzione impostando WHEN_NO_TEMPLATES come valore della proprietà passthroughBehavior in Integrazione.

Mai

Selezionare questa opzione se non si desidera che venga eseguito il passthrough del corpo della richiesta di metodo nella richiesta di integrazione al back-end senza trasformazione quando nella richiesta di integrazione non è stato definito un modello di mappatura. Se viene definito un modello al momento della selezione di questa opzione, la richiesta di metodo di un tipo di contenuto non mappato sarà rifiutata con la risposta Tipo di supporto non supportato HTTP 415.

Durante la chiamata all'API Gateway API, scegli questa opzione impostando NEVER come valore della proprietà passthroughBehavior in Integrazione.

Gli esempi seguenti illustrano i possibili comportamenti del passthrough.

Esempio 1: viene definito un modello di mappatura nella richiesta di integrazione per il tipo di contenuto application/json.

Content-type Opzione passthrough Comportamento

Nessuno

Gateway API utilizza l’impostazione predefinita application/json

 WHEN_NO_MATCH Il payload della richiesta viene trasformato utilizzando il modello.

Nessuno

Gateway API utilizza l’impostazione predefinita application/json

 WHEN_NO_TEMPLATES Il payload della richiesta viene trasformato utilizzando il modello.

Nessuno

Gateway API utilizza l’impostazione predefinita application/json

 NEVER Il payload della richiesta viene trasformato utilizzando il modello.
application/json WHEN_NO_MATCH Il payload della richiesta viene trasformato utilizzando il modello.
application/json WHEN_NO_TEMPLATES Il payload della richiesta viene trasformato utilizzando il modello.
application/json NEVER Il payload della richiesta viene trasformato utilizzando il modello.
application/xml WHEN_NO_MATCH Il payload della richiesta non viene trasformato e viene inviato al back-end inalterato.
application/xml WHEN_NO_TEMPLATES La richiesta viene respinta con una risposta HTTP 415 Unsupported Media Type.
application/xml NEVER La richiesta viene respinta con una risposta HTTP 415 Unsupported Media Type.

Esempio 2: viene definito un modello di mappatura nella richiesta di integrazione per il tipo di contenuto application/xml.

Content-type Opzione passthrough Comportamento

Nessuno

Gateway API utilizza l’impostazione predefinita application/json

 WHEN_NO_MATCH Il payload della richiesta non viene trasformato e viene inviato al back-end inalterato.

Nessuno

Gateway API utilizza l’impostazione predefinita application/json

 WHEN_NO_TEMPLATES La richiesta viene respinta con una risposta HTTP 415 Unsupported Media Type.

Nessuno

Gateway API utilizza l’impostazione predefinita application/json

 NEVER La richiesta viene respinta con una risposta HTTP 415 Unsupported Media Type.
application/json WHEN_NO_MATCH Il payload della richiesta non viene trasformato e viene inviato al back-end inalterato.
application/json WHEN_NO_TEMPLATES La richiesta viene respinta con una risposta HTTP 415 Unsupported Media Type.
application/json NEVER La richiesta viene respinta con una risposta HTTP 415 Unsupported Media Type.
application/xml WHEN_NO_MATCH Il payload della richiesta viene trasformato utilizzando il modello.
application/xml WHEN_NO_TEMPLATES Il payload della richiesta viene trasformato utilizzando il modello.
application/xml NEVER Il payload della richiesta viene trasformato utilizzando il modello.

Esempio 3: nessun modello di mappatura viene definito nella richiesta di integrazione

Content-type Opzione passthrough Comportamento

Nessuno

Gateway API utilizza l’impostazione predefinita application/json

 WHEN_NO_MATCH Il payload della richiesta non viene trasformato e viene inviato al back-end inalterato.

Nessuno

Gateway API utilizza l’impostazione predefinita application/json

 WHEN_NO_TEMPLATES Il payload della richiesta non viene trasformato e viene inviato al back-end inalterato.

Nessuno

Gateway API utilizza l’impostazione predefinita application/json

 NEVER La richiesta viene respinta con una risposta HTTP 415 Unsupported Media Type.
application/json WHEN_NO_MATCH Il payload della richiesta non viene trasformato e viene inviato al back-end inalterato.
application/json WHEN_NO_TEMPLATES Il payload della richiesta non viene trasformato e viene inviato al back-end inalterato.
application/json NEVER La richiesta viene respinta con una risposta HTTP 415 Unsupported Media Type.
application/xml WHEN_NO_MATCH Il payload della richiesta non viene trasformato e viene inviato al back-end inalterato.
application/xml WHEN_NO_TEMPLATES Il payload della richiesta non viene trasformato e viene inviato al back-end inalterato.
application/xml NEVER La richiesta viene respinta con una risposta HTTP 415 Unsupported Media Type.