Verwenden von API zum Erstellen von Konfigurationen aus StyleBooks
Nachdem Sie Ihr StyleBook erstellhaben, müssen Sie es in Citrix ADM importieren, um es entweder mit Citrix ADM oder mit Citrix ADM APIs zu verwenden。Citrix ADM validiert Ihr StyleBook, wenn Sie es importieren。温die Validierung erfolgreich ist, wid Ihr StyleBook im Citrix ADM-Katalog von StyleBooks angezeigt and kann zum Erstellen von Konfigurationen verwendet werden。
Sie können jetzt die StyleBook- api verwenden,嗯Konfigurationen basierend auf diesem StyleBook zu erstellen。Sie können ein beliebiges Tool wie das cURL-Befehlszeilentool oder die Chrome-Browsererweiterung von Postman verwenden, um HTTP-Anfragen an Citrix ADM zu senden。
Beispiel 1
Erwägen Sie das StyleBooklb-vserver
如:StyleBook zum Erstellen eines virtuellen负载平衡服务器erstellt haben Verwenden Sie REST API, um ein Konfigurationspaket aus diesem StyleBook wie folgt zu erstellen:
HTTP方法:帖子
URL:https:// < ADM-agent-DNS-or-IP > /样本/硝基/ v2 / config /样本/ com.example.stylebooks / 0.1 / lb-vserver / configpacks
请求头:
内容类型:application / json
接受:application / json
请求正文有效负载:
{" configpack ":{“参数”:{“名称”:“两”,“知识产权”:“10.102.117.31”},“目标”:[{" id ": " deecee30 a85041903410——f478 - 4446 - 9741 " } ] } }
在dieser HTTP-Anforderung ist die ID (z. B. " deecee30-f478-4446-9741-a85041903410 ") die Instanz-ID der Citrix ADC-Instanz, auf der virtuelle Lastausgleichsserver lb1 mit der ip - address 10.102.117.31 erstellt wade。Die Instanz-ID der Citrix ADC-Instanz wid von Citrix ADM abgerufen。
Um die ID einer Instanz zu erhalten, die von Citrix ADM verwaltet wid, können Sie Citrix ADM- apis verwenden。Um beispielsweise die Instanz-ID oder eine Citrix ADC-Instanz abzurufen, deren ip address 192.168.153.160 lautet, können Sie die folgende API verwenden:
HTTP方法:得到
URL:https:// < IP > /硝基/ v2 / config / ns ? = ip_address过滤:192.168.153.160
请求头信息:
接受:application / json
Die Antwort enthält Die ID在der JSON-Nutzlast:
预期的响应报头(成功):
200好了
内容类型:application / json
预期响应体(成功后):
{“错误代码”:0,“消息”:“完成”,“操作”:“得到”,“resourceType”:“ns”、“用户名”:“nsroot”、“tenant_name”:“老板”,“resourceName”:“”,“ns”:[{“is_grace”:“false”,“主机名”:“”,“std_bw_config”:“0”,“gateway_deployment”:“false”,“id”:“deecee30 a85041903410——f478 - 4446 - 9741 ", } ] }
Wenn das Configuration(配置包)erfolgreich erstellt wurde, erhalten Sie die folgende HTTP-Antwort:
预期的响应报头(成功):
200好了
内容类型:application / json
预期响应体(成功后):
{" configpack ":{“config_id”:“1460806080”}}< !——NeedCopy >
Sie haben Ihre erste Configuration (Configuration Pack) erstellt, die durch die ID 1460806080 eindeutig identifiiert wid。Mit柴油机ID können Sie die configuration abfragen, aktualisieren oder löschen。
Beispiel 2
Sie können dasselbe StyleBook verwenden, um ein anderes Konfigurations- oder Konfigurationspaket zu erstellen und es auf denselben oder verschiedenen Citrix ADC-Instanzen auszuführen。Erstellen Sie in diesem Beispiel eine weitere配置,geben Sie einen anderen Namen und eine andere ip - address für den virtuellen Server and geben Sie LEASTCONNECTION als Lastausgleichsmethode an。Stellen Sie diese configuration auf zwei Citrix ADC-Instanzen berit。
Die HTTP-Anfrage lautet wie folgt:
HTTP方法:帖子
URL:https:// < DNS-or-IP > /样本/硝基/ v2 / config /样本/ com.example.stylebooks / 0.1 / lb-vserver / configpacks
请求头信息:
内容类型:application / json
接受:application / json
请求正文有效负载:
{" configpack": {" parameters": {" name": "lb2", "ip": "10.102.117.32", "lb-alg": "LEASTCONNECTION"}, "targets" [{"id": "deecee30-f478-4446-9741-a85041903410"}, {"id": "debecc60-d589-4557-8632-a74032802412"}}}
在dier HTTP-Anforderung wid der virtuelle服务器ip地址10.102.117.32 auf den beiden Citrix ADC-Instanzen erstell中,die duch die id deecee30-f478-4446-9741-a85041903410 " und debecc60-d589-4557-8632-a74032802412 " dargestellt werden。
Bei erfolgreicher Erstellung des konfigationspakets wdie folgende HTTP-Antwort empfangen:
预期的响应报头(成功):
200好了
内容类型:application / json
预期响应体(成功后):
{" configpack ":{“config_id”:“1657696292”}}< !——NeedCopy >
diesel neue konfigationspaket eine andere ID 165769629。Sie können diese配置mithillife柴油ID aktualisieren oder entfernen。
Beispiel 3
背叛你的" basic-lb-config " -StyleBook, das Sie inStyleBook erstellt haben,嗯eine grundlegende lastausgleichskconfigururation zu erstellen.Verwenden Sie REST API, um ein Konfigurationspaket aus diesem StyleBook wie folgt zu erstellen:
HTTP方法:帖子
URL:http:// < DNS-or-IP > /样本/硝基/ v2 / config /样本/ com.example.stylebooks / 0.1 / basic-lb-config / configpacks
请求头信息:
内容类型:application / json
接受:application / json
预期的响应报头(成功):
200好了
内容类型:application / json
预期响应体(成功后):
{" configpack ":{“参数”:{“名称”:“myapp”、“知识产权”:“10.70.122.25”、“svc-servers”:“192.168.100.11”、“192.168.100.12”,“svc-port”:8080},“目标”:[{" id ": " deecee30 - f478 - 4446 - 9741 - a85041903410”},{" id ": " debecc60 a74032802412——d589 - 4557 - 8632 " } ] } }
在diesel HTTP-Anforderung wd die Load Balancing-Konfiguration auf zwei Citrix ADC-Instanzen ausgeführt。Sie können sich bei diesen Citrix ADC-Instanzen anmelden, um zu überprüfen, ob ein virtueller Server und eine Dienstgruppe mit zwei Diensten erstellt werden。
Beispiel 4
背叛你是zusammengesetzteStyleBook-Composite-Beispiel如:复合样式书erstellenerstellt抗议。Verwenden Sie REST API, um ein Konfigurationspaket aus diesem StyleBook wie folgt zu erstellen:
HTTP方法:帖子
URL:http:// < DNS-or-IP > /样本/硝基/ v2 / config /样本/ com.example.stylebooks / 0.1 / composite-example / configpacks
请求头信息:
内容类型:application / json
接受:application / json
请求正文有效负载:
{" configpack ":{“参数”:{“名称”:“myapp”、“知识产权”:“2.2.2.2”、“svc-servers”:[“10.102.29.52”、“10.102.29.53”]},“目标”:[{" id ": " deecee30 - f478 - 4446 - 9741 - a85041903410”},{" id ": " debecc60 a74032802412——d589 - 4557 - 8632 " } ] } }
在dieser HTTP-Anforderung wd die Konfiguration auf zwei Citrix ADC-Instanzen erstell中,die durch ihre IDs dargestellt werden。Wenn Sie siich bei Citrix ADC-Instanzen anmelden, können Sie die Konfigurationsobjekte anzeigen, die mit dem StyleBook basic-lb-config erstellt wurden, das das StyleBook Composite-example import wurde。Sie können auch einen neuen HTTP-Monitor mit dem Namen sehenmyapp-mon
, der Teil des StyleBook“复合- beispiel”战争。
Bei erfolgreicher Erstellung des konfigationspakets wdie folgende HTTP-Antwort empfangen:
预期的响应报头(成功):
200好了
内容类型:application / json
预期响应体(成功后):
{" configpack ":{“config_id”:“4917276817”}}< !——NeedCopy >
Aktualisieren einer配置
Um diese Konfiguration beispielsweise durch Hinzufügen eines neuen后台服务器ip地址10.102.29.54 zum virtuellen Lastausgleichsserver zu aktualisierenmyapp
, verwenden Sie die API zum Aktualisieren eines Konfigurationspakets wie folgt:
HTTP方法:把
URL:http:// < DNS-or-IP > /样本/硝基/ v2 / config /样本/ com.example.stylebooks / 0.1 / composite-example / configpacks / 4917276817
请求头信息:
内容类型:application / json
接受:application / json
请求正文有效负载:
{" configpack ":{“参数”:{“名称”:“myapp”、“知识产权”:“2.2.2.2”、“svc-servers”:[“10.102.29.52”、“10.102.29.53”,“10.102.29.54”]},“目标”:[{" id ": " deecee30 - f478 - 4446 - 9741 - a85041903410”},{" id ": " debecc60 a74032802412——d589 - 4557 - 8632 " } ] } }
Bei erfolgreichem更新des Konfigurationspakets wd die folgende HTTP-Antwort empfangen:
预期的响应报头(成功):
200好了
内容类型:application / json
预期响应体(成功后):
{" configpack ":{“config-id”:“4917276817”}}< !——NeedCopy >
Löschen einer配置
Um diese Konfiguration (aus allen Citrix ADC-Instanzen) zu löschen, können Sie die API wie folgt zum Löschen eines konfigationspakets verwenden:
Bei erfolgreichem Löschen des konfigationspakets bird die folgende HTTP-Antwort empfangen:
HTTP方法:删除
URL:http:// < DNS-or-IP > /样本/硝基/ v2 / config /样本/ com.example.stylebooks / 0.1 / composite-example / configpacks / 4917276817
请求头信息:
接受:application / json
预期的响应报头(成功):
200好了
内容类型:application / json
预期响应有效载荷(成功后):
{" configpack ":{“config_id”:“4917276817”}}< !——NeedCopy >
Sie können sich bei der Citrix adc -即时anmelden and sicherstellen, dass alle konfigationsobjekte, die Teil dieses konfigationspakets sind, entfernt wurden。
Wenn Sie die Konfiguration aus bestimmten Citrix ADC-Instanzen anstelle von allen Instanzen entfernen möchten, verwenden Sie den oben beschriebenen update - konfigationspack- vorgang und ändern Sie das attribute“Ziele”in der js - nutzlast, um die spezifischen Citrix ADC-Instanz-IDs zu entfernen。