Activación de la recuperación asegurada: start

API de SOAP › API de gestión de escenarios de alta disponibilidad › Activación de la recuperación asegurada: start_ar()

Activación de la recuperación asegurada: start_ar()

La función de API start_ar permite realizar una operación de recuperación asegurada (AR) de un escenario. Cuando se realiza una AR automática, no es necesario llamar a otras API para detener esta acción. La recuperación asegurada se detendrá después de finalizar la misma operación. Cuando se realiza una recuperación asegurada manual, llame a la API resume_application para detener esta operación.

Argumentos

La función de API start_ar incluye los argumentos descritos en la tabla siguiente:

Nombre	Tipo	Descripción
session_id	uint	El ID de sesión que se ha devuelto llamando a la API create_session.
scenario_id	uint	El ID de escenario para el cual desea realizar recuperación asegurada.
replica_index	uint	El índice del host réplica en un escenario. Normalmente, el valor del índice de la réplica es 2. Este es el host para el cual se suspenderá la replicación.
auto_ar	bool	Ejecute la recuperación asegurada automáticamente o manualmente. verdadero: automáticamente falso: manualmente
execute_sync	bool	Regula si debe llamarse a esta API sincrónica o asincrónicamente.
mensaje	out string	Contiene el motivo del error cuando se produce un error en esta API.

Valores de retorno

El tipo de valor de retorno es booleano. Cuando el valor de retorno es verdadero, la API finalizará correctamente. Cuando el valor de retorno es falso, la API no finaliza correctamente. Si el valor de retorno es falso, revise el mensaje para determinar el motivo por el cual la API es errónea.

Ejemplo

public bool start_ar_example()
        {
            try
            {
                uint scenario_id = _scenario_id;
                string message = "";
                bool execute_sync = true;
                uint replica_index = 2;
                bool auto_ar = true;
                return get_mng().start_ar(_session_id, scenario_id, replica_index, auto_ar, execute_sync, out message);
            }
            catch (Exception ex)
            {
                System.Windows.Forms.MessageBox.Show(ex.Message);
            }
            return false;
        }