View a markdown version of this page

Datenzuordnung für WebSocket APIs in API Gateway einrichten - Amazon API Gateway
Zuordnen von Routenanforderungsdaten zu IntegrationsanforderungsparameternBeispiele

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Datenzuordnung für WebSocket APIs in API Gateway einrichten

Mit der Datenzuordnung können Sie Daten aus einer Routenanforderung einer Backend-Integration zuordnen.

Anmerkung

Die Datenzuordnung für wird in der WebSocket APIs nicht unterstützt AWS-Managementkonsole. Sie müssen das AWS CLI, oder ein SDK verwenden AWS CloudFormation, um die Datenzuordnung zu konfigurieren.

Zuordnen von Routenanforderungsdaten zu Integrationsanforderungsparametern

Integrationsanforderungsparameter können aus beliebigen definierten Routenanforderungsparametern, dem Anforderungstext context oder stage-Variablen und statischen Werten zugeordnet werden.

In der folgenden Tabelle sehen Sie Datenzuordnungsausdrücke für Integrationsanfragen. In der Tabelle ist PARAM_NAME der Name eines Routenanforderungsparameters des angegebenen Parametertyps. Es muss mit dem regulären Ausdruck übereinstimmen'^[a-zA-Z0-9._$-]+$]'. JSONPath_EXPRESSIONist ein JSONPath Ausdruck für ein JSON-Feld des Hauptteils der Anfrage.

Zugewiesene Datenquelle Mapping-Ausdruck
Anforderungsabfragezeichenfolge (wird nur für die $connect-Route unterstützt) route.request.querystring.PARAM_NAME
Anforderungs-Header (wird nur für die $connect-Route unterstützt) route.request.header.PARAM_NAME
Abfragezeichenfolge mit mehreren Werten (nur für die $connect-Route unterstützt) route.request.multivaluequerystring.PARAM_NAME
Anforderungsheader mit mehreren Werten (nur für die $connect-Route unterstützt) route.request.multivalueheader.PARAM_NAME
Anforderungstext route.request.body.JSONPath_EXPRESSION
Stufenvariablen stageVariables.VARIABLE_NAME
Kontextvariablen context.VARIABLE_NAME, wobei die Variable zu den unterstützten Kontextvariablen gehören muss.
Statischer Wert 'STATIC_VALUE'. Das STATIC_VALUE ist ein Zeichenkettenliteral und muss in einfache Anführungszeichen eingeschlossen werden.

Achten Sie beim Erstellen einer Datenzuordnung auf das AWS CLI richtige Format für die Verwendung von Literalen mit Zeichenfolgen in. AWS CLI Weitere Informationen finden Sie unter Verwenden von Zeichenfolgen mit Anführungszeichen in der AWS CLI im Benutzerhandbuch zur AWS Command Line Interface .

Beispiele

In den folgenden AWS CLI Beispielen werden Datenzuordnungen konfiguriert. Eine CloudFormation Beispielvorlage finden Sie unter. websocket-data-mapping.yaml

Zuordnen der ConnectionID eines Clients zu einem Header in einer Integrationsanforderung

Der folgende update-integration-Befehl weist die connectionId eines Clients dem connectionId-Header in der Anfrage an eine Backend-Integration zu:

aws apigatewayv2 update-integration \
    --integration-id abc123 \
    --api-id a1b2c3d4 \ 
    --request-parameters 'integration.request.header.connectionId'='context.connectionId'

Zuordnen eines Abfragezeichenfolgenparameters zu einem Header in einer Integrationsanforderung

Das folgende Beispiel weist einen authToken-Abfragezeichenfolgenparameter dem authToken-Header in der Integrationsanforderung zu.

  1. Verwenden Sie den folgenden update-route-Befehl, um den authToken-Abfragezeichenfolgenparameter zu den Anforderungsparametern der Route hinzuzufügen.

    aws apigatewayv2 update-route --route-id 0abcdef \
    --api-id a1b2c3d4 \
    --request-parameters '{"route.request.querystring.authToken": {"Required": false}}'

  2. Verwenden Sie den folgenden update-integration-Befehl, um den Abfragezeichenfolgenparameter dem authToken-Header in der Anfrage an die Backend-Integration zuzuweisen.

    aws apigatewayv2 update-integration \
    --integration-id abc123 \
    --api-id a1b2c3d4 \
    --request-parameters 'integration.request.header.authToken'='route.request.querystring.authToken'

  3. (Optional) Gehen Sie bei Bedarf wie folgt vor, delete-route-request-parameterum den authToken Abfragezeichenfolgenparameter aus den Anforderungsparametern der Route zu löschen.

    aws apigatewayv2 delete-route-request-parameter \
    --route-id 0abcdef \
    --api-id a1b2c3d4 \
    --request-parameter-key 'route.request.querystring.authToken'