Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Verwenden Sie APIs, um Konfigurationen zu erstellen
Verwenden Sie die StyleBook-API, um Konfigurationen zu erstellen, die auf diesem StyleBook basieren. Sie können jedes Tool wie das cURL-Befehlszeilentool oder die Postman Chrome-Browsererweiterung verwenden, um HTTP-Anfragen an NetScaler Console zu senden.
Betrachten Sie das StyleBook-Beispiel, das Sie in How to Create a StyleBook to Upload SSL Certificate and Certificate Key Files to NetScaler Console 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" } ] } } }
Dadurch wird eine Job-ID zurückgegeben, die verwendet werden kann, um den Abschluss des Konfigurationsjobs zu verfolgen:
{
"job": {
"job_id": "388922985"
}
}
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"
}
}
}
Die Job-ID (388922985) identifiziert das Konfigurationspaket. Mit dieser ID können Sie die Konfiguration abfragen, aktualisieren oder löschen.