Documentation Produit
Application Delivery Management
14.1 - Current Release 13.1 13.0 12.1
Voir PDF

Utiliser l’API pour créer des configurations à partir de StyleBooks

February 1, 2024
Contributeur: 
C

Après avoir créé votre StyleBook, vous devez l’importer dans Citrix Application Delivery Management (ADM) pour l’utiliser soit à l’aide de Citrix ADM, soit à l’aide des API Citrix ADM. Citrix ADM valide votre StyleBook lorsque vous l’importez, et si la validation est réussie, votre StyleBook apparaît dans le catalogue Citrix ADM de StyleBooks, prêt à être utilisé pour créer des configurations.

Vous pouvez désormais utiliser les API StyleBook pour créer des configurations basées sur ce StyleBook. Vous pouvez utiliser n’importe quel outil tel que l’outil de ligne de commande curl ou l’extension de navigateur Chrome Postman pour envoyer des requêtes HTTP à Citrix ADM.

Exemple 1

Considérez le StyleBook « lb-vserver » que vous avez créé dans StyleBook pour créer un serveur virtuel d’équilibrage de charge. Utilisez l’API REST pour créer un configpack à partir de ce StyleBook comme suit :

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-->

Dans cette requête HTTP, l’id (par exemple, « deecee30-f478-4446-9741-a85041903410 ») est l’ID d’instance de l’instance Citrix ADC sur laquelle le serveur virtuel d’équilibrage de charge lb1 avec l’adresse IP 10.102.117.31 est créé. L’ID d’instance de l’instance Citrix ADC est extrait de Citrix ADM.

Pour obtenir l’ID d’une instance gérée par Citrix ADM, vous pouvez utiliser les API Citrix ADM. Par exemple, pour récupérer l’ID d’instance d’une instance Citrix ADC dont l’adresse IP est 192.168.153.160, vous pouvez utiliser l’API suivante :

GET https://<MAS-IP>/nitro/v1/config/ns?filter=ip_address:192.168.153.160
<!--NeedCopy-->

Accept: application/json
<!--NeedCopy-->

La réponse contient l’ID de la charge utile :

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-->

Si la configuration (configpack) a été créée avec succès, vous recevez la réponse HTTP suivante :

200 OK
Content-Type: application/json
{
  "configpack":
  {
    "config_id": "1460806080"
  }
}
<!--NeedCopy-->

Vous avez créé votre première configuration (configpack) qui est identifiée de manière unique à l’aide de l’ID 1460806080. Vous pouvez utiliser cet ID pour interroger, mettre à jour ou supprimer la configuration.

Exemple 2

Vous pouvez utiliser le même StyleBook pour créer une autre configuration ou configpack et l’exécuter sur les mêmes instances de Citrix ADC ou différentes. Dans cet exemple, créez une autre configuration et fournissez un nom et une adresse IP différents pour le serveur virtuel et spécifiez LEASTCONNECTION comme méthode d’équilibrage de charge. Déployez cette configuration sur deux instances Citrix ADC.

La requête HTTP est la suivante :

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-->

Dans cette requête HTTP, le serveur virtuel d’équilibrage de charge lb2 avec l’adresse IP 10.102.117.32 est créé sur les deux instances Citrix ADC représentées par les ID « deecee30-f478-4446-9741-a85041903410 » et « debecc60-d589-4557-8632-a74032802412 ».

En cas de création réussie du configpack, la réponse HTTP suivante est reçue :

200 OK
Content-Type: application/json
{
   "configpack":
  {
     "config_id": "1657696292"
  }
}
<!--NeedCopy-->

Ce nouveau configpack a un identifiant différent 165769629. Vous pouvez mettre à jour ou supprimer cette configuration à l’aide de cet ID.

Exemple 3

Considérez le StyleBook « basic-lb-config » que vous avez créé dans StyleBook pour créer une configuration d’équilibrage de charge de base. Utilisez l’API REST pour créer un configpack à partir de ce StyleBook comme suit :

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-->

Dans cette requête HTTP, la configuration d’équilibrage de charge est exécutée sur deux instances Citrix ADC. Vous pouvez ouvrir une session sur ces instances Citrix ADC pour vérifier si un serveur virtuel et un groupe de services avec deux services liés sont créés.

Exemple 4

Prenons l’ exemple composite StyleBook composite que vous avez créé dans Créer un StyleBook composite. Utilisez l’API REST pour créer un configpack à partir de ce StyleBook comme suit :

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-->

Dans cette requête HTTP, la configuration est créée sur deux instances Citrix ADC représentées par leurs ID. Si vous ouvrez une session sur les instances Citrix ADC, vous pouvez afficher les objets de configuration créés par le StyleBook « basic-lb-config » qui a été importé dans le StyleBook « composite-example ». Vous pouvez également voir un nouveau moniteur HTTP appelé « myapp-mon » qui faisait partie du StyleBook « composite-example ».

En cas de création réussie du configpack, la réponse HTTP suivante est reçue :

200 OK
Content-Type: application/json{
  "configpack": {
    "config_id": "4917276817"
  }
}
<!--NeedCopy-->

Mise à jour d’une configuration

Pour mettre à jour cette configuration, par exemple, en ajoutant un nouveau serveur backend avec l’adresse IP 10.102.29.54 au serveur virtuel d’équilibrage de charge myapp, utilisez l’API pour mettre à jour un configpack comme suit :

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-->

En cas de mise à jour réussie du configpack, la réponse HTTP suivante est reçue :

200 OK
Content-Type: application/json
{
   "configpack": {
     "config-id": "4917276817"
  }
}
<!--NeedCopy-->

Suppression d’une configuration

Pour supprimer cette configuration (à partir de toutes les instances de Citrix ADC), vous pouvez utiliser l’API pour supprimer un configpack comme suit :

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-->

En cas de suppression réussie du configpack, la réponse HTTP suivante est reçue :

200 OK
Content-Type: application/json
{
   "configpack": {
     "config_id": "4917276817"
  }
}
<!--NeedCopy-->

Vous pouvez ouvrir une session sur l’instance de Citrix ADC et vérifier que tous les objets de configuration qui font partie de ce configpack ont été supprimés.

Si vous souhaitez supprimer la configuration d’instances Citrix ADC spécifiques au lieu de toutes, utilisez l’opération update configpack décrite ci-dessus et modifiez l’attribut « target_devices » dans la charge utile JSON pour supprimer les ID d’instance Citrix ADC spécifiques.

Utiliser l’API pour créer des configurations à partir de StyleBooks
February 1, 2024
Contributeur: 
C
February 1, 2024
Contributeur: 
C

Dans cet article

Commentaires sur le site | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.