在 API Gateway 中创建 WebSocket API - Amazon API Gateway
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

在 API Gateway 中创建 WebSocket API

您可以使用 Amazon CLI create-api 命令或使用 Amazon SDK 中的 CreateApi 命令,在 API Gateway 控制台中创建 WebSocket API。以下过程说明如何创建新的 WebSocket API。

注意

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

使用 Amazon CLI 命令创建 WebSocket API

使用 Amazon 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 之后附加路由。