Riferimento di origine per la mappatura dei parametri per REST API in Gateway API

Quando si crea una mappatura dei parametri, è possibile specificare i parametri della richiesta di metodo o della risposta di integrazione da modificare e le modalità con cui si desidera modificare tali parametri.

La tabella seguente mostra i parametri della richiesta di metodo che è possibile mappare e l’espressione per creare la mappatura. In queste espressioni, name è il nome di un parametro della richiesta di metodo. Ad esempio, per mappare il parametro dell’intestazione della richiesta puppies, si utilizza l’espressione method.request.header.puppies. L’espressione deve corrispondere all’espressione regolare'^[a-zA-Z0-9._$-]+$]'. È possibile utilizzare la mappatura dei parametri nella richiesta di integrazione per le integrazioni proxy e non proxy.

Origine dati mappata	Espressione di mappatura
Percorso della richiesta di metodo	method.request.path.name
Stringa di query della richiesta di metodo	method.request.querystring.name
Stringa di query multi-valore della richiesta del metodo	method.request.multivaluequerystring.name
Intestazione della richiesta di metodo	method.request.header.name
Intestazione multi-valore della richiesta di metodo	method.request.multivalueheader.name
Corpo della richiesta di metodo	method.request.body
Corpo della richiesta di metodo (JsonPath)	method.request.body.JSONPath_EXPRESSION. JSONPath_EXPRESSION è un’espressione JSONPath per un campo JSON del corpo di una richiesta. Per ulteriori informazioni, consultare JSONPath expression.
Variabili di fase	stageVariables.name
Variabili di contesto	context.name Il nome deve essere una delle variabili di contesto supportate.
Valore statico	'static_value'. static_value è una stringa letterale e deve essere racchiusa in una coppia di virgolette singole. Ad esempio, 'https://www.example.com'.

La tabella seguente mostra i parametri della risposta di integrazione che è possibile mappare e l’espressione per creare la mappatura. In queste espressioni, name è il nome di un parametro della risposta di integrazione. È possibile mappare le intestazioni della risposta di metodo da qualsiasi intestazione o corpo della risposta di integrazione, variabili $context o valori statici. Per utilizzare la mappatura dei parametri per una risposta di integrazione, è necessaria un’integrazione non proxy.

Origine dati mappata	Espressione di mappatura
Intestazione della risposta di integrazione	integration.response.header.name
Intestazione della risposta di integrazione	integration.response.multivalueheader.name
Corpo della risposta di integrazione	integration.response.body
Corpo della risposta di integrazione (JsonPath)	integration.response.body.JSONPath_EXPRESSION JSONPath_EXPRESSION è un’espressione JSONPath per un campo JSON del corpo di una risposta. Per ulteriori informazioni, consultare JSONPath expression.
Variabile di fase	stageVariables.name
Variabile di contesto	context.name Il nome deve essere una delle variabili di contesto supportate.
Valore statico	'static_value' static_value è una stringa letterale e deve essere racchiusa in una coppia di virgolette singole. Ad esempio, 'https://www.example.com'.