Enable Products on an application

You can enable the Products an application runs from Azion Console, the Azion CLI, or the API. Each Product adds variables and behaviors that the rules of the application can use. To create the application itself, in front of your origin, refer to Applications quickstart.

Protocols, ports, and TLS settings belong to the workload that serves the application. The workload also carries the domains that reach it.

Prerequisites

Console

An application. To create one, refer to Applications quickstart.

Access to Azion Console. To sign in, refer to Access Azion Console.

CLI

An application. To create one, refer to Applications quickstart.

The Azion CLI, installed and authorized with your account. The commands on this page match Azion CLI 4.23.0. For more information, refer to Azion CLI.
The ID of the application. Azion Console shows it in the address of the application’s page, after /applications/edit/.

API

An application. To create one, refer to Applications quickstart.

A personal token, sent in the Authorization header as Token [TOKEN VALUE]. To create one, refer to Manage a personal token.
curl, or another HTTP client.
The ID of the application. Azion Console shows it in the address of the application’s page, after /applications/edit/.

Enable a Product on the application

A new application runs Cache and Functions. Application Accelerator and Image Processor stay off until you enable them. Azion Console labels Cache “Automatically enabled in all accounts.”

Each Product changes what the rules and settings of the application can do:

Application Accelerator adds the ${request_uri} variable and other Rules Engine options. It also lets a cache setting vary by query string, cookies, device group, and request method. A cache setting can then take a Max Age below 60 seconds. Data transfer through Application Accelerator can generate usage-related costs. For more information, refer to Application Accelerator settings and Pricing.
Image Processor adds the Optimize Images behavior, which edits images as the application delivers them. For more information, refer to Image Processor quickstart.
Functions lets you instantiate a function on the application and run it with the Run Function behavior. For more information, refer to Instantiate a function on an application.

In Azion Console, a Rules Engine option that needs a Product carries a note such as - Required Image Processor.

Console

To enable a Product in Azion Console:

Open the application

Access Azion Console > Applications, then select your application.

Select the Main Settings tab

Turn on the Product

In Modules, under Default Modules, turn on the Product, such as Application Accelerator.

Select Save

The application runs the Product, and its rules can use the variables and behaviors the Product adds. The Main Settings tab also holds a Subscription modules group, with a Contact sales action.

CLI

To enable Application Accelerator with the Azion CLI, run azion update application with your application ID in place of <application-id>:

azion update application --application-id <application-id> --application-accelerator true

The command confirms the update:

Updated Application with ID <application-id>

The same command takes --image-processor true to enable Image Processor, and --functions true to enable Functions.

API

To enable Application Accelerator with the API, send a PATCH request to your application. The body names the Product inside modules:

Shell

01curl --request PATCH \

02 --url https://api.azion.com/v4/workspace/applications/<application-id> \

03 --header 'Accept: application/json' \

04 --header 'Authorization: Token [TOKEN VALUE]' \

05 --header 'Content-Type: application/json' \

06 --data {

07 "modules": {

08 "application_accelerator": {

09 "enabled": true

10 }

11 }

12}

The API answers 202 with "state": "pending" and returns the application. Its modules object lists cache, functions, application_accelerator, and image_processor, each with an enabled value. To enable Image Processor or Functions, name image_processor or functions in modules instead.

Read the Products an application runs

The application reports its Products in Azion Console, in the CLI, and in the API. Read them after an update to confirm which Products are enabled.

Console

Open the Main Settings tab of the application. Under Modules, the toggle of each enabled Product is on.

CLI

To read the application with the Azion CLI, run azion describe application:

azion describe application --application-id <application-id>

The output carries a modules object. An application that runs all four Products returns:

JSON

01"modules": {

02 "application_accelerator": { "enabled": true },

03 "cache": { "enabled": true },

04 "functions": { "enabled": true },

05 "image_processor": { "enabled": true }

06}

API

To read the application with the API, send a GET request to it:

Shell

01curl --request GET \

02 --url https://api.azion.com/v4/workspace/applications/<application-id> \

03 --header 'Accept: application/json' \

04 --header 'Authorization: Token [TOKEN VALUE]'

The API answers 200 and returns the application with its modules object. On a new application, cache and functions report "enabled": true, and application_accelerator and image_processor report "enabled": false.

Next steps

Create an application ruleApply a cache setting to one path with a rule, from Azion Console, the Azion CLI, or the API.Create a cache settingDefine how browsers and Azion cache content, then activate the setting with a rule.Create device groupsGroup devices by User-Agent to manage application behaviors and cache policies for each group.Connect an application to an originSet the address and Host header the application uses to retrieve content from your origin.Instantiate a function on an applicationRun a function on the requests of the application through a Run Function rule.Main SettingsThe General, Modules, Debug Rules, and Status sections of an application.