Usa las API para actualizar un paquete de configuración existente
Puede usar la API StyleBook para actualizar los paquetes de configuración existentes en NetScaler Console.
PONER: https://<ADM-endpoint-name>/stylebook/nitro/v2/config/configpacks/<configpack-ID>?mode=async
Cargaútil :
{
"configpack": {
"stylebook": {
"name": "waf-adv",
"namespace": "com.citrix.adc.stylebooks",
"version": "1.3"
},
"parameters": {
"name": "TestApp1",
"lbname": "my-lbv",
"waf-settings": {
"rule": "true",
"type": [
"HTML"
],
"profile-settings": {
"logeverypolicyhit": false,
"enablesignatures": {
"signaturename": "waf-sign1"
},
"sqlinjection-settings": {
"sqlinjectionaction": [
"log",
"stats"
],
"sqlinjection-default-settings": {
"sqlinjectiontransformspecialchars": true,
"sqlinjectionchecksqlwildchars": true,
"sqlinjectiontype": "SQLSplCharANDKeyword",
"sqlinjectionparsecomments": "checkall",
"sqlinjectiongrammar": "OFF"
}
},
"bufferoverflow-settings": {
"bufferoverflowaction": [
"log"
],
"bufferoverflowmaxurllength": "2048",
"bufferoverflowmaxheaderlength": "4096",
"bufferoverflowmaxcookielength": "4096",
"bufferoverflowmaxquerylength": "65535",
"bufferoverflowmaxtotalheaderlength": "65535"
}
}
}
},
"targets": [
{
"instance_id": "1b322685-3b23-4111-a9ce-56dd1c659e4c"
}
]
}
}
<!--NeedCopy-->
Se devuelve un estado HTTP 202 y un cuerpo de respuesta con un ID de trabajo. Puede utilizar el identificador del trabajo para realizar un seguimiento del estado de la operación de actualización:
{
"job": {
"job_id": "1092579455"
}
}
<!--NeedCopy-->
Puede realizar un seguimiento de este identificador de trabajo (en este ejemplo, 1092579455) mediante la API de sondeo de trabajos:
OBTENGA: https://<ADM-endpoint-name>/stylebook/nitro/v2/config/jobs/1092579455
La operación de actualización se completa correctamente si la respuesta contiene el estado establecido en “completado”. Cualquier otro valor de este campo indica que se ha producido un error en la tarea de actualización. La causa del error está disponible en el objeto progress_info.
{
"job": {
"job_id": "4268148987",
"status": "completed",
"progress_info": [
{
"is_last": "false",
"message": "Validated the parameters",
"status": "success"
},
{
"is_last": "false",
"message": "Configuration audit completed",
"status": "success"
},
{
"is_last": "false",
"message": "Computed configuration objects",
"status": "success"
},
{
"is_last": "false",
"message": "Prepared objects for applying configuration on 192.168.153.165",
"status": "success"
},
{
"is_last": "false",
"message": "Retrieved existing data for updatable objects on instance 192.168.153.165",
"status": "success"
},
{
"is_last": "false",
"message": "Applied configuration on instance 192.168.153.165",
"status": "success"
},
{
"is_last": "false",
"message": "Retrieved data for configuration audit on instance 192.168.153.165",
"status": "success"
},
{
"is_last": "false",
"message": "Logged out from instance 192.168.153.165",
"status": "success"
},
{
"is_last": "true",
"message": "Saved configpack.",
"status": "completed"
}
],
"result": {
"status": "completed",
"id": "4268148987",
"config_key": "4268148987",
"created_by": "nsroot",
"created_datetime": "2023-01-20 18:57:58.985435",
"created_datetimestamp": "2023-01-20 18:57:58",
"last_modified_by": "nsroot",
"last_modified_datetime": "2023-01-20 19:00:32",
"name": "sample-dns-stylebook",
"namespace": "com.citrix.adc.tests",
"version": "1.0"
}
}
}
<!--NeedCopy-->
Usa las API para actualizar las instancias de destino
En la carga útil del paquete de configuración de actualizaciones, cambie la targets sección para agregar, eliminar o reemplazar una instancia de NetScaler.
Ejemplo:
En el siguiente ejemplo, el objeto targets de la carga útil se cambia para añadir un nuevo NetScaler de destino a la configuración:
{
"targets": [
{
"instance_id": "<Existing-ADC-instance-ID>"
},
{
"instance_id": "<New-ADC-instance-ID>"
}
],
}
<!--NeedCopy-->
Si la actualización se realiza correctamente, la configuración se implementa en la nueva instancia de NetScaler. Cambiar los objetivos de una configuración es útil si desea mover configuraciones de aplicaciones entre NetScalers. Por ejemplo, modifique el targets objeto cuando sea necesario eliminar un NetScaler de una configuración por motivos de mantenimiento.
Nota
Para eliminar una configuración de todas sus instancias de destino actuales, utilice un
targetsobjeto vacío. La configuración de NetScaler Console se conserva, pero se elimina de todos los NetScalers en los que se implementó anteriormente. Puede volver a actualizar la configuración para especificar uno o varios destinos, si es necesario.
El siguiente ejemplo de API elimina la configuración de todos sus destinos existentes:
PONER: https://<ADM-endpoint-name>/stylebook/nitro/v2/config/configpacks/<configpack-ID>?mode=async
Cargaútil :
{
"configpack": {
"stylebook": {
"name": "waf-adv",
"namespace": "com.citrix.adc.stylebooks",
"version": "1.3"
},
"parameters": {
"name": "TestApp1",
"lbname": "my-lbv",
"waf-settings": {
"rule": "true",
"type": [
"HTML"
],
"profile-settings": {
"logeverypolicyhit": false,
"enablesignatures": {
"signaturename": "waf-sign1"
},
"sqlinjection-settings": {
"sqlinjectionaction": [
"log",
"stats"
],
"sqlinjection-default-settings": {
"sqlinjectiontransformspecialchars": true,
"sqlinjectionchecksqlwildchars": true,
"sqlinjectiontype": "SQLSplCharANDKeyword",
"sqlinjectionparsecomments": "checkall",
"sqlinjectiongrammar": "OFF"
}
},
"bufferoverflow-settings": {
"bufferoverflowaction": [
"log"
],
"bufferoverflowmaxurllength": "2048",
"bufferoverflowmaxheaderlength": "4096",
"bufferoverflowmaxcookielength": "4096",
"bufferoverflowmaxquerylength": "65535",
"bufferoverflowmaxtotalheaderlength": "65535"
}
}
}
},
"targets": []
}
}
<!--NeedCopy-->