# Editar ou excluir um canário
<a name="synthetics_canaries_deletion"></a>

É possível editar ou excluir um canário existente.

 **Edit canary (Editar canário** 

Quando você edita um canário, mesmo sem alterar a agendamento, o agendamento é redefinido para corresponder ao momento em que você edita o canário. Por exemplo, se você tiver um canário que é executado a cada hora e editar esse canário, ele será executado imediatamente após a conclusão da edição e a cada hora depois disso.

**Para editar ou atualizar um canário**

1. Abra o console do CloudWatch, em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, escolha **Application Signals**, **Canários do Synthetics**.

1. Selecione o botão ao lado do nome do canário e escolha **Ações**, **Editar**.

1. (Opcional) Se esse canário executar o monitoramento visual das capturas de tela e você quiser definir a próxima execução do canário como linha de base, selecione **Set next run as new baseline** (Definir a próxima execução como nova linha de base).

1. (Opcional) Se esse canário executar o monitoramento visual de capturas de tela e você desejar remover uma captura de tela do monitoramento visual ou designar partes da captura de tela a serem ignoradas durante comparações visuais, em **Visual Monitoring** (Monitoramento visual), escolha **Edit Baseline** (Editar linha de base).

   A captura de tela será exibida, e você poderá executar uma das seguintes ações:
   + Para remover a captura de tela de ser usada para monitoramento visual, selecione **Remove screenshot from visual test baseline** (Remover captura de tela da linha de base do teste visual).
   + Para designar partes da captura de tela a serem ignoradas durante comparações visuais, clique e arraste para traçar as áreas da tela a serem ignoradas. Depois de ter feito isso para todas as áreas que deseja ignorar durante as comparações, escolha **Save** (Salvar).

1. Em **Editor de scripts**, **Versão do runtime**, selecione uma versão do runtime do Synthetics para executar o canário. Para obter informações sobre as versões do runtime do Synthetics, consulte [Versões do runtime do Synthetics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Library.html).

   Em **Configuração do navegador**, você pode habilitar o navegador para testar o canário. É necessário selecionar pelo menos um navegador.

1. Faça todas as outras alterações que desejar no canário e escolha **Save** (Salvar).

 **Delete canary (Excluir canário** 

Ao excluir um canário, você pode escolher se também deseja excluir outros recursos usados e criados pelo canário. Se o campo `ProvisionedResourceCleanup` do canário estava definido como ` AUTOMATIC` ou `DeleteLambda` estava especificado como `true` quando você excluiu o canário, o CloudWatch Synthetics excluirá automaticamente as funções e camadas do Lambda que são usadas pelo canário.

Ao excluir um canário, também será necessário excluir o seguinte:
+ As camadas e as funções do Lambda usadas por esse canário. O prefixo é `cwsyn- MyCanaryName`.
+ Os alarmes do CloudWatch criados para esse canário. Esses alarmes têm um nome que começa com ` Synthetics-Alarm-MyCanaryName`. Para obter mais informações sobre como excluir alarmes, consulte [Como editar ou excluir um alarme do CloudWatch](Edit-CloudWatch-Alarm.md).
+ Os objetos e os buckets do Amazon S3, como os locais de resultados e os locais de artefatos do canário.
+ As funções do IAM criadas para o canário. Elas têm o nome ` role/service-role/CloudWatchSyntheticsRole-MyCanaryName`. 
+ Grupos de logs do CloudWatch Logs criados para o canário. Esses grupos de logs têm os seguintes nomes: `/aws/lambda/cwsyn-MyCanaryName-{{randomId}}` . 

Antes de excluir um canário, convém visualizar os detalhes do canário e anotar essas informações. Dessa forma, é possível excluir os recursos corretos depois de excluir o canário.

**Para excluir um canário**

1. Abra o console do CloudWatch, em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. No painel de navegação, escolha **Application Signals**, **Canários do Synthetics**.

1. Se atualmente o canário estiver no estado `RUNNING`, você deve interrompê-lo. Só é possível excluir canaries nos estados `STOPPED`, `READY(NOT_STARTED)` ou `ERROR`.

   Para interromper o canário, selecione o botão ao lado do nome do canário e escolha **Ações**, **Parar**.

1. Selecione o botão ao lado do nome do canário e escolha **Ações**, **Excluir**.

1. Escolha se também deseja excluir os outros recursos criados para e usados pelo canário. As camadas e as funções do Lambda serão excluídas junto com o canário, mas você também poderá optar por excluir o perfil e a política do IAM do canário.

   Insira **Delete** na caixa e escolha **Delete** (Excluir).

1. Exclua os outros recursos usados e criados para o canário, conforme listado anteriormente nesta seção.