Répertoriez et mettez à jour les contrôles et les états de routage à l'aide du AWS CLI

Après avoir créé les ressources de votre Amazon Route 53 Application Recovery Controller, telles que le cluster, les commandes de routage et les panneaux de commande, vous pouvez interagir avec le cluster pour répertorier et mettre à jour les états des contrôles de routage en vue du basculement.

Pour chaque cluster que vous créez, Route 53 ARC fournit un ensemble de points de terminaison de cluster, un sur cinq Régions AWS. Vous devez spécifier l'un de ces points de terminaison régionaux (le Région AWS et le point de terminaisonURL) lorsque vous appelez le cluster pour récupérer ou définir des états de contrôle de routage vers On ouOff. Lorsque vous utilisez le AWS CLI, pour obtenir ou mettre à jour des états de contrôle de routage, en plus du point de terminaison régional, vous devez également spécifier le point --region de terminaison régional, comme indiqué dans les exemples de cette section.

Vous pouvez utiliser n'importe quel point de terminaison du cluster régional. Nous vous recommandons d'alterner vos systèmes entre les points de terminaison régionaux et de vous préparer à réessayer avec chacun des points de terminaison disponibles. Pour des exemples de code illustrant l'essai de points de terminaison d'un cluster en séquence, consultezActions pour Application Recovery Controller utilisant AWS SDKs.

Pour plus d'informations sur l'utilisation du AWS CLI, consultez la référence des AWS CLI commandes. Pour obtenir la liste des API actions de contrôle du routage et des liens vers des informations supplémentaires, consultez APIOpérations de contrôle du routage.

Important

Bien que vous puissiez mettre à jour un état de contrôle de routage sur la console Amazon Route 53, nous vous recommandons de mettre à jour les états de contrôle de routage en utilisant le AWS CLI ou un AWS SDK. La Route 53 ARC offre une fiabilité extrême grâce au plan de données de contrôle de ARC routage Route 53 qui permet de réacheminer le trafic et de basculer entre les cellules. Pour plus de recommandations sur l'utilisation de Route 53 ARC pour le basculement, consultezMeilleures pratiques pour le contrôle du routage dans Route 53 ARC.

Lorsque vous créez un contrôle de routage, l'état est défini surOff. Cela signifie que le trafic n'est pas acheminé vers la cellule cible pour ce contrôle de routage. Vous pouvez vérifier l'état du contrôle de routage en exécutant la commandeget-routing-control-state.

Pour déterminer la région et le point de terminaison à spécifier, exécutez la describe-clusters commande pour afficher leClusterEndpoints. Chacune ClusterEndpoint inclut une région et un point de terminaison correspondant que vous pouvez utiliser pour obtenir ou mettre à jour les états du contrôle de routage. DescribeClusterest une API opération de configuration du contrôle de restauration. Nous vous recommandons de conserver une copie locale des points de terminaison de votre cluster ARC régional Route 53, dans des signets ou codée en dur dans du code d'automatisation que vous utilisez pour réessayer vos points de terminaison.

1. Lister les contrôles de routage

Vous pouvez consulter vos contrôles de routage et leurs états à l'aide des points de terminaison très fiables du plan de ARC données Route 53.

1. Répertoriez les commandes de routage pour un panneau de commande spécifique. Si vous ne spécifiez aucun panneau de configuration, list-routing-controls renvoie toutes les commandes de routage du 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. Bénéficiez de contrôles de routage

2. Obtenez un état de contrôle de routage.

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. Mettre à jour les contrôles de routage

Pour acheminer le trafic vers le point de terminaison cible contrôlé par le contrôle de routage, vous mettez à jour l'état du contrôle de routage surOn. Mettez à jour l'état du contrôle de routage en exécutant la commandeupdate-routing-control-state. (Lorsque la demande aboutit, la réponse est vide.)

2a. Mettez à jour un état de contrôle de routage.

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

{}

Vous pouvez mettre à jour plusieurs contrôles de routage en même temps en un seul API appel :update-routing-control-states. (Lorsque la demande aboutit, la réponse est vide.)

2 b. Mettez à jour plusieurs états de contrôle de routage à la fois (mises à jour par lots).

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

{}