使用 API 从 StyleBook 创建配置
构建 StyleBook 后，您必须使用 NetScaler Console GUI 或 NetScaler Console API 导入它。NetScaler Console 会在您导入 StyleBook 时对其进行验证。如果验证成功，您的 StyleBook 将显示在 NetScaler Console 的 StyleBook 目录中，可用于创建配置。
现在，您可以使用 StyleBook API 基于此 StyleBook 创建配置。您可以使用任何工具（例如 cURL 命令行工具或 Postman Chrome 浏览器扩展程序）向 NetScaler Console 发送 HTTP 请求。
示例 1
请考虑您在“StyleBook 以创建负载平衡虚拟服务器”中创建的 lb-vserver StyleBook。使用 REST API 从此 StyleBook 创建配置包，如下所示：
HTTP 方法：POST
URL：https://<IP>/stylebook/nitro/v2/config/configpacks
请求标头：
Content-Type: application/json
Accept: application/json
请求正文负载：
{
"configpack":
{
"parameters": {
"name": "lb1",
"vip-ipaddress": "10.102.117.31"
},
"targets":
[
{
"instance_id": "deecee30-f478-4446-9741-a85041903410"
}
],
"stylebook": {
"name": "lb-vserver",
"namespace": "com.example.stylebooks",
"version": "1.0"
}
}
}
<!--NeedCopy-->
在此 HTTP 请求中，IP 地址为 10.102.117.31 的负载平衡虚拟服务器 lb1 在实例 ID 为“deecee30-f478-4446-9741-a85041903410”的 NetScaler 实例上创建。NetScaler 实例的实例 ID 是从 NetScaler Console 中检索的。
要获取由 NetScaler Console 管理的实例 ID，您可以使用 NetScaler Console API。例如，要检索 IP 地址为 192.168.153.160 的 NetScaler 实例的实例 ID，您可以使用以下 API：
HTTP 方法：GET
URL：https://<IP>/nitro/v2/config/ns?filter=ip_address:192.168.153.160
请求标头：
Accept: application/json
响应在 JSON 负载中包含 ID：
预期响应标头（成功时）：
200 OK
Content-Type: application/json
预期响应正文（成功时）：
{
"errorcode": 0,
"message": "Done",
"operation": "get",
"resourceType": "ns",
"username": "nsroot",
"tenant_name": "Owner",
"resourceName": "",
"ns":
[
{
"is_grace": "false",
"hostname": "",
"std_bw_config": "0",
"gateway_deployment": "false",
"id": "deecee30-f478-4446-9741-a85041903410",
}
]
}
<!--NeedCopy-->
如果配置（配置包）成功创建，您将收到以下 HTTP 响应：
预期响应标头（成功时）：
202 OK
Content-Type: application/json
预期响应正文（成功时）：
{
"job":
{
"job_id": "1460806080"
}
}
<!--NeedCopy-->
您已创建第一个作业，该作业通过 ID 1460806080 唯一标识。您可以使用此 ID 查询、更新或删除配置。
您可以使用以下 URL 查询作业状态：
https://<IP>/stylebook/nitro/v2/config/jobs/<jobid>。
示例 2
您可以使用相同的 StyleBook 创建另一个配置包，并在相同或不同的 NetScaler 实例上运行它。在此示例中，创建另一个配置，并为虚拟服务器提供不同的名称和 IP 地址。将 LEASTCONNECTION 指定为负载平衡方法。将此配置部署到两个 NetScaler 实例上。
HTTP 请求如下：
HTTP 方法：POST
URL：https://<IP>/stylebook/nitro/v2/config/configpacks
请求标头：
Content-Type: application/json
Accept: application/json
请求正文负载：
{
"configpack":
{
"parameters": {
"name": "lb1",
"vip-ipaddress": "10.102.117.31",
"lb-alg": "LEASTCONNECTION"
},
"targets":
[
{
"instance_id": "deecee30-f478-4446-9741-a85041903410"
},
{
"instance_id": "abcdee30-f478-4446-9741-a85041903410"
}
],
"stylebook": {
"name": "lb-vserver",
"namespace": "com.example.stylebooks",
"version": "1.0"
}
}
}
<!--NeedCopy-->
在此 HTTP 请求中，IP 地址为 10.102.117.31 的负载平衡虚拟服务器 lb1 在实例 ID 为“deecee30-f478-4446-9741-a85041903410”和“abcdee30-f478-4446-9741-a85041903410”的两个 NetScaler 实例上创建。
成功创建配置包后，将收到以下 HTTP 响应：
预期响应标头（成功时）：
202 OK
Content-Type: application/json
预期响应正文（成功时）：
{
"job": {
"job_id": "165769629"
}
}
<!--NeedCopy-->
此新配置包具有不同的 ID 1657696292。您可以使用此 ID 更新或删除此配置。
示例 3
请考虑您在“StyleBook 以创建基本负载平衡配置”中创建的“basic-lb-config”StyleBook。使用 REST API 从此 StyleBook 创建配置包，如下所示：
HTTP 方法：POST
URL：https://<IP>/stylebook/nitro/v2/config/configpacks
请求标头：
Content-Type: application/json
Accept: application/json
请求正文负载：
Content-Type: application/json
Accept: application/json
{
"configpack":
{
"parameters":
{
"name": "myapp",
"ip": "10.70.122.25",
"svc-servers": ["192.168.100.11","192.168.100.12"],
"svc-port": 8080
},
"targets":
[
{
"instance_id": "deecee30-f478-4446-9741-a85041903410"
},
{
"instance_id": "abcdefgi-d589-4557-8632-a74032802412"
}
],
"stylebook": {
"name": "basic-lb-config",
"namespace": "com.example.stylebooks",
"version": "0.1"
}
}
}
<!--NeedCopy-->
预期响应标头（成功时）：
202 OK
Content-Type: application/json
预期响应正文（成功时）：
{
"job": {
"job_id": "3628681382"
}
}
<!--NeedCopy-->
在此 HTTP 请求中，负载平衡配置在两个 NetScaler 实例上运行。您可以登录到这些 NetScaler 实例，以验证是否已创建虚拟服务器以及绑定了两个服务的一个服务组。
示例 4
请考虑您在“创建复合 StyleBook”中创建的复合 StyleBook composite-example。使用 REST API 从此 StyleBook 创建配置包，如下所示：
HTTP 方法：POST
URL：https://<IP>/stylebook/nitro/v2/config/configpacks
请求标头：
Content-Type: application/json
Accept: application/json
请求正文负载：
{
"configpack":
{
"parameters": {
"name": "myapp",
"ip": "2.2.2.2",
"svc-servers": ["10.102.29.52","10.102.29.53"]
},
"targets":
[
{
"id": "deecee30-f478-4446-9741-a85041903410"
},
{
"id": "abcdefgg-d589-4557-8632-a74032802412"
}
],
"stylebook": {
"name": "composite-example",
"namespace": "com.example.stylebooks",
"version": "0.1"
}
}
<!--NeedCopy-->
在此 HTTP 请求中，配置在由其 ID 表示的两个 NetScaler 实例上创建。如果您登录到 NetScaler 实例，则可以查看由导入到“composite-example”StyleBook 中的“basic-lb-config”StyleBook 创建的配置对象。您还可以看到一个名为 myapp-mon 的新 HTTP 监视器，它是“composite-example”StyleBook 的一部分。
成功创建配置包后，将收到以下 HTTP 响应：
预期响应标头（成功时）：
202 OK
Content-Type: application/json
预期响应正文（成功时）：
{
"job": {
"job_id": "3628681382"
}
}
<!--NeedCopy-->
更新配置
请考虑要使用 IP 地址为 10.102.29.54 的新后端服务器更新的配置。要将服务器添加到负载平衡虚拟服务器 myapp，请使用以下 API：
HTTP 方法：PUT
URL：https://<IP>/stylebook/nitro/v2/config/configpacks/<configpackid>
请求标头：
Content-Type: application/json
Accept: application/json
请求正文负载：
{
"configpack": {
"parameters": {
"name": "myapp",
"ip": "2.2.2.2",
"svc-servers": ["10.102.29.52","10.102.29.53","10.102.29.54"]
},
"targets":
[
{
"instance_id": "deecee30-f478-4446-9741-a85041903410"
},
{
"instance_id": "abdcedff-d589-4557-8632-a74032802412"
}
]
}
}
<!--NeedCopy-->
成功更新配置包后，将收到以下 HTTP 响应：
预期响应标头（成功时）：
202 OK
Content-Type: application/json
预期响应正文（成功时）：
{
"job": {
"job_id": "3628681382"
}
}
<!--NeedCopy-->
删除配置
要删除此配置（从所有 NetScaler 实例中），您可以使用删除配置包的 API，如下所示：
成功删除配置包后，将收到以下 HTTP 响应：
HTTP 方法：DELETE
URL：https://<DNS-or-IP>//stylebook/nitro/v2/config/configpacks/<configpackid>
请求标头：
Accept: application/json
预期响应标头（成功时）：
202 OK
Content-Type: application/json
预期响应负载（成功时）：
{
"job": {
"job_id": "3628681382"
}
}
<!--NeedCopy-->
登录到 NetScaler 实例并验证此配置包中的所有配置对象是否已删除。
要从特定的 NetScaler 实例而不是所有实例中删除配置，请使用更新配置中的更新配置包操作。更改 JSON 负载中的 targets 属性以删除特定的 NetScaler 实例 ID。