Integrationshandbücher › BFC API-Referenzhandbuch › Detaillierte API-Dokumentation › Grid-URIs › Erstellen eines Grid

Erstellen eines Grid

Im folgenden Beispiel erstellen Sie eine neue Grid-Komponente im BFC/grids-Ordner.

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

Die Nutzlast ist ein möglicherweise spärlicher Grid-Datensatz. Für die 1.0-Version des BFC sind die folgenden Felder im Grid-Datensatz erforderlich:

• Name
• xen_config/esx_config

  Hinweis: Mindestens eines der beiden muss angegeben werden und über eine Zielzahl größer als 0 verfügen .

• grid_controller_user
• grid_controller_password

Für die 1.0-Version des BFC API werden die folgenden Parameter im Grid-Datensatz berücksichtigt:

• description
• id
• applogic_version

  Hinweis: Wenn "applogic_version" nicht angegeben wird, wird die aktuellste (am höchsten nummerierte) CA AppLogic®-Version verwendet.

• applogic_hotfixes
• oem_kit
• external_network

  Hinweis: Wenn "external_network" nicht angegeben wird, wird eines der verfügbaren externen Netzwerke ausgewählt.

  In der nachfolgenden Tabelle finden Sie Einzelheiten zu zulässigen IP- und VLAN-Parameterkombinationen.

• app_ips

  Hinweis: Wird verwendet, um Adressbereiche ausdrücklich für Grid-Anwendungen zu reservieren. Falls keine Angabe erfolgt, geben Sie die Anzahl von Adressen im numAppIPs-Abfragezeichenfolgeparameter an, und das System reserviert die entsprechende Anzahl der IP-Adressen für die Anwendung.

  In der nachfolgenden Tabelle finden Sie Einzelheiten zu zulässigen IP- und VLAN-Parameterkombinationen.

• controller_ip

  In der nachfolgenden Tabelle finden Sie Einzelheiten zu zulässigen IP- und VLAN-Parameterkombinationen.

• vmware_license_key
• default_vlan

  Hinweis: Das Standard-VLAN bestimmt das VLAN für die Grid-Steuerungs-IP und bestimmt durch die Parameterdaten "app_ips" auch das VLAN für die angeforderte Anzahl von Anwendung-IPs.

  In der nachfolgenden Tabelle finden Sie Einzelheiten zu zulässigen IP- und VLAN-Parameterkombinationen.

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

  Hinweis: Standardmäßig wird der Zugriff auf den externen Speicher nicht als Teil des Erstellungsvorgangs überprüft. Um den Zugriff als Teil des Erstellungsvorgangs zu überprüfen (Fehler beim Erstellungsvorgang, wenn auf den Speicher nicht zugegriffen werden kann), geben Sie die Abfragezeichenfolge "checkExternalStorage" im POST URI an. In der Dokumentation "Externen Speicher überprüfen" finden Sie Informationen zur Überprüfung der Zugänglichkeit des Speichers, unabhängig vom Erstellungsvorgang.

Bei der Erstellung des Grid werden zwei IP-Modi unterstützt:

• Völlig angegebene Adressen, wobei der Benutzer die Bereiche "app_ips" und die Adresse "controller_ip" durchläuft. Der Parameter "external_network" wird nicht akzeptiert und verursacht einen Fehler, da vorausgesetzt wird, dass Adressen angegeben wurden. Das Standard-VLAN ist optional.
• Vom System ausgewählte Adressen, wobei nur eine Anzahl von Adressen erforderlich ist. Der Benutzer kann auch optional angeben, welcher "external_network"-Parameter verwendet werden soll. Bestimmte Adressen werden nicht akzeptiert und verursachen einen Fehler. Wenn der Benutzer beispielsweise Adressen über app_ips-Bereiche oder controller_ip-Adressen angibt. Das Standard-VLAN ist optional.

Verwenden Sie die folgende Tabelle, um zulässige IP- und VLAN-Parameterkombinationen bei der Übergabe des Parameters zu prüfen. Die oberste Zeile gibt den Parameter, den Sie übergeben, und der Wert in der Spalte unter dem Parameter die Systemantwort an. Die Kombinationen können zulässig (OK) oder ERFORDERLICH sein oder zu einem FEHLER führen. Bei der Übergabe des Parameters external_network ist beispielsweise numAppIPs ERFORDERLICH.

Tabelle - Kombinationsregeln für die Erstellung der Grid-IP und VLAN-Eingabe (Parameter und Abfragezeichenfolge)

* = Eingabedaten für Abfragezeichenfolge (siehe unten)

Unterstützte Abfragezeichenfolgenparameter in POST URI

checkExternalStorage

Falls vorhanden oder bei Einstellung auf "true" wird der Zugriff auf den externen Speicher als Teil des Grid-Erstellungsvorgangs überprüft.

enableLanguagePacks

Falls vorhanden oder bei Einstellung auf "true" werden alle Sprachpakete auf das Grid angewandt, das erstellt wird.

numAppIPs

Gibt die Anzahl der Anwendungs-IP-Adressen an, die für Anwendungen reserviert werden sollten, die in dem erstellten Grid ausgeführt werden. Die jeweiligen Adressen werden vom System ausgewählt. Dieser Parameter oder der Parameter "app_ips" im Grid-Datensatz ist erforderlich.Diese Parameter schließen sich gegenseitig aus; es kann also jeweils nur ein Parameter angegeben werden.

In der vorherigen Tabelle finden Sie Einzelheiten zu zulässigen IP- und VLAN-Parameterkombinationen.

Result

Falls der Vorgang erfolgreich war, werden der HTTP-Code 201 und der Name des erstellten Grid zurückgegeben. Falls ein Fehler aufgetreten ist, werden ein HTTP-Fehlercode und ein bzw. mehrere Fehler zurückgegeben.

Description

Erstellt im BFC eine neue Grid-Komponente.

Hinweis: Das AppLogic-Grid wird durch diese Aktion nicht erstellt. Beim ersten Aufruf des Startvorgangs für das Grid wird das Grid erstellt.

Beispiele

Im folgenden Beispiel wird davon ausgegangen, dass Sie die Abfragezeichenfolge "?numAppIPs=10" in POST URI und einen Grid-Datensatz geringen Umfangs mit den folgenden Werten verwenden:

• 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

Beispiel-JSON-Nutzlast

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

Antwort

201

Header-Speicherort

BFC/grids/bfcapigrid

Hinweis: Die Aktionen zum Speichern und Löschen werden nicht unterstützt.