Creación de una API de WebSocket en API Gateway

Puede crear una API de WebSocket en la consola de API Gateway mediante el comando create-api de la AWS CLI o mediante el comando CreateApi en un AWS SDK. Los procedimientos que se describen a continuación muestran cómo crear una API de WebSocket nueva.

nota

Las API de WebSocket solo son compatibles con TLS 1.2. No se admiten versiones de TLS anteriores.

Creación de una API de WebSocket mediante comandos de la AWS CLI

La creación de una API de WebSocket mediante la AWS CLI requiere llamar al comando create-api, tal como se muestra en el siguiente ejemplo, que crea una API con la expresión de selección de ruta $request.body.action:

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

Ejemplo de salida:

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

Creación de una API de WebSocket mediante la consola de API Gateway

Para crear una API de WebSocket en la consola, elija el protocolo WebSocket y asígnele un nombre a la API.

importante

Una vez que haya creado la API, no podrá cambiar el protocolo que haya elegido para ella. No hay forma de convertir una API de WebSocket en una API de REST o viceversa.

Para crear una API de WebSocket mediante la consola de API Gateway

1. Inicie sesión en la consola de API Gateway y elija Create API (Crear API).

2. En WebSocket API (API de WebSocket), elija Build (Generar). Solo se admiten puntos de conexión regionales.

3. En Nombre de API, escriba el nombre de la API.

4. En Expresión de selección de ruta, introduzca un valor. Por ejemplo, $request.body.action.

   Para obtener más información sobre las expresiones de selección de ruta, consulte Expresiones de selección de ruta.

5. Realice una de las siguientes acciones siguientes:

   • Elija Crear una API en blanco para crear una API sin rutas.

   • Seleccione Siguiente para asociar rutas a su API.

   Puede asociar rutas después de crear su API.