Parameterzuweisung für REST-APIs in API Gateway - Amazon API Gateway

Parameterzuweisung für REST-APIs in API Gateway

Anmerkung

Wenn Sie eine HTTP-API verwenden, finden Sie weitere Informationen unter API-Anforderungen und -Antworten für HTTP-APIs in API Gateway transformieren.

Bei der Zuweisung von Parametern weisen Sie Anfrage- oder Antwortparameter zu. Sie können Parameter mithilfe von Ausdrücken zur Parameterzuweisung oder statischen Werten zuweisen. Eine Liste der Zuweisungsweisungsausdrücke finden Sie unter Quellenreferenz für Parameterzuweisungen für REST-APIs in API Gateway. Sie können die Zuweisung von Parametern in Ihrer Integrationsanforderung sowohl für Proxy- als auch für Nicht-Proxy-Integrationen verwenden. Um jedoch die Zuweisung von Parametern für eine Integrationsantwort zu nutzen, benötigen Sie eine Nicht-Proxy-Integration.

Beispielsweise können Sie den Header-Parameter puppies der Methodenanforderung dem Header-Parameter DogsAge0 der Integrationsanforderung zuweisen. Wenn ein Client den Header puppies:true an Ihre API sendet, sendet die Integrationsanforderung den Anfrage-Header DogsAge0:true an den Integrationsendpunkt. Das folgende Diagramm zeigt den Anfragelebenszyklus dieses Beispiels.

Diagramm eines Beispiels zur Parameterzuweisung in API Gateway für eine Anfrage

Informationen zum Erstellen dieses Beispiels mit API Gateway finden Sie unter Beispiel 1: Zuweisen eines Methodenanforderungsparameters zu einem Integrationsanforderungsparameter.

Als weiteres Beispiel können Sie den Header-Parameter kittens der Integrationsantwort dem Header-Parameter CatsAge0 der Methodenantwort zuweisen. Wenn der Integrationsendpunkt dann kittens:false zurückgibt, erhält der Client den Header CatsAge0:false. Das folgende Diagramm zeigt den Anfragelebenszyklus dieses Beispiels.

Diagramm eines Beispiels zur Parameterzuweisung in API Gateway für eine Anfrage