-
-
-
使用 API 从样本创建配置
-
-
-
This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
使用 API 从样本创建配置
构建样本后,您必须将其导入到 Citrix Application Delivery Management (ADM),以便使用 Citrix ADM 或 Citrix ADM API 来使用样本。Citrix ADM 会在导入样本时验证样本,如果验证成功,样本将显示在 Citrix ADM 样本目录中,可用于创建配置。
现在可以使用样本 API 基于此样本创建配置。您可以使用任何工具(如 curl 命令行工具或邮递员铬浏览器扩展)将 HTTP 请求发送到 Citrix ADM。
示例 1
考虑您在中创建的 “lb-vserver” 样本用于创建负载平衡虚拟服务器的样本。使用 REST API 从此样本创建配置包,如下所示:
POST
https://<MAS-DNS-or-IP>/stylebook/nitro/v1/config/stylebooks/com.example.stylebooks/0.1/lb-vserver/configpacks
<!--NeedCopy-->
Content-Type: application/json
Accept: application/json
{
"configpack":
{
"parameters": {
"name": "lb1",
"ip": "10.102.117.31"
},
"target_devices":
[
{
"id": "deecee30-f478-4446-9741-a85041903410"
}
]
}
}
<!--NeedCopy-->
在此 HTTP 请求中,ID(例如 deecee30-f478-4446-9741-a85041903410)是在其中创建 IP 地址为 10.102.117.31 的负载平衡虚拟服务器 lb1 的 Citrix ADC 实例的实例 ID。从 Citrix ADM 中检索到 Citrix ADC 实例的实例 ID。
要获取由 Citrix ADM 管理的实例的 ID,可以使用 Citrix ADM API。例如,要检索 IP 地址为 192.168.153.160 的 Citrix ADC 实例的实例 ID,您可以使用以下 API:
GET https://<MAS-IP>/nitro/v1/config/ns?filter=ip_address:192.168.153.160
<!--NeedCopy-->
Accept: application/json
<!--NeedCopy-->
在有效负载中,响应包含 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 响应:
200 OK
Content-Type: application/json
{
"configpack":
{
"config_id": "1460806080"
}
}
<!--NeedCopy-->
您已经创建了使用 ID 1460806080 唯一标识的第一个配置(配置包)。可以使用此 ID 查询、更新或删除该配置。
示例 2
您可以使用同一样本创建另一个配置或配置包,并在相同或不同的 Citrix ADC 实例上执行它。在此示例中,创建另一个配置并为虚拟服务器提供不同的名称和 IP 地址,另外还指定 LEASTCONNECTION 作为负载平衡方法。在两个 Citrix ADC 实例上部署此配置。
HTTP 请求如下:
POST
https://<MAS-DNS-or-IP>/stylebook/nitro/v1/config/stylebooks/com.example.stylebooks/0.1/lb-vserver/configpacks
<!--NeedCopy-->
Content-Type: application/json
Accept: application/json
{
"configpack":
{
"parameters":
{
"name": "lb2",
"ip": "10.102.117.32",
"lb-alg": "LEASTCONNECTION"
},
"target_devices"
[
{"id": "deecee30-f478-4446-9741-a85041903410"},
{"id": "debecc60-d589-4557-8632-a74032802412"}
]
}
}
<!--NeedCopy-->
在此 HTTP 请求中,在由 ID deecee30-f478-4446-9741-a85041903410 和 debecc60-d589-4557-8632-a74032802412 表示的两个 Citrix ADC 实例上创建 IP 地址为 10.102.117.32 的负载平衡虚拟服务器 lb2。
成功创建配置包后,会收到以下 HTTP 响应:
200 OK
Content-Type: application/json
{
"configpack":
{
"config_id": "1657696292"
}
}
<!--NeedCopy-->
这个新的配置包具有不同的 ID 165769629。您可以通过使用此 ID 更新或删除此配置。
示例 3
考虑您在中创建的 “基本 Lb-config” 样本用于创建基本负载平衡配置的样本。使用 REST API 从此样本创建配置包,如下所示:
POST
http://<MAS-DNS-or-IP>/stylebook/nitro/v1/config/stylebooks/com.example.stylebooks/0.1/basic-lb-config/configpacks
<!--NeedCopy-->
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
},
"target_devices":
[
{
"id": "deecee30-f478-4446-9741-a85041903410"
},
{
"id": "debecc60-d589-4557-8632-a74032802412"
}
]
}
}
<!--NeedCopy-->
在此 HTTP 请求中,负载平衡配置在两个 Citrix ADC 实例上执行。您可以登录到这些 Citrix ADC 实例,以验证是否创建了绑定了两个服务的虚拟服务器和服务组。
示例 4
考虑您在中创建的复合样本合成 示例创建复合样本/en-us/citrix-application-delivery-management-software/12-1/stylebooks/how-to-create-custom-stylebooks/create-composite-stylebook.html[()] 。使用 REST API 从此样本创建配置包,如下所示:
POST http://<MAS-DNS-or-IP>/stylebook/nitro/v1/config/stylebooks/com.example.stylebooks/0.1/composite-example/configpacks
<!--NeedCopy-->
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"]
},
"target_devices":
[
{
"id": "deecee30-f478-4446-9741-a85041903410"
},
{
"id": "debecc60-d589-4557-8632-a74032802412"
}
]
}
}
<!--NeedCopy-->
在此 HTTP 请求中,将在两个由其 ID 表示的 Citrix ADC 实例上创建配置。如果您登录到 Citrix ADC 实例,则可以查看导入到 “复合示例” 样本中的 “基本 lb-config” 样本创建的配置对象。您还可以看到名为“myapp-mon”的新 HTTP 监视器,它属于“composite-example”样书的一部分。
成功创建配置包后,会收到以下 HTTP 响应:
200 OK
Content-Type: application/json{
"configpack": {
"config_id": "4917276817"
}
}
<!--NeedCopy-->
更新配置
要更新此配置,例如,通过将 IP 地址为 10.102.29.54 的新后端服务器添加到负载平衡虚拟服务器 myapp,请使用 API 更新配置包,如下所示:
PUT http://<MAS-DNS-or-IP>/stylebook/nitro/v1/config/stylebooks/com.example.stylebooks/0.1/composite-example/configpacks/4917276817
<!--NeedCopy-->
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"]
},
"target_devices":
[
{
"id": "deecee30-f478-4446-9741-a85041903410"
},
{
"id": "debecc60-d589-4557-8632-a74032802412"
}
]
}
}
<!--NeedCopy-->
成功更新配置包后,将收到以下 HTTP 响应:
200 OK
Content-Type: application/json
{
"configpack": {
"config-id": "4917276817"
}
}
<!--NeedCopy-->
删除配置
要删除此配置(从所有 Citrix ADC 实例中),您可以使用 API 删除配置包,如下所示:
DELETE http://<MAS-DNS-or-IP>/stylebook/nitro/v1/config/stylebooks/com.example.stylebooks/0.1/composite-example/configpacks/4917276817
<!--NeedCopy-->
Accept: application/json
<!--NeedCopy-->
成功删除配置包后,将收到以下 HTTP 响应:
200 OK
Content-Type: application/json
{
"configpack": {
"config_id": "4917276817"
}
}
<!--NeedCopy-->
您可以登录到 Citrix ADC 实例,并验证是否已删除属于此配置包的所有配置对象。
如果要从特定 Citrix ADC 实例而不是从所有实例中删除配置,请使用上述更新配置包操作,并在 JSON 有效负载中更改 “target t_devices” 属性以删除特定的 Citrix ADC 实例 ID。
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select Do Not Agree to exit.