How to configure a domain

To create a Workload:

1. Access Azion Console > Workloads.
2. Click the + Workload button.
3. Give your Workload a name.
4. Select the Infrastructure for your Workload: Production Infrastructure or Staging Infrastructure (test environment).
5. Define your application hostnames in the Subdomain and Domain fields. You can use custom domain addresses to link to your application.
6. In Edge Application, select your Edge Application.
7. In Edge Firewall, select your Edge Firewall.
8. In Digital Certificate, select, create a new, or use the Azion SAN certificate if you’re aiming to use the Azion Custom Domain or the Workload Domain.
9. Click the Save button.

Wait a few minutes for your new Workload to propagate and access your xxxxxxxxxx.map.azionedge.net address to see your Edge Application online.

1. Access Azion Console > Domains.
2. Click the + Domain button.
3. Give your domain a name.
4. Select the Environment Type for your domain: Global Edge Network (production environment) or Staging Network (test environment).
5. In Edge Application, select your edge application.
6. In Edge Firewall, select your edge firewall.
7. Disable the CNAME access only switch. This’ll enable users to access your application using the xxxxxxxxxx.map.azionedge.net address.
8. In the CNAME field, you may list custom domain addresses to link to your application.
9. In Digital Certificate, select the Azion SAN certificate.
10. Click the Save button.

Wait a few minutes for your new domain to propagate to the edge nodes and access your xxxxxxxxxx.map.azionedge.net address to see your edge application online.

1. Run the following POST request in your terminal, replacing [TOKEN VALUE] with your personal token, the <edge_application_id> variable with the ID of your edge application:

curl --location 'https://api.azionapi.net/domains' --header 'Accept: application/json; version=3' --header 'Authorization: Token [TOKEN VALUE]'--header 'Content-Type: application/json' --data '{
  "name": "Example CN0 DC0",
  "cname_access_only": false,
  "digital_certificate_id": null,
  "edge_application_id": <edge_application_id>
}'

2. You’ll receive a response similar to:

{
    "results": {
        "id": <domain_id>,
        "name": "Example CN0 DC0",
        "cnames": [],
        "cname_access_only": false,
        "digital_certificate_id": null,
        "edge_application_id": <edge_application_id>,
        "is_active": true,
        "domain_name": "xxxxxxxxxx.map.azionedge.net",
        "is_mtls_enabled": false,
        "mtls_verification": "enforce",
        "mtls_trusted_ca_certificate_id": null
    }
}

3. The domain_name received in the response carries your application’s Azion domain address as a string. Wait a few minutes for the changes to propagate and paste its value without the double quotes (") in your browser to access your application.

1. Run the following POST request in your terminal, replacing [TOKEN VALUE] with your personal token to create a new Workload.

curl --request POST --url https://api.azion.com/v4/workspace/workloads --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data '{
"name": "Example CN0 DC0",
"active": true,
"infrastructure": 1,
"protocols": {
  "http": {
    "versions": [
      "http1",
      "http2"
    ]
  }
},
"workload_domain_allow_access": true
}
}

2. You’ll receive a response similar to:

{
"state": "pending",
"data": {
  "id": <workload_id>,
  "name": "Example CN0 DC0",
  "active": true,
  "last_editor": "your-email@example.com",
  "last_modified": "2025-07-25T18:58:25.817955Z",
  "infrastructure": 1,
  "tls": {
    "certificate": null,
    "ciphers": 7,
    "minimum_version": "tls_1_3"
  },
  "protocols": {
    "http": {
      "versions": [
        "http1",
        "http2"
      ],
      "http_ports": [
        80
      ],
      "https_ports": [
        443
      ],
      "quic_ports": null
    }
  },
  "mtls": {
    "verification": null,
    "certificate": null,
    "crl": null
  },
  "domains": [],
  "workload_domain_allow_access": true,
  "workload_domain": "xxxxxxxxxxx.azionedge.net",
  "product_version": "1.0"
}
}

3. Copy the URL in the workload_domain value and paste it in a text editing app to access later.

4. Now you must bind the created Workload to an Edge Application. This is done by creating a Workload Deployment. Run the following POST request in your terminal, replacing [TOKEN VALUE] with your personal token, <edge_application_id> with the ID of the desired Edge Application and <workload_id> with the ID of the Workload you created on the previous step.

curl --request POST --url https://api.azion.com/v4/workspace/workloads/<workload_id>/deployments --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data '{
  "name": "My Workload Deployment",
  "current": true,
  "active": true,
  "strategy": {
    "type": "default",
    "attributes": {
      "edge_application": <edge_application_id>
    }
  }
}'
}

5. The workload_domain received in the response carries your application’s Azion domain address as a string. Wait a few minutes for the changes to propagate and paste its value without the double quotes (") in your browser to access your application.