在 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开发工具包中的 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. 对于 API 名称,输入 API 的名称。

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

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

  5. 请执行下列操作之一:

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

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

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