

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
<a name="apigateway-websocket-api-create-empty-api"></a>

Sie können eine WebSocket API in der API Gateway Gateway-Konsole erstellen, indem Sie den Befehl AWS CLI [create-api](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html) oder den `CreateApi` Befehl in einem AWS SDK verwenden. Die folgenden Verfahren zeigen, wie Sie eine neue WebSocket API erstellen.

**Anmerkung**  
WebSocket APIs unterstützt 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
<a name="apigateway-websocket-api-create-using-awscli"></a>

Der folgende [create-api](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html)-Befehl erstellt eine API mit dem Routen-Auswahlausdruck `$request.body.action`:

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

Die Ausgabe sollte wie folgt aussehen:

```
{
    "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
<a name="apigateway-websocket-api-create-using-console"></a>

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)**.

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

1. Geben Sie unter **API-Name** den Namen Ihrer API ein.

1. Geben Sie unter **Ausdruck für die Routenauswahl** einen Wert ein. Beispiel, `$request.body.action`. 

   Weitere Informationen zu Routen-Auswahlausdrücken finden Sie unter [Routen-Auswahlausdrücke](websocket-api-develop-routes.md#apigateway-websocket-api-route-selection-expressions).

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