Auflisten und Aktualisieren von Routingsteuerungen und Status mit dem AWS CLI

Nachdem Sie Ihre Amazon Route 53 Application Recovery Controller-Ressourcen wie Cluster, Routing-Steuerelemente und Kontrollfelder erstellt haben, können Sie mit dem Cluster interagieren, um die Routing-Kontrollstatus für Failover aufzulisten und zu aktualisieren.

Für jeden Cluster, den Sie erstellen, ARC stellt Ihnen Route 53 eine Reihe von Cluster-Endpunkten zur Verfügung, jeweils einen von fünf AWS-Regionen. Sie müssen einen dieser regionalen Endpunkte (den AWS-Region und den EndpunktURL) angeben, wenn Sie den Cluster aufrufen, um den Status der Routing-Steuerung abzurufen oder auf oder zu On setzen. Off Wenn Sie zum Abrufen oder Aktualisieren der AWS CLI Routingsteuerungsstatus zusätzlich zum regionalen Endpunkt auch den regionalen Endpunkt verwenden, müssen Sie, wie in den Beispielen in diesem Abschnitt gezeigt, auch den regionalen Endpunkt angeben. --region

Sie können jeden der regionalen Cluster-Endpunkte verwenden. Wir empfehlen, dass Ihre Systeme abwechselnd die regionalen Endpunkte verwenden und bereit sein, es mit jedem der verfügbaren Endpunkte erneut zu versuchen. Codebeispiele, die veranschaulichen, wie Cluster-Endpunkte nacheinander getestet werden, finden Sie unter. Aktionen für Application Recovery Controller unter Verwendung AWS SDKs

Weitere Informationen zur Verwendung von finden Sie in der AWS CLI Befehlsreferenz. AWS CLI Eine Liste der API Routingsteuerungsaktionen und Links zu weiteren Informationen finden Sie unter Routing-Steuerungsvorgänge API.

Wichtig

Sie können zwar einen Status der Routing-Steuerung auf der Amazon Route 53-Konsole aktualisieren, wir empfehlen jedoch, den Status der Routing-Steuerung mithilfe von AWS CLI oder an zu aktualisieren AWS SDK. Route 53 ARC bietet extreme Zuverlässigkeit mit der Route 53 ARC 53-Routing-Steuerungsdatenebene für die Umleitung von Verkehr und Failover zwischen Zellen. Weitere Empfehlungen zur Verwendung von Route 53 ARC für Failover finden Sie unterBewährte Methoden für die Routingsteuerung in Route 53 ARC.

Wenn Sie eine Routingsteuerung erstellen, wird der Status auf Off gesetzt. Das bedeutet, dass der Verkehr nicht an die Zielzelle für diese Routingsteuerung weitergeleitet wird. Sie können den Status der Routingsteuerung überprüfen, indem Sie den Befehl get-routing-control-state ausführen.

Um die Region und den anzugebenden Endpunkt zu ermitteln, führen Sie den describe-clusters Befehl zum Anzeigen von ausClusterEndpoints. Jeder ClusterEndpoint enthält eine Region und einen entsprechenden Endpunkt, mit denen Sie den Status der Routing-Steuerung abrufen oder aktualisieren können. DescribeClusterist ein API Konfigurationsvorgang für die Wiederherstellungssteuerung. Wir empfehlen Ihnen, eine lokale Kopie Ihrer ARC regionalen Route 53 53-Cluster-Endpunkte in Form von Lesezeichen oder hartcodiert im Automatisierungscode aufzubewahren, mit dem Sie Ihre Endpunkte erneut versuchen.

1. Routing-Steuerelemente auflisten

Sie können Ihre Routingsteuerungen und Routingsteuerungsstatus mithilfe der äußerst zuverlässigen Route 53 ARC 53-Datenebenen-Endpunkte anzeigen.

1. Listet die Routing-Steuerelemente für ein bestimmtes Bedienfeld auf. Wenn Sie kein Control Panel angeben, werden alle Routing-Steuerelemente im Cluster list-routing-controls zurückgegeben.

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. Ruft Routing-Steuerelemente ab

2. Rufen Sie einen Status für die Routingsteuerung ab.

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. Routing-Steuerelemente aktualisieren

Um den Verkehr an den Zielendpunkt weiterzuleiten, der von der Routingsteuerung gesteuert wird, aktualisieren Sie den Status der Routingsteuerung aufOn. Aktualisieren Sie den Status der Routingsteuerung, indem Sie den Befehl ausführenupdate-routing-control-state. (Wenn die Anfrage erfolgreich ist, ist die Antwort leer.)

2a. Aktualisieren Sie einen Status der Routingsteuerung.

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

{}

Sie können mehrere Routing-Steuerelemente gleichzeitig mit einem API Anruf aktualisieren:update-routing-control-states. (Wenn die Anfrage erfolgreich ist, ist die Antwort leer.)

2b. Aktualisieren Sie mehrere Status der Routingsteuerung gleichzeitig (Batch-Updates).

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

{}