# Gerenciamento de canários multirregionais
<a name="CloudWatch_Synthetics_MultiLocation_Managing"></a>

## Criação de um canário multirregional
<a name="CloudWatch_Synthetics_MultiLocation_Create_Manage"></a>

Para criar um canário multirregional, siga as etapas em [Criar um canário](CloudWatch_Synthetics_Canaries_Create.md) e selecione regiões adicionais em **Localizações**. A região atual é automaticamente selecionada como a localização primária.

Ao criar um canário multirregional, os seguintes requisitos se aplicam:
+ É possível adicionar até 50 locais de réplicas.
+ O arquivo .zip do script do canário não deve exceder 50 MB.
+ O nome do canário ainda não deve existir em nenhuma das regiões de réplica selecionadas.
+ Os locais das réplicas devem ser compatíveis com as regiões comerciais do CloudWatch Synthetics. A região principal não pode ser selecionada como um local de réplica.
+ Os canários multirregionais não podem ser associados a um grupo. Se seu canário pertencer a um grupo, desassocie-o de todos os grupos antes de adicionar os locais das réplicas.
+ Se seu canário exigir conectividade com a VPC, você deverá definir as configurações da VPC para cada região de réplica separadamente. As configurações de VPC não são herdadas da principal.
+ As tags não são replicadas em regiões de réplica. Para adicionar tags a uma réplica, navegue até a região da réplica e adicione tags diretamente.

Após a criação, as réplicas são provisionadas de forma assíncrona. Você pode monitorar o progresso da replicação na página de detalhes do canário na guia **Configuração**. Quando uma réplica atinge o estado `InSync`, ela está totalmente provisionada e em execução. Você também pode ver o canário da réplica diretamente na região da réplica. Para obter mais informações, consulte [Status de replicação](#CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage).

Se uma réplica falhar no provisionamento, o canário primário ainda será criado com êxito. A réplica com falha exibe um status de replicação `Inconsistent`. Você pode tentar novamente atualizando o canário.

## Adição ou remoção de locais de réplicas
<a name="CloudWatch_Synthetics_MultiLocation_Update_Manage"></a>

Para adicionar ou remover locais de réplica, edite o canário da região principal e atualize as seleções em **Localizações**. Você não pode editar um canário multirregional de uma região de réplica. Para obter mais informações sobre a edição de um canário, consulte [Editar ou excluir um canário](synthetics_canaries_deletion.md).

Ao adicionar ou remover locais de réplicas, os seguintes requisitos se aplicam:
+ Você não pode modificar um canário multirregiona enquanto a replicação está em andamento. Aguarde até que todas as réplicas cheguem ao estado `InSync` ou `Inconsistent` antes de fazer alterações. Para obter mais informações, consulte [Status de replicação](#CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage).
+ Quando for adicionar locais de réplicas, inclua o código do canário na solicitação.
+ Ao atualizar um canário com réplicas inconsistentes, você deve incluir o código do canário, a menos que esteja removendo todas as réplicas inconsistentes na mesma solicitação.
+ Não é possível adicionar e remover o mesmo local em uma única solicitação.
+ Você não pode remover um local de réplica que não existe.

## Início e interrupção de um canário multirregional
<a name="CloudWatch_Synthetics_MultiLocation_StartStop_Manage"></a>

Quando você inicia ou interrompe um canário multirregional, a ação se aplica ao canário primário e a todos os locais de réplica.

Ao iniciar ou interromper um canário multirregional, os seguintes requisitos se aplicam:
+ Você deve iniciar ou parar o canário na região principal. As operações de início e término não são permitidas em uma região de réplica.
+ Você não pode iniciar ou interromper um canário multirregional enquanto a replicação estiver em andamento. Aguarde até que todas as réplicas cheguem ao estado `InSync` ou `Inconsistent` antes de iniciar ou interromper. Para obter mais informações, consulte [Status de replicação](#CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage).
+ O canário deve estar no estado `READY` ou `STOPPED` para iniciar ou no estado `RUNNING` para ser interrompido.

## Exclusão de um canário multirregional
<a name="CloudWatch_Synthetics_MultiLocation_Delete_Manage"></a>

Para excluir um canário multirregional, você deve primeiro remover todos os locais de réplica. Para obter mais informações, consulte [Editar ou excluir um canário](synthetics_canaries_deletion.md). Os requisitos a seguir se aplicam:
+ Você deve excluir o canário da região principal. Operações de exclusão não são permitidas em uma região de réplica.
+ Aguarde até que todas as réplicas sejam totalmente removidas antes de tentar excluí-las. Você pode monitorar o progresso na guia **Configuração**. Para obter mais informações, consulte [Status de replicação](#CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage).
+ O canário deve estar no estado `STOPPED`, `READY` ou `ERROR`. Se o canário estiver em execução, interrompa-o primeiro.

## Status de replicação
<a name="CloudWatch_Synthetics_MultiLocation_ReplicationStatus_Manage"></a>

O status de replicação indica o estado de sincronização de uma réplica com o canário primário. Você pode ver o status da replicação na página de detalhes do canário na guia **Configuração**.

As réplicas podem ter um dos valores de status de replicação a seguir:
+ **InProgress** — a réplica está sendo criada ou atualizada. As alterações do primário estão sendo propagadas para a réplica.
+ **InSync** — a réplica está totalmente sincronizada com a configuração do canário primário.
+ **Inconsistent** — a réplica está fora de sincronia com o canário primário. Isso pode ocorrer se uma propagação falhar. Você pode tentar novamente atualizando o canário mais uma vez.

O *ReplicationState* geral no canário primário mostra o estado agregado em todas as réplicas. Se alguma réplica for `InProgress`, o estado geral será `InProgress`. Se alguma réplica for `Inconsistent`, o estado geral será `Inconsistent`.