Verwenden Sie APIs, um Konfigurationen zu erstellen
Verwenden Sie die StyleBook-API, um Konfigurationen zu erstellen, die auf diesem StyleBook basieren. Sie können ein beliebiges Tool wie das cURL-Befehlszeilentool oder die Chrome-Browsererweiterung von Postman verwenden, um HTTP-Anfragen an NetScaler ADM zu senden.
Betrachten Sie das StyleBook-Beispiel, das Sie in How to Create a StyleBook to Upload SSL-Zertifikat und Zertifikatsschlüsseldateien auf NetScaler ADM erstellt haben, um das Zertifikat und die Schlüsseldateien hochzuladen. Verwenden Sie die REST-API, um ein Konfigurationspaket aus dem StyleBook wie folgt zu erstellen:
POST
https://<ADM-endpoint-name>/stylebook/nitro/v2/config/configpacks?mode=async
{
"configpack": {
"stylebook": {
"name": "lb",
"namespace": "com.citrix.adc.stylebooks",
"version": "1.1"
},
"parameters": {
"lb-appname": "lbapp1",
"lb-virtual-ip": "192.168.1.1",
"lb-virtual-port": "443",
"lb-service-type": "SSL",
"svc-service-type": "HTTP",
"svc-servers": [
{
"ip": "193.1.1.1",
"port": "80"
}
],
"certificates": [
{
"cert-name": "cert1",
"cert-file": {
"name": "c3.pem",
"contents": "<base64 encoded content>",
"encoding_type": "base64"
},
"ssl-inform": "PEM",
"key-file": {
"name": "c3.key",
"contents": "<base64 encoded content>",
"encoding_type": "base64"
}
}
]
},
"targets": [
{
"instance_id": "1b322685-3b23-4111-a9ce-56dd1c659e4c"
}
]
}
}
}
<!--NeedCopy-->
Dadurch wird eine Job-ID zurückgegeben, die verwendet werden kann, um den Abschluss des Konfigurationsjobs zu verfolgen:
{
"job": {
"job_id": "388922985"
}
}
<!--NeedCopy-->
Verwenden Sie die Job-Polling-API, um den Status des Jobs und den Abschluss des Konfigurationsjobs herauszufinden:
GET
https://<ADM-endpoint-name>/stylebook/nitro/v2/config/jobs/388922985
200 OK
{
"job": {
"job_id": "388922985",
"status": "completed",
"progress_info": [...],
"result": {
"config_key": "388922985",
"created_by": "nsroot",
"created_datetime": "2023-01-14 01:46:05.410998",
"created_datetimestamp": "2023-01-14 01:46:05",
"id": "388922985",
"incarnation_number": "0",
"last_modified_by": "nsroot",
"last_modified_datetime": "2023-01-14 01:46:05",
"lock": "Y",
"name": "sample-dns-stylebook",
"namespace": "com.citrix.adc.tests",
"primary_keys": "{}",
"sb_id": "samp4ed0c4c90aefaadaff6422b0c395f67f",
"status": "completed",
"target_devices_json": "[{"instance_id": "49a45044-ceb3-4e9d-8a5d-e3fe225d90ed", "id": "1833061454", "group_id": "", "instance_ip": "192.168.153.165", "hostname": "ctx-adc-dc01-v-prod-54", "instance_role": "[\\"default\\"]", "incarnation_number": "0"}]",
"tenant_id": "1a45fd70-7ce3-4bff-8642-1bd7f7e97673",
"version": "1.0"
}
}
}
<!--NeedCopy-->
Die Job-ID (388922985) identifiziert das Konfigurationspaket. Mit dieser ID können Sie die Konfiguration abfragen, aktualisieren oder löschen.