集成指南 › BFC API 参考指南 › 详细的 API 文档 › 网格 URI › 创建网格

创建网格

在以下示例中，将在 BFC/grids 文件夹中创建一个新的网格组件。

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

有效负载可能是稀疏网格记录。 对于 BFC 的 1.0 版本，以下字段在网格记录中是必填字段：

• name
• xen_config/esx_config

  注意：必须至少指定这两个字段之一，并且目标计数要大于 0。

• grid_controller_user
• grid_controller_password

对于 BFC API 的 1.0 版本，应在网格记录中指定以下参数：

• 说明
• ID
• applogic_version

  注意：如果未指定 applogic_version，则使用最新（编号最高）的 CA AppLogic® 版本。

• applogic_hotfixes
• oem_kit
• external_network

  注意：如果未指定 external_network，则选择可用的外部网络之一。

  请参阅下表，其中提供了有关合法 IP 和 VLAN 参数组合的详细信息。

• app_ips

  注意：用于显式地保留地址范围，以供网格应用使用。 如果未指定，则在 numAppIPs 查询字符串参数中指定地址计数，系统将保留这些数量的应用 IP 地址。

  请参阅下表，其中提供了有关合法 IP 和 VLAN 参数组合的详细信息。

• controller_ip

  请参阅下表，其中提供了有关合法 IP 和 VLAN 参数组合的详细信息。

• vmware_license_key
• default_vlan

  注意：默认 VLAN 确定网格控制器 IP 的 VLAN，如果另行指定（通过 app_ips 参数数据），也可以确定所请求数量的应用 IP 的 VLAN。

  请参阅下表，其中提供了有关合法 IP 和 VLAN 参数组合的详细信息。

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

  注意：默认情况下，创建时不检查外部存储的可访问性。 要在执行创建操作时检查可访问性（如果无法访问存储，则创建失败），请在 POST URI 中指定“checkExternalStorage”查询字符串。 请参阅文档中的“检查外部存储”，以检查独立于创建操作的存储的可访问性。

创建网格支持两种 IP 模式：

• 完全指定的地址，其中用户传递 app_ips 范围和 controller_ip 地址。 不接受 external_network 参数，否则会导致错误，因为地址已指定。 默认 VLAN 是可选的。
• 系统选择的地址，其中仅请求地址计数。 用户还可以选择性地指定要使用的 external_network。 不接受特定的地址，否则会导致错误。 例如，如果用户通过 app_ips 范围或 controller_ip 地址指定地址。 默认 VLAN 是可选的。

使用下表可查看传递参数时允许的 IP 和 VLAN 参数组合。 顶行标识传递的参数，参数下方列中的值表示系统响应。 这些组合可能是“允许”、“必需”或者“错误”。 例如，在传递 external_network 参数时，numAppIPs 是“必需”的。

表－创建网格 IP 和 VLAN 输入（参数和查询字符串）组合规则

* = 查询字符串输入数据（请参阅下文）

POST URI 中支持的查询字符串参数

checkExternalStorage

如果确实存在或设置为 True，则会在网格创建操作的过程中验证外部存储的可访问性。

enableLanguagePacks

如果确实存在或设置为 True，则会将所有语言包应用到所创建的网格。

numAppIPs

指定应保留以供运行在所创建的网格上的应用使用的应用 IP 地址的数量。 系统将选择特定的地址。 此外，需要该参数或网格记录中的 app_ips 参数，这些参数是互斥的；只能指定其中一个。

请参阅前面的表，其中提供了有关合法 IP 和 VLAN 参数组合的详细信息。

结果

如果成功，则返回 HTTP 代码 201 和创建的网格的名称。 如果出错，则返回 HTTP 错误代码和故障。

说明

在 BFC 中创建新网格组件。

注意：此操作不创建 AppLogic 网格。 对网格的启动操作的首次调用创建网格。

示例

以下示例假设在 POST URI 上使用查询字符串 ?numAppIPs=10 以及具有以下值的稀疏网格记录：

• 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

示例 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"}} 

响应

201

头位置

BFC/grids/bfcapigrid

注意：不支持 PUT 和 DELETE 操作。