Guías de integración › Guía de referencia de la API de Backbone Fabric Controller (BFC) › Documentación detallada de la API › Creación de un grid

Creación de un grid

En el ejemplo siguiente, se crea un nuevo componente de grid en la carpeta de BFC/grids.

POST BFC/grid
POST BFC/grids?checkExternalStorage&enableLanguagePacks&numAppIPs=10

La carga útil es un registro de grid posiblemente sucinto. Para la versión 1.0 de BFC, los siguientes campos son obligatorios en el registro de grid:

• Nombre
• xen_config/esx_config

  Nota: Como mínimo uno de los dos se deberá especificar y tener un número de destino mayor que 0.

• grid_controller_user
• grid_controller_password

Para la versión 1.0 de la API de BFC, se tienen en cuenta los siguientes parámetros del registro del grid:

• Descripción
• id
• applogic_version

  Nota: Si no se especifica el valor de applogic_version, se utiliza la versión de CA AppLogic más reciente (la que tenga el número más alto).

• applogic_hotfixes
• oem_kit
• external_network

  Nota: Si no se especifica external_network, se selecciona una de las redes externas disponibles.

  Consulte la tabla siguiente en la que se detallan las combinaciones de parámetros VLAN e IP legales.

• app_ips

  Nota: Se utiliza para reservar intervalos de direcciones explícitamente que las usen las aplicaciones del grid. Si no se especifica, indique un número de direcciones en el parámetro de la cadena de consulta numAppIPs y el sistema reservará todas esas direcciones IP de aplicación.

  Consulte la tabla siguiente en la que se detallan las combinaciones de parámetros VLAN e IP legales.

• controller_ip

  Consulte la tabla siguiente en la que se detallan las combinaciones de parámetros VLAN e IP legales.

• vmware_license_key
• default_vlan

  Nota: El valor predeterminado de VLAN determina el valor de VLAN para la IP del controlador del grid y, si se especifica de cualquier otra forma (a través de los datos del parámetro app_ips), también determina el valor de VLAN para el número solicitado de IP de aplicación.

  Consulte la tabla siguiente en la que se detallan las combinaciones de parámetros VLAN e IP legales.

• account_id
• account_key
• recovery_password
• global_user_dir
• grid_controller_name
• additional_config
• external_storage

  Nota: De forma predeterminada, la accesibilidad del almacenamiento externo no se comprueba como parte del proceso de creación. Para comprobar la accesibilidad como parte de la operación de creación (y que la creación falle si no se puede acceder al almacenamiento), especifique la cadena de consulta "checkExternalStorage" en el URI POST. Consulte la documentación sobre la comprobación del almacenamiento externo para conocer la accesibilidad del almacenamiento independiente de la operación de creación.

La creación de grids admite dos modos IP:

• Direcciones completamente especificadas, donde el usuario transfiere los intervalos app_ips y la dirección controller_ip. El parámetro external_network no se acepta y causa un error porque es se da por hecho que las direcciones se han especificado. El valor predeterminado de VLAN es opcional.
• Direcciones seleccionadas por el sistema, donde solamente se requiere el número de direcciones. El usuario, si lo desea, también puede especificar qué external_network se debe utilizar. Las direcciones específicas no se aceptan y causan errores. Por ejemplo, si el usuario especifica direcciones a través de intervalos app_ips o direcciones controller_ip. El valor predeterminado de VLAN es opcional.

Utilice la siguiente tabla para revisar las combinaciones de parámetros de IP y VLAN permisibles al transferir el parámetro. La fila superior identifica el parámetro que está transfiriendo y el valor en la columna por debajo del parámetro indica la respuesta del sistema. Las combinaciones pueden estar permitidas (ACEPTADAS), REQUERIDAS o provocar un ERROR. Por ejemplo, al transferir el parámetro de external_network, SE REQUIERE numAppIPs.

Tabla. Reglas de combinación para crear entradas de VLAN e IP de grid (cadena de consulta y parámetro)

* = Datos de entrada de la cadena de consulta (véase más abajo)

Parámetros de cadena de consulta admitidos en el URI POST

checkExternalStorage

Si simplemente está presente o su configuración es "true", se verifica la accesibilidad del almacenamiento externo como parte de la operación de creación del grid.

enableLanguagePacks

Si simplemente está presente o su configuración es "true", todos los paquetes de idioma se aplicarán al grid que se está creando.

numAppIPs

Especifica el número de direcciones IP de aplicación que deberían estar reservadas para que las usen las aplicaciones que se ejecutan en el grid que se está creando. El sistema elegirá las direcciones específicas. Además, se requiere este parámetro o el parámetro app_ips del registro del grid y esos parámetros se excluyen mutuamente; solamente se puede especificar uno u otro.

Consulte la tabla anterior en la que se detallan las combinaciones de parámetros VLAN e IP legales.

Resultado

Si el resultado es correcto, se devuelven el código HTTP 201 y el nombre del grid que se ha creado. Si el resultado es un error, se devuelven un código de error de HTTP y los fallos.

Descripción

Crea un nuevo componente de grid en BFC.

Nota: Esta acción no crea el grid de AppLogic. La primera llamada a la operación de start para el grid hace posible su creación.

Ejemplos

En el ejemplo siguiente se da por hecho que se está utilizando la cadena de consulta ?numAppIPs=10 en el URI POST y un registro de grid sucinto con los valores siguientes:

• name = 'bfcapigrid'
• description = 'a grid created via the bfc api',
• xen_config = min:1, target:2, max:3, selection_criteria:null,
• grid_controller_user = 'cadev@cadev.com',
• grid_controller_password = 'F00b@r',
• applogic_version = '3.0.8'
• external_network = 222.222.222.131/16

Carga útil de JSON:

{"grid": {"grid_controller_user": "cadev@cadev.com", "name": "bfcapigrid", 
"xen_config":{"grid_server_configuration":{"min":2,"target":2,"max":2,"selection_criteria":null}}, 
"applogic_version": "3.0.8", 
"external_network": "222.222.222.131/16", "grid_controller_password": "F00b@r", 
"description": "a grid created via the bfc api"}} 

Respuesta:

201

Ubicación del encabezado:

BFC/grids/bfcapigrid

Nota: Las acciones PUT y DELETE no se admiten.