-
-
-
-
-
APIを使用してStyleBookから設定を作成する
-
-
-
-
-
-
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を使用してStyleBookから設定を作成する
StyleBookを作成したら、それをCitrix Application Delivery Management（ADM）にインポートして、Citrix ADM またはCitrix ADM APIを使用して使用する必要があります。NetScaler ADM はインポート時にStyleBookを検証し、検証が成功すると、StyleBookのNetScaler ADMカタログにStyleBookが表示され、構成の作成に使用できます。
StyleBook APIを使用して、このStyleBookに基づいて構成を作成できるようになりました。curlコマンドラインツールやPostman chromeブラウザ拡張機能などの任意のツールを使用して、Citrix ADM にHTTPリクエストを送信できます。
例1
負荷分散仮想サーバーを作成するために、StyleBookで作成した「lb-vserver」StyleBookについて考えてみます。REST APIを使用して、このStyleBookから次のように構成パックを作成します：
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”）は、負荷分散仮想サーバー lb1 がIPアドレス10.102.117.31が作成されるNetScaler ADC インスタンスのインスタンスIDです。NetScaler ADC インスタンスのインスタンス ID は NetScaler ADM から取得されます。
NetScaler ADM によって管理されるインスタンスのIDを取得するには、NetScaler 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
同じStyleBookを使用して別の構成パックを作成し、同じまたは異なるNetScaler ADCインスタンスで実行できます。この例では、別の構成を作成し、仮想サーバーに異なる名前とIPアドレスを指定します。また、負荷分散の方法としてLEASTCONNECTIONを指定します。この構成を 2 つの NetScaler 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リクエストでは、IPアドレス10.102.117.32の負荷分散仮想サーバーlb2が、ids “deecee30-f478-4446-9741-a85041903410”と”debecc60-d589-4557-8632-a74032802412”で表される2つのNetScaler ADC インスタンスに作成されます。
構成パックが正常に作成されると、次の HTTP 応答が受信されます。
200 OK
Content-Type: application/json
{
"configpack":
{
"config_id": "1657696292"
}
}
<!--NeedCopy-->
この新しい構成パックには、異なる ID 165769629 があります。このIDを使用することで、この構成を更新または削除できます。
例3
「基本的な負荷分散の構成を作成するためのStyleBook」で作成した「basic-lb-config」StyleBookを参考にします。REST APIを使用して、このStyleBookから次のように構成パックを作成します：
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リクエストでは、2つのNetScaler ADC インスタンスで負荷分散構成が実行されます。これらのNetScaler ADC インスタンスにログオンして、仮想サーバーと2つのサービスがバインドされたサービスグループが作成されているかどうかを確認できます。
例4
「複合StyleBookの作成」で作成した複合StyleBookのcomposite-exampleを参考にします。REST APIを使用して、このStyleBookから次のように構成パックを作成します：
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で表される2つのNetScaler ADC インスタンスに作成されます。NetScaler ADC インスタンスにログオンすると、「複合例」StyleBookにインポートされた「basic-lb-config」StyleBookで作成された構成オブジェクトを表示できます。また、「composite-example」StyleBookの一部だった「myapp-mon」という新しいHTTPモニターも表示されます。
構成パックが正常に作成されると、次の 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-->
構成の削除
この構成を（すべてのNetScaler 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-->
NetScaler ADCインスタンスにログオンし、この構成パックに含まれるすべての構成オブジェクトが削除されたことを確認できます。
構成をすべてではなく特定のNetScaler ADCインスタンスから削除する場合は、上記の構成パックの更新操作を使用し、JSONペイロードの「target_devices」属性を変更して、特定のNetScaler ADCインスタンスIDを削除します。
共有
共有
This Preview product documentation is Cloud Software Group Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Cloud Software Group 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 Cloud Software Group product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.