Enumere y actualice los controles y estados de enrutamiento con AWS CLI

Después de crear los recursos de Amazon Route 53 Application Recovery Controller, como el clúster, los controles de enrutamiento y los paneles de control, puede interactuar con el clúster para enumerar y actualizar los estados de control de enrutamiento para la conmutación por error.

Para cada clúster que cree, Route 53 le ARC proporciona un conjunto de puntos finales de clúster, uno de cada cinco Regiones de AWS. Debe especificar uno de estos puntos de enlace regionales (el punto final Región de AWS y el punto finalURL) al realizar llamadas al clúster para recuperar o establecer los estados de control de enrutamiento en o. On Off Cuando utilice el AWS CLI, para obtener o actualizar los estados del control de enrutamiento, además del punto final regional, también debe especificar el --region del punto final regional, como se muestra en los ejemplos de esta sección.

Puede utilizar cualquiera de los puntos de conexión regionales del clúster. Recomendamos que sus sistemas roten por los puntos finales regionales y estén preparados para volver a intentarlo con cada uno de los puntos finales disponibles. Para ver ejemplos de código que ilustran cómo probar los puntos de conexión de un clúster de forma secuencial, consulte Acciones para Application Recovery Controller mediante AWS SDKs.

Para obtener más información sobre el uso del AWS CLI, consulte la AWS CLI Referencia de comandos. Para obtener una lista de API las acciones de control de enrutamiento y enlaces a más información, consulte Operaciones de control API de enrutamiento.

importante

Si bien puede actualizar el estado de un control de enrutamiento en la consola de Amazon Route 53, le recomendamos que actualice los estados del control de enrutamiento mediante el AWS CLI o un AWS SDK. Route 53 ARC ofrece una confiabilidad extrema con el plano de datos de control de ARC enrutamiento de Route 53 para redirigir el tráfico y conmutar por error entre las celdas. Para obtener más recomendaciones sobre el uso de Route 53 ARC para la conmutación por error, consulteMejores prácticas para el control de enrutamiento en Route 53 ARC.

Al crear un control de enrutamiento, el estado se establece en Off. Esto significa que el tráfico no se enruta a la celda de destino para ese control de enrutamiento. Puede verificar el estado del control de enrutamiento mediante la ejecución del comando get-routing-control-state.

Para determinar la región y el punto final que se van a especificar, ejecute el describe-clusters comando para ver el ClusterEndpoints. Cada ClusterEndpoint incluye una región y el punto final correspondiente que puede usar para obtener o actualizar los estados del control de enrutamiento. DescribeClusteres una API operación de configuración del control de recuperación. Le recomendamos que guarde una copia local de los puntos de enlace del clúster ARC regional de Route 53, en marcadores o codificada en el código de automatización que utilice para volver a intentar los puntos de enlace.

1. Listar los controles de enrutamiento

Puede ver los controles de enrutamiento y los estados de control de enrutamiento mediante los puntos finales del plano de ARC datos de Route 53, altamente confiables.

1. Enumere los controles de enrutamiento de un determinado panel de control. Si no especifica un panel de control, list-routing-controls devuelve todos los controles de enrutamiento del clúster.

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. Obtenga controles de enrutamiento

2. Obtener el estado de un control de enrutamiento.

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. Actualice los controles de enrutamiento

Para dirigir el tráfico al punto de conexión de destino controlado por el control de enrutamiento, actualice el estado del control de enrutamiento a On. Ejecute el comando update-routing-control-state para actualizar el estado de control de enrutamiento (si la solicitud se realiza correctamente, la respuesta estará vacía).

2a. Actualizar el estado de un control de enrutamiento.

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

{}

Puede actualizar varios controles de enrutamiento al mismo tiempo con una sola API llamada:update-routing-control-states. (si la solicitud se realiza correctamente, la respuesta estará vacía).

2b. Actualice varios estados de control de enrutamiento a la vez (actualizaciones por lotes).

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

{}