Manuels d'intégration › Manuel de référence de l'API BFC › Documentation d'API détaillée › URIs de grille › Création d'une grille

Création d'une grille

Dans l'exemple suivant, vous créez un composant de grille dans le dossier BFC/grids.

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

Il est possible que la charge utile soit un enregistrement de grille sporadique. Pour la version 1.0 de BFC, les champs suivants sont requis dans l'enregistrement de grille :

• name
• xen_config/esx_config

  Remarque : Vous devez en spécifier au moins un et le nombre de cibles doit être supérieur à 0.

• grid_controller_user
• grid_controller_password

Pour la version 1.0 de l'API de BFC, les paramètres suivants de l'enregistrement de grille sont respectés :

• description
• id
• applogic_version

  Remarque : Si applogic_version n'est pas spécifié, la version de CA AppLogic® la plus récente (numéro le plus élevé) est utilisée.

• applogic_hotfixes
• oem_kit
• external_network

  Remarque : Si external_network n'est pas spécifié, l'un des réseaux externes disponibles est sélectionné.

  Consultez le tableau ci-dessous. Il détaille les combinaisons d'adresses IP légales et de paramètres de réseau local virtuel.

• app_ips

  Remarque : Utilisé pour réserver des plages d'adresses explicitement pour une utilisation par une application de grille. S'il n'est pas spécifié, définissez un nombre d'adresses dans le paramètre de chaîne de requête numAppIPs et le système réservera le même nombre d'adresses IP d'application.

  Consultez le tableau ci-dessous. Il détaille les combinaisons d'adresses IP légales et de paramètres de réseau local virtuel.

• controller_ip

  Consultez le tableau ci-dessous. Il détaille les combinaisons d'adresses IP légales et de paramètres de réseau local virtuel.

• vmware_license_key
• default_vlan

  Remarque : Le réseau local virtuel par défaut détermine le réseau local virtuel de l'IP du contrôleur de grille et, en cas d'indication contraire (via les données du paramètre app_ips), il détermine également le réseau local virtuel pour le nombre d'adresses IP d'application demandé.

  Consultez le tableau ci-dessous. Il détaille les combinaisons d'adresses IP légales et de paramètres de réseau local virtuel.

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

  Remarque : Par défaut, l'accessibilité de l'espace de stockage externe n'est pas vérifiée dans le cadre du processus de création. Pour vérifier l'accessibilité lors de l'opération de création (et provoquer l'échec de la création si vous ne pouvez pas accéder au stockage), spécifiez la chaîne de requête checkExternalStorage dans l'URI POST. Consultez la rubrique Vérification de l'espace de stockage externe pour vérifier l'accessibilité du stockage indépendamment d'une opération de création.

La création de grille prend en charge deux modes IP :

• Adresses entièrement spécifiées, pour lesquelles l'utilisateur transmet les plages app_ips et l'adresse controller_ip. Le paramètre external_network n'est pas accepté et provoque une erreur parce que des adresses étaient spécifiées. Le réseau local virtuel par défaut est facultatif.
• Adresses sélectionnées par le système, pour lesquelles seul un nombre d'adresses est demandé. L'utilisateur peut aussi éventuellement spécifier quel paramètre external_network utiliser. Les adresses spécifiques ne sont pas acceptées et provoquent une erreur. Par exemple, si l'utilisateur spécifie des adresses à l'aide de plages app_ips ou d'adresses controller_ip. Le réseau local virtuel par défaut est facultatif.

Utilisez le tableau suivant pour réviser les combinaisons de paramètre IP et VLAN admissibles lors de la transmission du paramètre. La ligne première identifie le paramètre que vous transférez, la valeur dans la colonne du dessous indique la réponse de système. Les combinaisons sont autorisées (OK), Obligatoires ou aboutissent à une Erreur. Par exemple, lors du transfert du paramètre external_network, numAppIPs est Obligatoire.

Tableau - Règles de combinaison de la création d'IP de grille et de l'entrée de réseau local virtuel (paramètre et chaîne de requête)

* = données de saisie de la chaîne de requête (voir ci-dessous)

Paramètres de chaîne de requête pris en charge dans l'URI POST

checkExternalStorage

S'il est présent ou simplement défini sur true, l'accessibilité de l'espace de stockage externe est vérifiée dans le cadre de l'opération de création de grille.

enableLanguagePacks

S'il est présent ou simplement défini sur true, tous les packs linguistiques seront appliqués à la grille en cours de création.

numAppIPs

Spécifie le nombre d'adresses IP d'application à réserver en vue de leur utilisation par les applications exécutées sur la grille en cours de création. Les adresses spécifiques seront choisies par le système. De plus, ce paramètre ou le paramètre app_ips de l'enregistrement de grille est requis et ils s'excluent mutuellement ; seul l'un ou l'autre peut être spécifié.

Consultez le tableau précédent. Il détaille les combinaisons d'adresses IP légales et de paramètres de réseau local virtuel.

Result

En cas de réussite, le code HTTP 201 et le nom de la grille créée sont renvoyés. En cas d'erreur, un code d'erreur HTTP et des pannes sont renvoyés.

Description

Crée un composant de grille dans BFC.

Remarque : Cette action ne crée pas la grille AppLogic. Le premier appel à l'opération start pour la grille crée cette dernière.

Exemples

L'exemple suivant suppose que vous utilisez la chaîne de requête ?numAppIPs=10 sur l'URI POST et un enregistrement de grille sporadique avec les valeurs suivantes :

• name = 'bfcapigrid'
• description = 'une grille créée via l'api de bfc',
• 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

Exemple de charge utile 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 through the bfc api"}} 

Response

201

Emplacement d'en-tête

BFC/grids/bfcapigrid

Remarque : Les actions PUT et DELETE ne sont pas prises en charge.