# Desativar uma versão de canário
<a name="delete-canary-deployment"></a>

Para desativar uma implantação da versão de canário, defina [https://docs.aws.amazon.com/apigateway/latest/api/API_Stage.html#canarySettings](https://docs.aws.amazon.com/apigateway/latest/api/API_Stage.html#canarySettings) como nulo para removê-la do estágio. 

Você pode desativar uma implantação do lançamento canary usando o console do API Gateway, a AWS CLI ou um SDK da AWS.

**Topics**
+ [Desativar uma versão de canário usando o console do API Gateway](#delete-canary-release-console)
+ [Desativar uma versão de canário usando a AWS CLI](#delete-canary-release-cli)

## Desativar uma versão de canário usando o console do API Gateway
<a name="delete-canary-release-console"></a>

Para usar o console do API Gateway para desativar uma implantação da versão de canário, siga as seguintes etapas:

**Como desativar uma implantação da versão de canário**

1. Faça login no console do API Gateway e escolha uma API existente no painel de navegação principal.

1. No painel de navegação principal, selecione **Estágios** e escolha um estágio existente.

1.  Selecione a guia **Canário**.

1.  Escolha **Excluir**.

1.  Confirme se você deseja excluir o canary escolhendo **Delete**.

Como resultado, a propriedade [https://docs.aws.amazon.com/apigateway/latest/api/API_Stage.html#canarySettings](https://docs.aws.amazon.com/apigateway/latest/api/API_Stage.html#canarySettings) se torna `null` e é removida do [estágio](https://docs.aws.amazon.com/apigateway/latest/api/API_Stage.html) da implantação. Você pode verificar isso usando a AWS CLI. Por exemplo, consulte [Desativar uma versão de canário usando a AWS CLI](#delete-canary-release-cli).

## Desativar uma versão de canário usando a AWS CLI
<a name="delete-canary-release-cli"></a>

O comando [update-stage](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-stage.html) indicado abaixo desativa a implantação da versão canário:

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

A saída será exibida como a seguir:

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

 Como mostrado na saída, a propriedade [canarySettings](https://docs.aws.amazon.com/apigateway/latest/api/API_Stage.html#canarySettings) não está mais presente no [estágio](https://docs.aws.amazon.com/apigateway/latest/api/API_Stage.html) de uma implantação desabilitada para canário.