本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 API Gateway 中建立 WebSocket API
<a name="apigateway-websocket-api-create-empty-api"></a>

您可以在 API Gateway 主控台中使用 [create-api](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html) 命令， AWS CLI 或在 AWS SDK 中使用 `CreateApi` 命令來建立 WebSocket API。下列程序顯示如何建立新的 WebSocket API。

**注意**  
WebSocket API 僅支援 TLS 1.2 和 TLS 1.3。不支援舊版 TLS。

## 使用 AWS CLI 命令建立 WebSocket API
<a name="apigateway-websocket-api-create-using-awscli"></a>

以下 [create-api](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html) 命令會建立具有 `$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
<a name="apigateway-websocket-api-create-using-console"></a>

您可以選擇 WebSocket 通訊協定並為 API 提供名稱，以在主控台中建立 WebSocket API。

**重要**  
一旦建立 API 後，您無法更改您選擇的通訊協定。您無法將 WebSocket API 轉換到 REST API，反之亦然。

**使用 API Gateway 主控台建立 WebSocket API**

1. 登入 API Gateway 主控台，然後選擇 **Create API (建立 API)**。

1. 在 **WebSocket API** 下，選擇 **Build (建置)**。僅支援區域端點。

1. 針對 **API 名稱**，輸入您 API 的名稱。

1. 針對**路由選擇表達式**輸入值。例如 `$request.body.action`。

   如需路由選擇表達式的詳細資訊，請參閱[路由選擇表達式](websocket-api-develop-routes.md#apigateway-websocket-api-route-selection-expressions)。

1. 執行以下任意一項：
   + 選擇**建立空白 API** 以建立沒有路由的 API。
   + 選擇**下一步**將路由附加到您的 API。

   您可以在建立 API 之後附加路由。