Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exemples d'utilisation des opérations de l'API de contrôle de routage ARC avec AWS CLI
Cette section présente des exemples d'applications simples illustrant l'utilisation du contrôle de routage, en utilisant la AWS Command Line Interface fonctionnalité de contrôle de routage d'Amazon Application Recovery Controller (ARC) à l'aide d'opérations d'API. Les exemples sont destinés à vous aider à acquérir une compréhension de base de la manière d'utiliser le contrôle de routage à l'aide de la CLI.
Grâce au contrôle du routage dans Amazon Application Recovery Controller (ARC), vous pouvez déclencher des basculements de trafic entre des copies d'applications redondantes, ou répliques, exécutées dans des zones distinctes Régions AWS ou des zones de disponibilité.
Vous organisez les contrôles de routage en groupes appelés panneaux de commande qui sont provisionnés sur un cluster. Un cluster ARC est un ensemble régional de points de terminaison déployés dans le monde entier. Les points de terminaison du cluster fournissent une API hautement disponible que vous pouvez utiliser pour définir et récupérer les états de contrôle du routage. Pour plus d'informations sur les composants de la fonction de contrôle de routage, consultez[Composants de contrôle de routage](introduction-components-routing.md).
**Note**
ARC est un service mondial qui prend en charge plusieurs Régions AWS terminaux. Toutefois, vous devez spécifier la région USA Ouest (Oregon), c'est-à-dire spécifier le paramètre`--region us-west-2`, dans la plupart des commandes de l'ARC CLI. Par exemple, utilisez le `region` paramètre lorsque vous créez des groupes de récupération, des panneaux de commande et des clusters.
Lorsque vous créez un cluster, ARC vous fournit un ensemble de points de terminaison régionaux. Pour obtenir ou mettre à jour les états du contrôle de routage, vous devez spécifier le point de terminaison régional (le point de terminaison Région AWS et l'URL du point de terminaison) dans votre commande CLI.
Pour plus d'informations sur l'utilisation du AWS CLI, consultez la référence des AWS CLI commandes. Pour obtenir la liste des actions de l'API de contrôle du routage, reportez-vous [Opérations de l'API de contrôle du routage](actions.routing-control.md) aux sections et[Opérations de l'API de contrôle du routage](actions.routing-control.md).
Nous allons commencer par créer les composants dont vous avez besoin pour gérer le basculement à l'aide des contrôles de routage, en commençant par créer un cluster.
# Configuration des composants de contrôle de routage
Notre première étape consiste à créer un cluster. Un cluster ARC est un ensemble de cinq points de terminaison, un dans chacun des cinq points différents Régions AWS. L'infrastructure ARC permet à ces terminaux de fonctionner de manière coordonnée afin de garantir une haute disponibilité et une cohérence séquentielle des opérations de basculement.
## 1. Créer un cluster
1a. Créer un cluster. `network-type`C'est facultatif et peut être `IPV4` ou`DUALSTACK`. La valeur par défaut est `IPV4`.
```
aws route53-recovery-control-config create-cluster --cluster-name test --network-type DUALSTACK
```
```
"Cluster": {
"ClusterArn": "arn:aws:route53-recovery-control::123456789123:cluster/12341234-1234-1234-1234-123412341234",
"Name": "test",
"Status": "PENDING",
"Owner": "123456789123",
"NetworkType": "DUALSTACK"
}
```
Lorsque vous créez une ressource ARC pour la première fois, son statut est « `PENDING` pendant la création du cluster ». Vous pouvez suivre son évolution en appelant`describe-cluster`.
1b. Décrivez un cluster.
```
aws route53-recovery-control-config --region us-west-2 \
describe-cluster --cluster-arn arn:aws:route53-recovery-control::111122223333:cluster/5678abcd-abcd-5678-abcd-5678abcdefgh
```
```
"Cluster": {
"ClusterArn": "arn:aws:route53-recovery-control::123456789123:cluster/12341234-1234-1234-1234-123412341234",
"Name": "test",
"Status": "DEPLOYED",
"Owner": "123456789123",
"NetworkType": "DUALSTACK"
}
```
Lorsque le statut est DÉPLOYÉ, ARC a créé avec succès le cluster avec l'ensemble de points de terminaison avec lesquels vous pouvez interagir. Vous pouvez répertorier tous vos clusters en appelant`list-clusters`.
1c. Répertoriez vos clusters.
```
aws route53-recovery-control-config --region us-west-2 list-clusters
```
```
"Cluster": {
"ClusterArn": "arn:aws:route53-recovery-control::123456789123:cluster/12341234-1234-1234-1234-123412341234",
"Name": "test",
"Status": "DEPLOYED",
"Owner": "123456789123",
"NetworkType": "DUALSTACK"
}
```
1d. Mettez à jour le type de réseau pour vos clusters. Les options sont `IPV4` ou `DUALSTACK`.
```
aws route53-recovery-control-config update-cluster \
--cluster-arn arn:aws:route53-recovery-control::123456789123:cluster/12341234-1234-1234-1234-123412341234 \
--network-type DUALSTACK
```
```
"Cluster": {
"ClusterArn": "arn:aws:route53-recovery-control::123456789123:cluster/12341234-1234-1234-1234-123412341234",
"Name": "test",
"Status": "PENDING",
"Owner": "123456789123",
"NetworkType": "DUALSTACK"
}
```
## 2. Création d'un panneau de commande
Un panneau de commande est un regroupement logique permettant d'organiser vos commandes de routage ARC. Lorsque vous créez un cluster, ARC fournit automatiquement un panneau de commande pour vous appeler`DefaultControlPanel`. Vous pouvez utiliser ce panneau de commande immédiatement.
Un panneau de commande ne peut exister que dans un seul cluster. Si vous souhaitez déplacer un panneau de configuration vers un autre cluster, vous devez le supprimer puis le créer dans le second cluster. Vous pouvez voir tous les panneaux de commande de votre compte en appelant`list-control-panels`. Pour afficher uniquement les panneaux de commande d'un cluster spécifique, ajoutez le `--cluster-arn` champ.
2a. Répertoriez les panneaux de commande.
```
aws route53-recovery-control-config --region us-west-2 \
list-control-panels --cluster-arn arn:aws:route53-recovery-control::111122223333:cluster/eba23304-1a51-4674-ae32-b4cf06070bdd
```
```
{
"ControlPanels": [
{
"ControlPanelArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/1234567dddddd1234567dddddd1234567",
"ClusterArn": "arn:aws:route53-recovery-control::111122223333:cluster/5678abcd-abcd-5678-abcd-5678abcdefgh",
"DefaultControlPanel": true,
"Name": "DefaultControlPanel",
"RoutingControlCount": 0,
"Status": "DEPLOYED"
}
]
}
```
Vous pouvez éventuellement créer votre propre panneau de commande en appelant`create-control-panel`.
2 b. Créez un panneau de commande.
```
aws route53-recovery-control-config --region us-west-2 create-control-panel \
--control-panel-name NewControlPanel2 \
--cluster-arn arn:aws:route53-recovery-control::111122223333:cluster/5678abcd-abcd-5678-abcd-5678abcdefgh
```
```
{
"ControlPanel": {
"ControlPanelArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456",
"ClusterArn": "arn:aws:route53-recovery-control::111122223333:cluster/5678abcd-abcd-5678-abcd-5678abcdefgh",
"DefaultControlPanel": false,
"Name": "NewControlPanel2",
"RoutingControlCount": 0,
"Status": "PENDING"
}
}
```
Lorsque vous créez une ressource ARC pour la première fois, son statut est `PENDING` alors qu'elle est en cours de création. Vous pouvez vérifier les progrès en appelant`describe-control-panel`.
2 c. Décrivez un panneau de commande.
```
aws route53-recovery-control-config --region us-west-2 describe-control-panel \
--control-panel-arn arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456
```
```
{
"ControlPanel": {
"ControlPanelArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456",
"ClusterArn": "arn:aws:route53-recovery-control::111122223333:cluster/5678abcd-abcd-5678-abcd-5678abcdefgh",
"DefaultControlPanel": true,
"Name": "DefaultControlPanel",
"RoutingControlCount": 0,
"Status": "DEPLOYED"
}
}
```
## 3. Création d'un contrôle de routage
Maintenant que vous avez configuré le cluster et examiné les panneaux de commande, vous pouvez commencer à créer des contrôles de routage. Lorsque vous créez un contrôle de routage, vous devez au moins spécifier le nom de ressource Amazon (ARN) du cluster dans lequel vous souhaitez placer le contrôle de routage. Vous pouvez également spécifier l'ARN d'un panneau de commande pour le contrôle du routage. Vous devez également spécifier le cluster dans lequel se trouve le panneau de commande.
Si vous ne spécifiez pas de panneau de commande, votre contrôle de routage est ajouté au panneau de commande créé automatiquement,`DefaultControlPanel`.
Créez un contrôle de routage en appelant`create-routing-control`.
3a. Créez un contrôle de routage.
```
aws route53-recovery-control-config --region us-west-2 create-routing-control \
--routing-control-name NewRc1 \
--cluster-arn arn:aws:route53-recovery-control::111122223333:cluster/5678abcd-abcd-5678-abcd-5678abcdefgh
```
```
{
"RoutingControl": {
"ControlPanelArn": " arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456",
"Name": "NewRc1",
"RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567",
"Status": "PENDING"
}
}
```
Les contrôles de routage suivent le même modèle de création que les autres ressources ARC. Vous pouvez donc suivre leur progression en appelant une opération de description.
3b. Décrivez le contrôle du routage.
```
aws route53-recovery-control-config --region us-west-2 describe-routing-control \
--routing-control-arn arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567
```
```
{
"RoutingControl": {
"ControlPanelArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456",
"Name": "NewRc1",
"RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567",
"Status": "DEPLOYED"
}
}
```
Vous pouvez répertorier les commandes de routage dans un panneau de commande en appelant`list-routing-controls`. L'ARN du panneau de commande est requis.
3c. Répertoriez les contrôles de routage.
```
aws route53-recovery-control-config --region us-west-2 list-routing-controls \
--control-panel-arn arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456
```
```
{
"RoutingControls": [
{
"ControlPanelArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456",
"Name": "Rc1",
"RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567",
"Status": "DEPLOYED"
},
{
"ControlPanelArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456",
"Name": "Rc2",
"RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/hijklmnop987654321",
"Status": "DEPLOYED"
}
]
}
```
Dans l'exemple suivant, lorsque nous travaillons avec des états de contrôle de routage, nous supposons que vous disposez des deux contrôles de routage répertoriés dans cette section (Rc1 et Rc2). Dans cet exemple, chaque contrôle de routage représente une zone de disponibilité dans laquelle votre application est déployée.
## 4. Créez des règles de sécurité
Lorsque vous utilisez plusieurs contrôles de routage en même temps, vous pouvez décider de mettre en place certaines mesures de protection lorsque vous les activez et les désactivez, afin d'éviter des conséquences involontaires, comme la désactivation des deux contrôles de routage et l'arrêt de tout flux de trafic. Pour créer ces garanties, vous devez créer des règles de sécurité pour le contrôle du routage.
Il existe deux types de règles de sécurité : les règles d'assertion et les règles de blocage. Pour en savoir plus sur les règles de sécurité, consultez[Création de règles de sécurité pour le contrôle du routage](routing-control.safety-rules.md).
L'appel suivant fournit un exemple de création d'une règle d'assertion qui garantit qu'au moins l'un des deux contrôles de routage est défini sur un `On` moment donné. Pour créer la règle, vous devez exécuter `create-safety-rule` le `assertion-rule` paramètre.
Pour obtenir des informations détaillées sur le fonctionnement de l'API des règles d'assertion, consultez [AssertionRule](https://docs.aws.amazon.com/recovery-cluster/latest/api/safetyrule.html#safetyrule-model-assertionrule)le Guide de référence de l'API Routing Control pour Amazon Application Recovery Controller.
4a. Créez une règle d'assertion.
```
aws route53-recovery-control-config --region us-west-2 create-safety-rule \
--assertion-rule '{"Name": "TestAssertionRule",
"ControlPanelArn": "arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx",
"WaitPeriodMs": 5000,
"AssertedControls":
["arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx/routingcontrol/def123def123def"
"arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx/routingcontrol/ghi456ghi456ghi"],
"RuleConfig": {"Threshold": 1, "Type": "ATLEAST", "Inverted": false}}'
```
```
{
"Rule": {
"ASSERTION": {
"Arn": "arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx/safetyrule/333333444444",
"AssertedControls": [
"arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx/routingcontrol/def123def123def"
"arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx/routingcontrol/ghi456ghi456ghi"],
"ControlPanelArn": "arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx",
"Name": "TestAssertionRule",
"RuleConfig": {
"Inverted": false,
"Threshold": 1,
"Type": "ATLEAST"
},
"Status": "PENDING",
"WaitPeriodMs": 5000
}
}
}
```
L'appel suivant fournit un exemple de création d'une règle de blocage qui fournit un commutateur global « activé/désactivé » ou « blocage » pour un ensemble de contrôles de routage cibles dans un panneau de commande. Cela vous permet d'interdire la mise à jour des contrôles de routage cibles afin que, par exemple, l'automatisation ne puisse pas effectuer de mises à jour non autorisées. Dans cet exemple, le commutateur de déclenchement est une commande de routage spécifiée par le `GatingControls` paramètre et les deux commandes de routage contrôlées ou « fermées » sont spécifiées par le `TargetControls` paramètre.
**Note**
Avant de créer la règle de blocage, vous devez créer le contrôle de routage de blocage, qui n'inclut pas les enregistrements de basculement DNS, et les contrôles de routage cible, que vous configurez avec les enregistrements de basculement DNS.
Pour créer la règle, vous devez exécuter `create-safety-rule` le `gating-rule` paramètre.
Pour obtenir des informations détaillées sur le fonctionnement de l'API des règles d'assertion, consultez [GatingRule](https://docs.aws.amazon.com/recovery-cluster/latest/api/safetyrule.html#safetyrule-model-gatingrule)le Guide de référence de l'API Routing Control pour Amazon Application Recovery Controller.
4 b. Créez une règle de blocage.
```
aws route53-recovery-control-config --region us-west-2 create-safety-rule \
--gating-rule '{"Name": "TestGatingRule",
"ControlPanelArn": "arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx",
"WaitPeriodMs": 5000,
"GatingControls": ["arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx/routingcontrol/def123def123def"]
"TargetControls": ["arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx/routingcontrol/ghi456ghi456ghi",
"arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx/routingcontrol/lmn789lmn789lmn"],
"RuleConfig": {"Threshold": 0, "Type": "OR", "Inverted": false}}'
```
```
{
"Rule": {
"GATING": {
"Arn": "arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx/safetyrule/444444444444",
"GatingControls": [
"arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx/routingcontrol/def123def123def"
],
"TargetControls": [
"arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx/routingcontrol/ghi456ghi456ghi"
"arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx/routingcontrol/lmn789lmn789lmn"
],
"ControlPanelArn": "arn:aws:route53-recovery-control::888888888888:controlpanel/zzz123yyy456xxx789zzz123yyy456xxx",
"Name": "TestGatingRule",
"RuleConfig": {
"Inverted": false,
"Threshold": 0,
"Type": "OR"
},
"Status": "PENDING",
"WaitPeriodMs": 5000
}
}
}
```
Comme pour les autres ressources de contrôle du routage, vous pouvez décrire, répertorier ou supprimer les règles de sécurité une fois qu'elles se sont propagées au plan de données.
Après avoir défini une ou plusieurs règles de sécurité, vous pouvez continuer à interagir avec le cluster pour définir ou récupérer l'état des contrôles de routage. Si une `set-routing-control-state` opération enfreint une règle que vous avez créée, vous recevrez une exception similaire à la suivante :
`Cannot modify control state for [0123456bbbbbbb0123456bbbbbb01234560123 abcdefg1234567] due to failed rule evaluation 0123456bbbbbbb0123456bbbbbb0123456333333444444`
Le premier identifiant est l'ARN du panneau de commande concaténé avec l'ARN du contrôle de routage. Le deuxième identifiant est l'ARN du panneau de commande concaténé avec l'ARN de la règle de sécurité.
## 5. Création de surveillances de l’état
Pour utiliser les contrôles de routage pour faire basculer le trafic, vous devez créer des contrôles de santé dans Amazon Route 53, puis les associer à vos enregistrements DNS. En cas de basculement du trafic, un contrôle de routage ARC définit le contrôle de santé sur échec, de sorte que Route 53 redirige le trafic. (Le bilan de santé ne valide pas l'état de santé de votre application ; il est simplement utilisé comme méthode pour réacheminer le trafic.)
Par exemple, supposons que vous ayez deux cellules (régions ou zones de disponibilité). Vous configurez l'une comme cellule principale de votre application, et l'autre comme cellule secondaire, vers laquelle basculer.
Pour configurer les contrôles de santé en cas de basculement, vous pouvez par exemple effectuer les opérations suivantes :
1. Utilisez l'ARC CLI pour créer un contrôle de routage pour chaque cellule.
1. Utilisez la CLI Route 53 pour créer un contrôle de santé ARC dans Route 53 pour chaque contrôle de routage.
1. Utilisez la CLI Route 53 pour créer deux enregistrements DNS de basculement dans Route 53 et associez un contrôle de santé à chacun d'eux.
5a. Créez un contrôle de routage pour chaque cellule.
```
aws route53-recovery-control-config --region us-west-2 create-routing-control \
--routing-control-name RoutingControlCell1 \
--cluster-arn arn:aws:route53-recovery-control::111122223333:cluster/5678abcd-abcd-5678-abcd-5678abcdefgh
```
```
aws route53-recovery-control-config --region us-west-2 create-routing-control \
--routing-control-name RoutingControlCell2 \
--cluster-arn arn:aws:route53-recovery-control::111122223333:cluster/5678abcd-abcd-5678-abcd-5678abcdefgh
```
5 b. Créez un bilan de santé pour chaque contrôle de routage.
**Note**
Vous créez des contrôles de santé ARC à l'aide de l'interface de ligne de commande Amazon Route 53.
```
aws route53 create-health-check --caller-reference RoutingControlCell1 \
--health-check-config \
Type=RECOVERY_CONTROL,RoutingControlArn=arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567
```
```
{
"Location": "https://route53.amazonaws.com/2015-01-01/healthcheck/11111aaaa-bbbb-cccc-dddd-ffffff22222",
"HealthCheck": {
"Id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"CallerReference": "RoutingControlCell1",
"HealthCheckConfig": {
"Type": "RECOVERY_CONTROL",
"Inverted": false,
"Disabled": false,
"RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567"
},
"HealthCheckVersion": 1
}
}
```
```
aws route53 create-health-check --caller-reference RoutingControlCell2 \
--health-check-config \
Type=RECOVERY_CONTROL,RoutingControlArn=arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567
```
```
{
"Location": "https://route53.amazonaws.com/2015-01-01/healthcheck/11111aaaa-bbbb-cccc-dddd-ffffff22222",
"HealthCheck": {
"Id": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"CallerReference": "RoutingControlCell2",
"HealthCheckConfig": {
"Type": "RECOVERY_CONTROL",
"Inverted": false,
"Disabled": false,
"RoutingControlArn": "arn:aws:route53-recovery-control::111122223333:controlpanel/0123456bbbbbbb0123456bbbbbb0123456/routingcontrol/abcdefg1234567"
},
"HealthCheckVersion": 1
}
}
```
5c. Créez deux enregistrements DNS de basculement et associez un contrôle de santé à chacun d'eux.
Vous créez des enregistrements DNS de basculement dans Route 53 à l'aide de la CLI Route 53. Pour créer les enregistrements, suivez les instructions de la référence de AWS CLI commande Amazon Route 53 pour la [change-resource-record-sets](https://docs.aws.amazon.com/cli/latest/reference/route53/change-resource-record-sets.html)commande. Dans les enregistrements, spécifiez la valeur DNS pour chaque cellule ainsi que la `HealthCheckID` valeur correspondante créée par Route 53 pour le contrôle de santé (voir 6b).
Pour la cellule primaire :
```
{
"Name": "myapp.yourdomain.com",
"Type": "CNAME",
"SetIdentifier": "primary",
"Failover": "PRIMARY",
"TTL": 0,
"ResourceRecords": [
{
"Value": "cell1.yourdomain.com"
}
],
"HealthCheckId": "xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}
```
Pour la cellule secondaire :
```
{
"Name": "myapp.yourdomain.com",
"Type": "CNAME",
"SetIdentifier": "secondary",
"Failover": "SECONDARY",
"TTL": 0,
"ResourceRecords": [
{
"Value": "cell2.yourdomain.com"
}
],
"HealthCheckId": "yyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
}
```
Maintenant, pour passer de votre cellule principale à votre cellule secondaire, vous pouvez suivre l'exemple de la CLI à l'étape 4b pour mettre à jour l'état de `RoutingControlCell1` to `OFF` et `RoutingControlCell2` to`ON`.
# Répertoriez et mettez à jour les contrôles et les états de routage à l'aide du AWS CLI
Après avoir créé vos ressources Amazon Application Recovery Controller (ARC), telles que le cluster, les contrôles 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, ARC vous 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 l'URL du point de terminaison) lorsque vous appelez le cluster pour récupérer ou définir des états de contrôle de routage vers `On` ou`Off`. 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, consultez[Actions pour Application Recovery Controller utilisant AWS SDKs](service_code_examples_actions.md).
Pour plus d'informations sur l'utilisation du AWS CLI, consultez la référence des AWS CLI commandes. Pour obtenir la liste des actions de l'API de contrôle du routage et des liens vers des informations supplémentaires, consultez[Opérations de l'API de contrôle du routage](actions.routing-control.md).
**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 à](routing-control.update.api.md) l'aide du AWS CLI ou d'un AWS SDK. L'ARC offre une fiabilité extrême grâce au plan de données de contrôle de routage ARC permettant de rediriger le trafic et de basculer entre les cellules. Pour plus de recommandations sur l'utilisation d'ARC pour le basculement, consultez[Meilleures pratiques pour le contrôle du routage dans ARC](route53-arc-best-practices.regional.md).
Lorsque vous créez un contrôle de routage, l'état est défini sur`Off`. 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 commande`get-routing-control-state`.
Pour déterminer la région et le point de terminaison à spécifier, exécutez la `describe-clusters` commande pour afficher le`ClusterEndpoints`. 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. *[DescribeCluster](https://docs.aws.amazon.com/recovery-cluster/latest/api/cluster-clusterarn.html)est une opération d'API de configuration du contrôle de restauration. Nous vous recommandons de conserver une copie locale des points de terminaison de votre cluster régional ARC, 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 visualiser vos contrôles de routage et leurs états à l'aide des points de terminaison très fiables du plan de données ARC.
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 sur`On`. Mettez à jour l'état du contrôle de routage en exécutant la commande`update-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 avec un seul appel d'API :`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
```
```
{}
```