As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Liste e atualize os controles e estados de roteamento com o AWS CLI
<a name="getting-started-cli-routing.control-state"></a>

Após criar os recursos do Controlador de Recuperação de Aplicações (ARC) da Amazon, como cluster, controles de roteamento e painéis de controle, você pode interagir com o cluster para listar e atualizar os estados do controle de roteamento para failover.

Para cada cluster que você criar, o ARC fornece um conjunto de endpoints de cluster, um em cada cinco Regiões da AWS. Você deve especificar um desses endpoints regionais (o Região da AWS e o URL do endpoint) ao fazer chamadas para o cluster para recuperar ou definir estados de controle de roteamento como ou. `On` `Off` Ao usar o AWS CLI, para obter ou atualizar os estados de controle de roteamento, além do endpoint regional, você também deve especificar o `--region` do endpoint regional, conforme mostrado nos exemplos desta seção.

Você pode usar qualquer um dos endpoints do cluster regional. Recomendamos que seus sistemas alternem entre os endpoints regionais e estejam preparados para tentar novamente com cada um dos endpoints disponíveis. Para exemplos de código que ilustram como testar endpoints de cluster em sequência, consulte [Ações para o Application Recovery Controller usando AWS SDKs](service_code_examples_actions.md).

Para obter mais informações sobre como usar o AWS CLI, consulte a Referência de AWS CLI Comandos. Para conferir uma lista das ações de API de controle de roteamento e links para mais informações, consulte [Operações de API de controle de roteamento](actions.routing-control.md).

**Importante**  
Embora você possa atualizar um estado de controle de roteamento no console do Amazon Route 53, recomendamos que você [atualize os estados de controle de roteamento](routing-control.update.api.md) usando o AWS CLI ou um AWS SDK. O ARC oferece extrema confiabilidade com o plano de dados de controle de roteamento do ARC para redirecionar o tráfego e fazer o failover entre células. Para obter mais recomendações sobre o uso do ARC para failover, consulte [Práticas recomendadas para o controle de roteamento no ARC](route53-arc-best-practices.regional.md).

Ao criar um controle de roteamento, o estado é definido como `Off`. Isso significa que o tráfego não é roteado para a célula de destino desse controle de roteamento. Você pode verificar o estado do controle de roteamento executando o comando `get-routing-control-state`.

Para determinar a região e o endpoint a serem especificados, execute o comando `describe-clusters` para visualizar o `ClusterEndpoints`. Cada um `ClusterEndpoint` inclui uma região e um endpoint correspondente que você pode usar para obter ou atualizar os estados de controle de roteamento. *[DescribeCluster](https://docs.aws.amazon.com/recovery-cluster/latest/api/cluster-clusterarn.html)é uma operação de API de configuração de controle de recuperação. Recomendamos que você mantenha uma cópia local dos endpoints de cluster regional do ARC, em marcadores ou codificada no código de automação que você usa para tentar novamente os endpoints*.

## 1. Listar os controles de roteamento
<a name="getting-started-cli-routing.view-rc"></a>

Você pode visualizar os controles de roteamento e estados de controle de roteamento usando os endpoints altamente confiáveis do plano de dados do ARC.

1. Liste os controles de roteamento para um painel de controle específico. Se você não especificar um painel de controle, o `list-routing-controls` retornará todos os controles de roteamento no cluster.

```
aws route53-recovery-cluster list-routing-controls --control-panel-arn \
        arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456 \ 
        --region us-west-2 \
        --endpoint-url https://host-dddddd.us-west-2.example.com/v1
```

```
{
    "RoutingControls": [{
        "ControlPanelArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456",
        "ControlPanelName": "ExampleControlPanel",
        "RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567",
        "RoutingControlName": "RCOne",
        "RoutingControlState": "On"
    },
    {
        "ControlPanelArn": "arn:aws:route53-recovery-control::023759465626:controlpanel/0123456bbbbbbb0123456bbbbbb0123456",
        "ControlPanelName": "ExampleControlPanel",
        "RoutingControlArn": "arn:aws:route53-recovery-control::023759465626:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/zzzzxxxxyyyy123456",
        "RoutingControlName": "RCTwo",
        "RoutingControlState": "Off"
    }
]
```

## 2. Obtenção dos controles de roteamento
<a name="getting-started-cli-routing.get-rc"></a>

2. Obter um estado de controle de roteamento.

```
aws route53-recovery-cluster get-routing-control-state --routing-control-arn \
        arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567 \
        --region us-west-2 \
        --endpoint-url https://host-dddddd.us-west-2.example.com/v1
```

```
{"RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567",
    "RoutingControlName": "RCOne",
    "RoutingControlState": "On"
}
```

## 2. Atualização dos controles de roteamento
<a name="getting-started-cli-routing.update-rc"></a>

Para rotear o tráfego para o endpoint de destino controlado pelo controle de roteamento, atualize o estado do controle de roteamento para `On`. Atualize o estado do controle de roteamento executando o comando `update-routing-control-state`. Quando a solicitação for bem-sucedida, a resposta estará vazia.

2a. Atualizar um estado de controle de roteamento.

```
aws route53-recovery-cluster update-routing-control-state \
        --routing-control-arn \
        arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567 \
        --routing-control-state On \
        --region us-west-2 \
        --endpoint-url https://host-dddddd.us-west-2.example.com/v1
```

```
{}
```

Você pode atualizar vários controles de roteamento ao mesmo tempo com uma chamada de API:`update-routing-control-states`. Quando a solicitação for bem-sucedida, a resposta estará vazia.

2b. Atualizar vários estados de controle de roteamento de uma só vez (atualizações em lote).

```
aws route53-recovery-cluster update-routing-control-states \
        --update-routing-control-state-entries \
        '[{"RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567",
        "RoutingControlState": "Off"}, \
        {"RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/hijklmnop987654321",
        "RoutingControlState": "On"}]' \
        --region us-west-2 \
        --endpoint-url https://host-dddddd.us-west-2.example.com/v1
```

```
{}
```