Creación de escenarios: create_scenario

API de SOAP › API de gestión de escenarios › Creación de escenarios: create_scenario_ex()

Creación de escenarios: create_scenario_ex()

La función de API create_scenario_ex permite crear escenarios. Después de crear los escenarios se pueden realizar operaciones como ejecutar el escenario, cambiar las propiedades del escenario, agregar o eliminar host, entre otros.

Argumentos

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

Name	Tipo	Descripción
session_id	uint	El ID de sesión que se ha devuelto llamando a la API de función create_session.
producto	uint	Especifique un valor entero para los productos siguientes: 0 - Escenario de recuperación de desastres (DR) 1 - Escenario de alta disponibilidad (HA) 2 - Escenario de CD
aplicación	uint	Especifique un valor entero para las aplicaciones siguientes: 0 - Escenario del servidor de archivos. 1- Escenario de Exchange 2 - Escenario de Oracle 3 - No utilizado 4 - Escenario de SQL Server 5 - Escenario de IIS 6 - Escenario del servicio de control 7 - Escenario de Hyper-V 8 - Escenario de SharePoint 9 - Escenario de vCenter 10 - Escenario de CRM 11- Escenario de todo el sistema 12 - Personalizar el escenario
is_ar	bool	Especifica si el escenario es compatible con la recuperación asegurada (AR): verdadero: admite la recuperación asegurada falso: no admite la recuperación asegurada
is_cdp	bool	Siempre falso, no se utiliza.
integrate_opt	uint	Especifique un valor entero real para las aplicaciones siguientes: 0 - Sin integración 1 - Backup 2 - Arcserve D2D 3 - Arcserve Central Applications
group_id	uint	ID de grupo. Cuando group_id es 0xFFFFFFFF, el escenario pertenece al grupo de escenarios predeterminado, que se suele llamar escenario.
scenario_data	out string	Los datos para el escenario. Después de haber llamado a esta API, el argumento contiene el datos del escenario actualizados. Nota: Para obtener más información, consulte el Ejemplo de este tema.
group_data	out string	Los datos del grupo.

Valores de retorno

Esta API devuelve el ID del escenario que se ha creado. Las otras API, como la de ejecución y detención, requieren el ID de escenario. Cuando el ID de escenario es cero, la API genera un fallo. Además, los valores que no son cero indican que la API se ha completado correctamente.

Nota: Cuando esta llamada API se completa correctamente, se crea el esqueleto del escenario. Todas las propiedades del escenario tienen los valores predeterminados. Las propiedades importantes como el directorio raíz, la IP del host, etc., están vacías. Se puede llamar a otras API para cumplimentar las propiedades. Las API subsiguientes de esta guía de referencia describen cómo cumplimentar las propiedades.

Ejemplo

uint product = 0;
                uint app = 0;
                bool is_ass_rec = false;
                bool is_cdp = false;
                uint si_opt = 0;
                uint group_id = 0xFFFFFFFF;
                string scenario_data = "";
                string group_data = "";
                
                uint  scenario_id =  get_mng().create_scenario_ex(_session_id, product, app, is_ass_rec, is_cdp, si_opt, group_id, out scenario_data, out group_data);