を使用してルーティングコントロールと状態を一覧表示および更新する AWS CLI

クラスター、ルーティングコントロール、コントロールパネルなどの Amazon Application Recovery Controller (ARC) リソースを作成したら、クラスターを操作して、フェイルオーバーのルーティングコントロールの状態を一覧表示および更新できます。

作成するクラスターごとに、 ARCは 5 つの のそれぞれに 1 つずつ、一連のクラスターエンドポイントを提供します AWS リージョン。ルーティングコントロールの状態を取得または設定するためにクラスターを呼び出すときは、これらのリージョンエンドポイント ( AWS リージョン およびエンドポイント URL) On のいずれかを指定する必要がありますOff。を使用する場合 AWS CLI、リージョンエンドポイントに加えて、ルーティングコントロールの状態を取得または更新するには、このセクションの例に示すように、リージョンエンドポイント--regionの も指定する必要があります。

どのリージョンクラスターエンドポイントも使用可能です。システムはリージョンのエンドポイントをローテーションし、使用可能な各エンドポイントで再試行する準備をしておくことをお勧めします。クラスターエンドポイントを順番に試行するコードサンプルについては、「を使用した Application Recovery Controller のアクション AWS SDKs 」を参照してください。

の使用の詳細については AWS CLI、 AWS CLI 「 コマンドリファレンス」を参照してください。ルーティングコントロールAPIアクションのリストと詳細情報へのリンクについては、「」を参照してください ルーティングコントロールAPIオペレーション。

重要

Amazon Route 53 コンソールでルーティングコントロールの状態を更新できますが、 AWS CLI または を使用してルーティングコントロールの状態を更新することをお勧めします AWS SDK。ARC は、トラフィックを再ARCルーティングし、セル間でフェイルオーバーするためのルーティングコントロールデータプレーンで非常に高い信頼性を提供します。フェイルオーバーARCに を使用するための推奨事項については、「」を参照してくださいでのルーティングコントロールのベストプラクティス ARC。

ルーティングコントロールを作成すると、状態は Off に設定されます。つまり、そのルーティングコントロールのターゲットセルには、トラフィックはルーティングされません。ルーティングコントロールの状態を確認するには、get-routing-control-state コマンドを実行します。

指定するリージョンとエンドポイントを判断するには、describe-clusters コマンドを実行して ClusterEndpoints を表示します。各 ClusterEndpoint にはリージョンとそれに対応するエンドポイントが含まれ、これらを使用してルーティングコントロールの状態を取得または更新できます。DescribeCluster はリカバリコントロールの設定APIオペレーションです。ARCリージョンクラスターエンドポイントのローカルコピーをブックマークに保持するか、エンドポイントの再試行に使用する自動化コードにハードコードすることをお勧めします。

1. ルーティングコントロールを一覧表示する

信頼性の高いARCデータプレーンエンドポイントを使用して、ルーティングコントロールとルーティングコントロールの状態を表示できます。

1. 特定のコントロールパネルのルーティングコントロールを一覧表示します。コントロールパネルを指定しないと、list-routing-controls はクラスター内のすべてのルーティングコントロールを返します。

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. ルーティングコントロールを取得する

2. ルーティングコントロールの状態を取得します。

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. ルーティングコントロールの更新

ルーティングコントロールによって制御されているターゲットエンドポイントにトラフィックをルーティングするには、ルーティングコントロールの状態を On に更新します。update-routing-control-state コマンドを実行してルーティングコントロールの状態を更新します。(リクエストが成功すると、応答は空になります)。

2a. ルーティングコントロールの状態を更新します。

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

{}

1 回のAPI呼び出しで複数のルーティングコントロールを同時に更新できます: update-routing-control-states。(リクエストが成功すると、応答は空になります)。

2b. 複数のルーティングコントロールの状態を一度に更新します (バッチ更新)。

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

{}