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

在 API Gateway 中创建 WebSocket API

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

注意

WebSocket API 仅支持 TLS 1.2。不支持早期 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. Settings (设置) 下面的 API name (API 名称) 字段中,输入 API 的名称,例如,PetStore

  4. 为 API 输入 Route Selection Expression (路由选择表达式),例如,$request.body.action

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

  5. 如果需要,为 API 输入 Description (描述)

  6. 选择 Create API (创建 API)