

# 禁用 WebSocket API 的默认端点
<a name="websocket-api-disable-default-endpoint"></a>

默认情况下，客户端可以通过使用 API Gateway 为 API 生成的 `execute-api` 端点来调用您的 API。为确保客户端只能通过使用自定义域名访问您的 API，请禁用默认 `execute-api` 端点。禁用默认端点时，它会影响 API 的所有阶段。

以下过程说明了如何禁用 WebSocket API 的默认端点。

------
#### [ Amazon Web Services 管理控制台 ]

1. 通过以下网址登录到 Amazon API Gateway 控制台：[https://console.aws.amazon.com/apigateway](https://console.amazonaws.cn/apigateway)。

1. 选择 WebSocket API。

1. 选择 **API 设置**。

1. 在 **API 详细信息**选项卡上，选择**编辑**。

1. 对于**默认端点**，选择**非活动**。

1. 选择**保存更改**。

1. 在主导航窗格中，选择**路由**。

1. 选择**部署**，然后重新部署您的 API 或创建一个新阶段使更改生效。

------
#### [ Amazon CLI ]

以下 [update-api](https://docs.amazonaws.cn/cli/latest/reference/apigatewayv2/update-api.html) 命令会禁用 WebSocket API 的默认端点。

```
aws apigatewayv2 update-api \
    --api-id {{abcdef123}} \
    --disable-execute-api-endpoint
```

禁用默认端点后，必须部署 API 才能使更改生效。

以下 Amazon CLI 命令会创建部署。

```
aws apigatewayv2 create-deployment \
    --api-id {{abcdef123}} \
    --stage-name {{dev}}
```

------