

# Como usar controles de failover para pontos de acesso multirregionais do Amazon S3
<a name="UsingFailover"></a>

Esta seção explica como gerenciar e usar os controles de failover para pontos de acesso multirregionais do Amazon S3 usando o Console de gerenciamento da AWS. 

Há dois controles de failover na seção **Failover configuration** (Configuração de failover) na página de detalhes do ponto de acesso multirregional no Console de gerenciamento da AWS: **Edit routing status** (Editar status de roteamento) e **Failover**. Você pode usar esses controles da seguinte maneira: 
+ **Edit routing status** (Editar status de roteamento): você pode editar manualmente os status de roteamento de até 17 Regiões da AWS em uma única solicitação para seu ponto de acesso multirregional escolhendo **Edit routing status** (Editar status de roteamento). Você pode usar a opção **Edit routing status** (Editar status de roteamento) para as seguintes finalidades: 
  + Para definir ou editar os status de roteamento de uma ou mais regiões em seu ponto de acesso multirregional
  + Para criar uma configuração de failover para seu ponto de acesso multirregional configurando duas regiões em um estado ativo-passivo
  + Para fazer o failover manualmente em suas regiões
  + Para alternar manualmente o tráfego entre regiões
+ **Failover**: ao iniciar o failover escolhendo **Failover**, você atualiza apenas os status de roteamento de duas regiões que já estejam configuradas em um estado ativo-passivo. Durante um failover que você iniciou escolhendo **Failover**, os status de roteamento entre as duas regiões são automaticamente alterados.

## Editar os status de roteamento das regiões em seu ponto de acesso multirregional
<a name="editing-mrap-routing-status"></a>

Você pode atualizar manualmente os status de roteamento de até 17 Regiões da AWS em uma única solicitação para seu ponto de acesso multirregional escolhendo **Edit routing status** (Editar status de roteamento) na seção **Failover configuration** (Configuração de failover) na página de detalhes do ponto de acesso multirregional. No entanto, ao iniciar o failover escolhendo **Failover**, você atualiza apenas os status de roteamento de duas regiões que já estejam configuradas em um estado ativo-passivo. Durante um failover que você iniciou escolhendo **Failover**, os status de roteamento entre as duas regiões são automaticamente alterados.

Você pode usar **Edit routing status** (Editar status de roteamento) (conforme descrito no procedimento a seguir) para as seguintes finalidades:
+ Para definir ou editar os status de roteamento de uma ou mais regiões em seu ponto de acesso multirregional
+ Para criar uma configuração de failover para seu ponto de acesso multirregional configurando duas regiões em um estado ativo-passivo
+ Para fazer o failover manualmente em suas regiões
+ Para alternar manualmente o tráfego entre regiões

### Usar o console do S3
<a name="update-mrap-routing-console"></a>

**Como atualizar os status de roteamento das regiões em seu ponto de acesso multirregional**



1. Faça login no Console de Gerenciamento AWS.

1. Abra o console do Amazon S3, em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação esquerdo, escolha **Multi-Region Access Points** (Pontos de acesso multirregionais).

1. Escolha o ponto de acesso multirregional que você deseja atualizar.

1. Escolha a guia **Replication and failover** (Replicação e failover).

1. Selecione uma ou mais regiões para as quais deseja editar o status do roteamento.
**nota**  
Para iniciar um failover, pelo menos uma Região da AWS deve ser designada como **Active** (Ativa) e uma região deve ser designada como **Passive** (Passiva) em seu ponto de acesso multirregional.

1. Escolha **Edit routing status** (Editar status de roteamento).

1. Na caixa de diálogo exibida, selecione **Active** (Ativo) ou **Passive** (Passivo) para o **Routing status** (Status de roteamento) de cada região.

   Um estado ativo permite que o tráfego seja roteado para a região. Um estado passivo impede que qualquer tráfego seja direcionado para a região.

   Se você estiver criando uma configuração de failover para o ponto de acesso multirregional ou iniciando um failover, pelo menos uma Região da AWS deverá ser designada como **Active** (Ativa) e uma região deverá ser designada como **Passive** (Passiva) em seu ponto de acesso multirregional.

1. Escolha **Save routing status** (Salvar status de roteamento). O redirecionamento do tráfego leva cerca de 2 minutos.

Depois de enviar o status de roteamento das Regiões da AWS para seu ponto de acesso multirregional, você poderá verificar as alterações no status de roteamento. Para verificar essas alterações, acesse o Amazon CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) para monitorar a mudança do tráfego de solicitações de dados do Amazon S3 (por exemplo, solicitações `GET` e `PUT`) entre regiões ativas e passivas. Nenhuma conexão existente será encerrada durante o failover. As conexões existentes continuarão até receberem um status de sucesso ou falha.

### Como usar o AWS CLI
<a name="update-mrap-routing-cli"></a>

**nota**  
Você pode executar comandos de roteamento da AWS CLI de pontos de acesso multirregionais em qualquer uma destas cinco regiões:  
`ap-southeast-2`
`ap-northeast-1`
`us-east-1`
`us-west-2`
`eu-west-1`

O exemplo de comando a seguir atualiza sua configuração de roteamento do ponto de acesso multirregional atual. Para atualizar o status ativo ou passivo de um bucket, defina o valor de `TrafficDialPercentage` como `100` para ativo e como `0` para passivo. Neste exemplo, `amzn-s3-demo-bucket1` é definido como ativo e *amzn-s3-demo-bucket2* é definido como passivo. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações. 

```
aws s3control submit-multi-region-access-point-routes
--region ap-southeast-2 
--account-id 123456789012 
--mrap MultiRegionAccessPoint_ARN
--route-updates Bucket=amzn-s3-demo-bucket1,TrafficDialPercentage=100
                Bucket=amzn-s3-demo-bucket2
,TrafficDialPercentage=0
```

O exemplo de comando a seguir obtém sua configuração de roteamento do ponto de acesso multirregional atualizada. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.

```
aws s3control get-multi-region-access-point-routes
--region eu-west-1
--account-id 123456789012
--mrap MultiRegionAccessPoint_ARN
```

## Iniciar failover
<a name="InitiatingFailover"></a>

Quando você inicia um failover escolhendo **Failover** na seção **Failover configuration** (Configuração de failover) na página de detalhes do ponto de acesso multirregional, o tráfego de solicitações do Amazon S3 é automaticamente transferido para uma Região da AWS alternativa. O processo de failover é concluído em 2 minutos. 

Você pode iniciar um failover em duas Regiões da AWS quaisquer por vez (das [17 regiões](https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiRegionAccessPointRestrictions.html) em que os pontos de acesso multirregionais são compatíveis). Depois, os eventos de failover são registrados em logs do AWS CloudTrail. Depois da conclusão do failover, você pode monitorar o tráfego do Amazon S3 e qualquer atualização de roteamento de tráfego para a nova região ativa no Amazon CloudWatch.

**Importante**  
Para manter todos os metadados e objetos sincronizados entre os buckets durante a replicação de dados, recomendamos que você crie regras de replicação bidirecional e habilite a sincronização de modificações da réplica antes de configurar controles de failover.   
As regras de replicação bidirecional ajudam a garantir que, quando os dados são gravados no bucket do Amazon S3 para o qual o tráfego faz failover, esses dados sejam replicados de volta para o bucket de origem. A sincronização de modificações da réplica ajuda a garantir que os metadados do objeto também sejam sincronizados entre os buckets durante a replicação bidirecional.   
Para obter mais informações sobre como configurar a replicação para que ofereça suporte a failover, consulte [Configurar a replicação para uso com pontos de acesso multirregionais](MultiRegionAccessPointBucketReplication.md).

**Como iniciar um failover entre buckets replicados**

1. Faça login no Console de Gerenciamento AWS.

1. Abra o console do Amazon S3, em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação esquerdo, escolha **Multi-Region Access Points** (Pontos de acesso multirregionais).

1. Escolha o ponto de acesso multirregional que deseja usar para iniciar o failover.

1. Escolha a guia **Replication and failover** (Replicação e failover).

1. Role para baixo até a seção **Failover configuration** (Configuração de failover) e selecione duas Regiões da AWS.
**nota**  
Para iniciar um failover, pelo menos uma Região da AWS deve ser designada como **Active** (Ativa) e uma região deve ser designada como **Passive** (Passiva) em seu ponto de acesso multirregional. Um estado ativo permite que o tráfego seja direcionado para uma região. Um estado passivo impede que qualquer tráfego seja direcionado para a região.

1. Escolha **Failover**.

1. Na caixa de diálogo, selecione **Failover** novamente para iniciar o processo de failover. Durante esse processo, os status de roteamento das duas regiões são automaticamente alterados. Todo novo tráfego é direcionado para a região que se torna ativa, e o tráfego deixa de ser direcionado para a região que se torna passiva. O redirecionamento do tráfego leva cerca de 2 minutos.

   Depois de iniciar o processo de failover, você pode verificar as alterações no tráfego. Para verificar essas alterações, acesse o Amazon CloudWatch em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) para monitorar a mudança do tráfego de solicitações de dados do Amazon S3 (por exemplo, solicitações `GET` e `PUT`) entre regiões ativas e passivas. Nenhuma conexão existente será encerrada durante o failover. As conexões existentes continuarão até receberem um status de sucesso ou falha. 

## Visualizar controles de roteamento de pontos de acesso multirregionais do Amazon S3
<a name="viewing-mrap-routing-controls"></a>

### Usar o console do S3
<a name="viewing-mrap-routing-console"></a>

**Como visualizar controles de roteamento de pontos de acesso multirregionais do Amazon S3**



1. Faça login no Console de Gerenciamento AWS.

1. Abra o console do Amazon S3, em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação esquerdo, escolha **Multi-Region Access Points** (Pontos de acesso multirregionais).

1. Escolha o ponto de acesso multirregional que você deseja revisar.

1. Escolha a guia **Replication and failover** (Replicação e failover). Esta página exibe os detalhes e o resumo da configuração de roteamento do seu ponto de acesso multirregional, das regras de replicação associadas e das métricas de replicação. Você pode ver o status de roteamento de suas regiões na seção **Failover configuration** (Configuração de failover).

### Como usar o AWS CLI
<a name="viewing-mrap-routing-cli"></a>

O exemplo de comando da AWS CLI a seguir obtém sua configuração de roteamento atual do ponto de acesso multirregional para a região especificada. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.

```
aws s3control get-multi-region-access-point-routes
--region eu-west-1
--account-id 123456789012 
--mrap MultiRegionAccessPoint_ARN
```

**nota**  
Esse comando só pode ser executado nestas cinco regiões:  
`ap-southeast-2`
`ap-northeast-1`
`us-east-1`
`us-west-2`
`eu-west-1`