Application Delivery Management

Use API to import custom StyleBooks

You can now use the StyleBook APIs to import custom StyleBooks into Citrix Application Delivery Management (ADM). Use REST API to create a configuration pack from this StyleBook as follows in any tool such as the curl command line tool or the Postman chrome browser extension. For example, you can import a StyleBook named example-lb that can be used to create a load balancer configuration on a Citrix ADC instance.

HTTP Method: POST
URL: http://<mas-ip>/stylebook/nitro/v1/config/stylebooks
Headers:
Content-Type: application/json
Accept: application/json
RequestBody:
{
       "stylebook":
  {
     "file_name": "example-lb.yaml",
     "source": "<base64-contents>",
     "encoding": "base64"
  }  
}
<!--NeedCopy-->

where, the “source” attribute’s value, is the base64 encoding of the contents of your StyleBook file. You can paste the YAML contents of your StyleBook file in an online tool, for example, https://www.browserling.com/tools/file-to-base64 to obtain the base64 string that you can then use as a value for the “source” attribute above.

Using this API call, you can also upload a compressed tarball file (.tgz file) containing multiple StyleBook files in one API operation. To do this, simply change the file_name attribute to the .tgz filename and the value for the source attribute to the base64 encoding of the contents of your .tgz file.

After the API is run successfully in the tool you get the following response that indicates that the StyleBook has been imported into Citrix ADM.

200 OK
<!--NeedCopy-->

Response Body:

{

  "stylebook":
{

    "name": "example-lb",

    "namespace": "com.example.stylebook",

    "version": "1.0"

  }

}
<!--NeedCopy-->
Use API to import custom StyleBooks