Usar API para importar StyleBooks personalizados
Utilice la API de StyleBook para importar StyleBooks personalizados en NetScaler Console. Utilice las API de REST para crear un paquete de configuración a partir de este StyleBook en cualquier herramienta, como la herramienta de línea de comandos cURL o la extensión del navegador Postman. Por ejemplo, puede importar un StyleBook llamado
example-lb que se puede usar para crear una configuración de equilibrador de carga en una instancia de NetScaler.
Método HTTP: POST
URL:
https://<ADM-endpoint-name>/stylebook/nitro/v2/config/stylebooks/actions/import?mode=async
{
"import": {
"file_name": "add_dnssoarec.yaml",
"source": "<base 64 encoded content of the sb definition>",
"encoding": "base64"
}
}
Donde, el valor del atributo
source es la codificación base64 del contenido de su archivo StyleBook. Puede pegar el contenido YAML de su archivo StyleBook en una herramienta en línea. Por ejemplo, use <https://www.browserling.com/tools/file-to-base64> para obtener la cadena base64 que luego puede usar como valor para el atributo source.
Con esta llamada a la API, también puede cargar un archivo tarball comprimido (archivo .tgz) que contenga varios archivos StyleBook en una sola operación de API. Haga lo siguiente:
-
Cambie el atributo
file_nameal archivo .tgz -
Cambie el atributo
sourcea la codificación base64 del contenido de su archivo .tgz
Después de que la API se ejecute correctamente en la herramienta, obtendrá una respuesta con un ID de trabajo. Utilice este ID de trabajo para realizar un seguimiento de la operación hasta su finalización:
200 ACCEPTED
Cuerpo de la respuesta:
{
"job": {
"job_id": "12345678"
}
}
Utilice el ID de trabajo para realizar un seguimiento del estado de la operación:
Método HTTP: GET
URL:
https://<ADM-endpoint-name>/stylebook/nitro/v2/config/jobs/<job-id>
Se devuelve el estado del trabajo:
200 OK
Cuerpo de la respuesta:
{
"job": {
"job_id": "<job-id>",
"progress_info": [
{
"is_last": "true",
"message": "No job found",
"status": "failed"
}
],
"status": "completed"
}
}
El valor de estado de "completed" indica que el StyleBook se ha importado correctamente. Confirme el estado de las operaciones obteniendo información sobre el StyleBook:
Método HTTP: GET
URL:
https://<ADM-endpoint-name>/stylebook/nitro/v2/config/stylebooks/samples/1.0/demo-helper-object
Se muestran los detalles del StyleBook importado:
200 OK
Cuerpo de la respuesta:
{
"stylebook": {
"builtin_namespaces": {},
"created_datetime": "2023-01-14 00:13:59",
"custom": true,
"dependencies": [],
"deprecate": "false",
"description": "This Stylebook is a test",
"display_name": "Test StyleBooks",
"encoding": "BASE64",
"header": "Test StyleBooks",
"icon": "''",
"id": "demo575731aacbfc20b4ff00b3b60ea59855",
"is_updatable": true,
"name": "demo-helper-object",
"namespace": "samples",
"primary_keys": {},
"private": false,
"repository_name": "",
"reverse_dependencies": [],
"schema_version": "1.0",
"source": "<base 64 encoded content of the stylebook definition>",
"tenant_id": "1a45fd70-7ce3-4bff-8642-1bd7f7e97673",
"username": "abc",
"version": "1.0"
}
}