Liste e atualize os controles e estados de roteamento com o AWS CLI

Depois de criar seus recursos do Amazon Route 53 Application Recovery Controller, como cluster, controles de roteamento e painéis de controle, você pode interagir com o cluster para listar e atualizar os estados de controle de roteamento para failover.

Para cada cluster que você cria, o Route 53 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 endpointURL) 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 passem pelos 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.

Para obter mais informações sobre como usar o AWS CLI, consulte a Referência de AWS CLI Comandos. Para obter uma lista de API ações de controle de roteamento e links para obter mais informações, consulte Operações de controle API de roteamento.

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 usando o AWS CLI ou a. AWS SDK O Route 53 ARC oferece extrema confiabilidade com o plano de dados de controle ARC de roteamento do Route 53 para redirecionar o tráfego e fazer failover entre células. Para obter mais recomendações sobre o uso do Route 53 ARC para failover, consulteMelhores práticas para controle de roteamento no Route 53 ARC.

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 ClusterEndpoint inclui uma região e um endpoint correspondente que você pode usar para obter ou atualizar os estados de controle de roteamento. DescribeClusteré uma API operação de configuração de controle de recuperação. Recomendamos que você mantenha uma cópia local dos endpoints do cluster ARC regional do Route 53, em marcadores ou codificada no código de automação que você usa para tentar novamente seus endpoints.

1. Listar os controles de roteamento

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

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. Obtenha controles de roteamento

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. Atualizar controles de roteamento

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 API chamada: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

{}