Guide di integrazione › Guida di riferimento dell'API di Backbone Fabric Controller (BFC) › Documentazione dell'API dettagliata › Creazione di una griglia

Creazione di una griglia

Nell'esempio seguente si crea un nuovo componente della griglia nella cartella BFC/grids.

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

Il payload è un record della griglia possibilmente sparse. Per la versione 1.0 di BFC, sono necessari i seguenti campi nel record della griglia:

• name
• xen_config/esx_config

  Nota: è necessario specificare almeno uno dei due e avere un conteggio di destinazione superiore a 0.

• grid_controller_user
• grid_controller_password

Per la versione 1.0 dell'API di BFC, vengono rispettati i seguenti parametri nel record della griglia:

• description
• ID
• applogic_version

  Nota: se applogic_version non viene specificato, viene utilizzata la versione di CA AppLogic più recente (quella con il numero più elevato).

• applogic_hotfixes
• oem_kit
• external_network

  Nota: se external_network non viene specificato, viene selezionata una delle reti esterne disponibili.

  Consultare la tabella sotto per i dettagli sulle combinazioni legali dei parametri IP e VLAN.

• app_ips

  Nota: utilizzato per riservare intervalli di indirizzo esplicitamente per l'uso da parte dell'applicazione della griglia. Se non specificato, specificare un conteggio di indirizzi nel parametro della stringa di query numAppIPs affinché sia riservato tale numero di indirizzi IP dell'applicazione.

  Consultare la tabella sotto per i dettagli sulle combinazioni legali dei parametri IP e VLAN.

• controller_ip

  Consultare la tabella sotto per i dettagli sulle combinazioni legali dei parametri IP e VLAN.

• vmware_license_key
• default_vlan

  Nota: il VLAN predefinito determina il VLAN per l'IP del controller di griglia e, se altrimenti specificato (attraverso i dati del parametro app_ips), determina anche il VLAN per il numero di IP dell'applicazione richiesto.

  Consultare la tabella sotto per i dettagli sulle combinazioni legali dei parametri IP e VLAN.

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

  Nota: per impostazione predefinita, l'accessibilità dell'archiviazione esterna non viene controllata come parte dell'operazione di creazione. Per controllare l'accessibilità come parte dell'operazione di creazione (e interrompere quest'ultima se non è possibile accedere all'archiviazione), specificare la stringa di query "checkExternalStorage" nell'URI di POST. Consultare la documentazione per Verifica archiviazione esterna per verificare l'accessibilità dell'archiviazione indipendente dall'operazione di creazione.

La griglia di creazione supporta due modalità IP:

• Indirizzi completamente specificati, in cui l'utente trasmette gli intervalli di app_ips e l'indirizzo di controller_ip. Il parametro external_network non viene accettato e causa un errore perché la specificazione degli indirizzi è data per scontata. Il VLAN predefinito è facoltativo.
• Indirizzi selezionati dal sistema, in cui viene richiesto solamente un conteggio di indirizzi. L'utente può anche facoltativamente specificare quale external_network utilizzare. Gli indirizzi specifici non vengono accettati e causano un errore. Ad esempio, se l'utente specifica indirizzi attraverso intervalli di app_ips o indirizzi di controller_ip. Il VLAN predefinito è facoltativo.

Utilizzare la tabella di seguito per rivedere le combinazioni di parametro IP e VLAN ammissibili quando viene passato il parametro. La riga in cima identifica il parametro che viene passato, il valore nella colonna sotto al parametro indica la risposta del sistema. È possibile autorizzare le combinazioni (OK), REQUIRED o ERROR. Ad esempio, quando viene passato il parametro external_network, numAppIPs è REQUIRED.

Tabella - Regole di combinazione per IP della griglia di creazione e input del VLAN (parametro e stringa di query)

* = Dati di input della stringa di query (consultare di seguito)

Parametri della stringa di query supportati nell'URI di POST

checkExternalStorage

Se è semplicemente presente o impostato su true, allora l'accessibilità dell'archiviazione esterna viene verificata come parte dell'operazione di creazione della griglia.

enableLanguagePacks

Se è semplicemente presente o impostato su true, allora tutti i language pack verranno applicati alla griglia creata.

numAppIPs

Specifica il numero di indirizzi IP dell'applicazione che devono essere riservati per l'uso da parte delle applicazioni eseguite sulla griglia creata. Gli indirizzi specifici verranno scelti dal sistema. Inoltre, è necessario questo parametro o il parametro app_ips nel record della griglia e tali parametri sono reciprocamente esclusivi; è possibile specificare solo uno dei due.

Consultare la tabella precedente per i dettagli sulle combinazioni legali dei parametri IP e VLAN.

Result

Al completamento corretto dell'operazione, vengono restituiti il codice HTTP 201 e il nome della griglia creata. In caso di errore, viene restituito un codice di errore HTTP insieme ad altri errori.

Description

Consente di creare un nuovo componente della griglia in BFC.

Nota: questa azione non crea la griglia di AppLogic. La prima chiamata all'operazione di avvio per la griglia crea la griglia stessa.

Esempi

Nell'esempio seguente si suppone l'utilizzo della stringa di query ?numAppIPs=10 sull'URI di POST e un record della griglia sparse con i valori seguenti:

• nome = '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

Payload 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"}} 

Risposta:

201

Posizione dell'intestazione:

BFC/grids/bfcapigrid

Nota: le azioni PUT e DELETE non sono supportate.