在 API Gateway 中创建 WebSocket API

您可以使用 AWS CLI create-api 命令或AWS开发工具包中的 CreateApi 命令，在 API Gateway 控制台中创建 WebSocket API。以下过程说明如何创建新的 WebSocket API。

注意

WebSocket API 仅支持 TLS 1.2。不支持早期 TLS 版本。

使用 AWS CLI 命令创建 WebSocket API

使用 AWS CLI 创建 WebSocket API 需要调用 create-api 命令，如以下示例所示（该示例使用 $request.body.action 路由选择表达式创建 API）：

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

输出示例：

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

使用 API Gateway 控制台创建 WebSocket API

您可以通过选择 WebSocket 协议并为 API 命名来在控制台中创建 WebSocket API。

重要

创建 API 后，您无法更改为其选择的协议。无法将 WebSocket API 转换为 REST API，反之亦然。

使用 API Gateway 控制台创建 WebSocket API

1. 登录 API Gateway 控制台，然后选择创建 API。

2. 在 WebSocket API 下，选择构建。仅支持区域端点。

3. 对于 API 名称，输入 API 的名称。

4. 对于路由选择表达式，输入一个值。例如，$request.body.action。

   有关路由选择表达式的更多信息，请参阅路由选择表达式。

5. 请执行以下操作之一：

   • 选择创建空白 API，以创建没有路由的 API。

   • 选择下一步，将路由附加到 API。

   您可以在创建 API 之后附加路由。