# 关闭金丝雀版本
<a name="delete-canary-deployment"></a>

要关闭金丝雀版本部署，请将 [https://docs.amazonaws.cn/apigateway/latest/api/API_Stage.html#canarySettings](https://docs.amazonaws.cn/apigateway/latest/api/API_Stage.html#canarySettings) 设置为 Null 以从阶段中删除它。

您可以使用 API Gateway 控制台、Amazon CLI 或Amazon开发工具包禁用 Canary 版本部署。

**Topics**
+ [使用 API Gateway 控制台关闭金丝雀版本](#delete-canary-release-console)
+ [使用 Amazon CLI 关闭金丝雀版本](#delete-canary-release-cli)

## 使用 API Gateway 控制台关闭金丝雀版本
<a name="delete-canary-release-console"></a>

要使用 API Gateway 控制台关闭金丝雀版本部署，请执行以下步骤：

**关闭金丝雀版本部署**

1. 登录 API Gateway 控制台并在主导航窗格中选择现有 API。

1. 在主导航窗格中，选择**阶段**，然后选择一个现有阶段。

1.  选择**金丝雀**选项卡。

1.  选择**删除**。

1.  选择 **Delete (删除)** 确认您要删除 Canary。

结果，[https://docs.amazonaws.cn/apigateway/latest/api/API_Stage.html#canarySettings](https://docs.amazonaws.cn/apigateway/latest/api/API_Stage.html#canarySettings) 属性变为 `null`，并从部署[阶段](https://docs.amazonaws.cn/apigateway/latest/api/API_Stage.html)中删除。您可以使用 Amazon CLI 验证此项。有关示例，请查看[使用 Amazon CLI 关闭金丝雀版本](#delete-canary-release-cli)。

## 使用 Amazon CLI 关闭金丝雀版本
<a name="delete-canary-release-cli"></a>

以下 [update-stage](https://docs.amazonaws.cn/cli/latest/reference/apigateway/update-stage.html) 命令关闭金丝雀版本部署：

```
aws apigateway update-stage \
    --rest-api-id abcd1234 \
    --stage-name canary \
    --patch-operations '[{"op":"remove", "path":"/canarySettings"}]'
```

输出内容如下所示：

```
{
    "stageName": "prod", 
    "accessLogSettings": {
        ...
    }, 
    "cacheClusterEnabled": false, 
    "cacheClusterStatus": "NOT_AVAILABLE", 
    "deploymentId": "nfcn0x", 
    "lastUpdatedDate": 1511309280, 
    "createdDate": 1511152939, 
    "methodSettings": {
        ...
    }
}
```

 如输出中所示，在禁用了金丝雀的部署中，[stage](https://docs.amazonaws.cn/apigateway/latest/api/API_Stage.html) 中不再有 [canarySettings](https://docs.amazonaws.cn/apigateway/latest/api/API_Stage.html#canarySettings) 属性。