WebSocket APIs im API Gateway erstellen - APIAmazon-Gateway
Erstellen Sie eine WebSocket API mithilfe von AWS CLI BefehlenErstellen Sie eine WebSocket API mit der API Gateway Gateway-Konsole

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.

WebSocket APIs im API Gateway erstellen

Sie können eine WebSocket API in der API Gateway Gateway-Konsole erstellen, indem Sie den Befehl AWS CLI create-api oder den CreateApi Befehl in einem AWS SDK verwenden. Die folgenden Verfahren zeigen, wie Sie eine neue WebSocket API erstellen.

Anmerkung

WebSocket APIs unterstützen nur TLS 1.2 und TLS 1.3. Frühere TLS-Versionen werden nicht unterstützt.

Erstellen Sie eine WebSocket API mithilfe von AWS CLI Befehlen

Um eine WebSocket API mit dem zu erstellen, AWS CLI muss der Befehl create-api aufgerufen werden, wie im folgenden Beispiel gezeigt, der eine API mit dem $request.body.action Routenauswahlausdruck erstellt:

aws apigatewayv2 --region us-east-1 create-api --name "myWebSocketApi3" --protocol-type WEBSOCKET --route-selection-expression '$request.body.action'

Beispielausgabe:

{
    "ApiKeySelectionExpression": "$request.header.x-api-key",
    "Name": "myWebSocketApi3",
    "CreatedDate": "2018-11-15T06:23:51Z",
    "ProtocolType": "WEBSOCKET",
    "RouteSelectionExpression": "'$request.body.action'",
    "ApiId": "aabbccddee"
}

Erstellen Sie eine WebSocket API mit der API Gateway Gateway-Konsole

Sie können eine WebSocket API in der Konsole erstellen, indem Sie das WebSocket Protokoll auswählen und der API einen Namen geben.

Wichtig

Sobald Sie die API erstellt haben, können Sie das für sie ausgewählte Protokoll nicht mehr ändern. Es gibt keine Möglichkeit, eine WebSocket API in eine REST-API umzuwandeln oder umgekehrt.

So erstellen Sie eine WebSocket API mit der API Gateway Gateway-Konsole

  1. Melden Sie sich bei der API Gateway-Konsole an und wählen Sie Create API (API erstellen).

  2. Wählen Sie unter WebSocket API die Option Build aus. Es werden nur regionale Endpunkte unterstützt.

  3. Geben Sie unter API-Name den Namen Ihrer API ein.

  4. Geben Sie unter Ausdruck für die Routenauswahl einen Wert ein. z. B. $request.body.action.

    Weitere Informationen zu Routen-Auswahlausdrücken finden Sie unter Routen-Auswahlausdrücke.

  5. Führen Sie eine der folgenden Aktionen aus:

    • Wählen Sie Leere API erstellen aus, wenn Sie eine API ohne Routen erstellen möchten.

    • Klicken Sie auf Weiter, um Ihrer API Routen anzuhängen.

    Sie können Routen anhängen, nachdem Sie Ihre API erstellt haben.