翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用してルーティングコントロールと状態を一覧表示および更新する AWS CLI
<a name="getting-started-cli-routing.control-state"></a>

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

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

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

の使用の詳細については AWS CLI、 AWS CLI 「 コマンドリファレンス」を参照してください。ルーティング制御 API アクションのリストと詳細情報へのリンクについては、「[ルーティング制御 API オペレーション](actions.routing-control.md)」を参照してください。

**重要**  
Amazon Route 53 コンソールでルーティングコントロールの状態を更新できますが、 AWS CLI または AWS SDK を使用して[ルーティングコントロールの状態を更新](routing-control.update.api.md)することをお勧めします。ARC は、トラフィックの再ルーティングやセル間のフェイルオーバーを可能にする ARC ルーティングコントロールデータプレーンにより、きわめて高い信頼性を実現します。ARC をフェイルオーバーに使用することに関するその他の推奨事項については、「[ARC でのルーティングコントロールに関するベストプラクティス](route53-arc-best-practices.regional.md)」を参照してください。

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

指定するリージョンとエンドポイントを判断するには、`describe-clusters` コマンドを実行して `ClusterEndpoints` を表示します。各 `ClusterEndpoint` にはリージョンとそれに対応するエンドポイントが含まれ、これらを使用してルーティングコントロールの状態を取得または更新できます。*[DescribeCluster](https://docs.aws.amazon.com/recovery-cluster/latest/api/cluster-clusterarn.html) はリカバリコントロール設定 API オペレーションです。ARC リージョンクラスターエンドポイントのローカルコピーをブックマークに保存するか、エンドポイントを再試行するために使用する自動化コードの中にハードコードしておくことを推奨します。*

## 1. ルーティングコントロールを一覧表示する
<a name="getting-started-cli-routing.view-rc"></a>

信頼性の高い 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. ルーティングコントロールを取得する
<a name="getting-started-cli-routing.get-rc"></a>

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. ルーティングコントロールを更新する
<a name="getting-started-cli-routing.update-rc"></a>

ルーティングコントロールによって制御されているターゲットエンドポイントにトラフィックをルーティングするには、ルーティングコントロールの状態を `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
```

```
{}
```