Como definir uma nova origem para sua aplicação

Este guia explica como configurar uma origem. Uma origem, também conhecida como backend, é o servidor de onde a Azion busca seu conteúdo. As origens podem incluir serviços de armazenamento de objetos, servidores em nuvem ou outras infraestruturas que hospedam os ativos ou dados da sua aplicação.

Existem instruções separadas para API v3 usando as configurações legadas de Origem e API v4 usando o novo produto Edge Connector.

Acesse o Azion Console > Edge Connector.
Clique no botão + Edge Connector.
Na seção General, dê ao seu conector um nome único e descritivo (por exemplo, Meu Edge Storage Connector).
Na seção Connector Type, selecione HTTP.

Na seção Connection Options, no campo Transport Protocol Policy, selecione Force HTTPS.
Na seção Address Management, no campo Address, adicione httpbin.org.
Em Host, adicione customhost.com.
Clique no botão Save.

Para ativar o Edge Connector na sua edge application:

Acesse a aba Rules Engine.
Edite a regra padrão ou adicione uma nova regra de request.
Dê um nome para sua regra.
Selecione Request Phase.
Na seção Criteria, selecione a variável ${uri}.
Como operador de comparação, selecione is equal.
Como argumento, adicione /httpbin.
Na seção Behaviors, selecione Set Edge Connector na lista de comportamentos.
Selecione o novo Edge Connector que você criou.
Clique no botão Save.
Aguarde alguns minutos para que as alterações se propaguem e acesse xxxxxxxxxx.map.azionedge.net/httpbin.

Quando você cria uma edge application, uma origem padrão é criada e ativada automaticamente. Este guia mostra como criar e ativar uma nova origem com diferentes configurações sem remover ou editar a origem padrão.

Acesse o Azion Console > Edge Application.
Clique na edge application para a qual você deseja configurar uma nova origem.
Selecione a aba Origins.
Clique no botão + Origin.
Dê um nome à sua nova origem. Por exemplo: httpbin.org
Em Type, mantenha a opção Single Origin selecionada.

Em Protocol Policy, selecione Enforce HTTPS.
Em Address, adicione httpbin.org.
Em Host Header, adicione customhost.com.
Deixe Path em branco.
Clique no botão Save.

Você criou uma nova origem, mas ela ainda não está ativa em sua aplicação. Você precisa definir o que acionará uma requisição para a nova origem.

Navegue até a aba Rules Engine.
Clique no botão + Rule.
Dê um nome para sua regra.
Selecione Request Phase.
Na seção Criteria, selecione a variável ${uri}.

Como operador de comparação, selecione is equal.
Como argumento, adicione /httpbin.
Na seção Behaviors, selecione Set Origin na lista de comportamentos.
Selecione a nova origem que você criou.
Clique no botão Save.
Aguarde alguns minutos para que as alterações se propaguem e acesse xxxxxxxxxx.map.azionedge.net/httpbin.

Execute a seguinte requisição POST em seu terminal, substituindo [TOKEN VALUE] por seu personal token e a variável <edge_application_id> por seu ID de edge application:

curl --location 'https://api.azionapi.net/edge_applications/<edge_application_id>/origins' --header 'Accept: application/json; version=3' --header 'Content-Type: application/json' --header 'Authorization: Token [TOKEN VALUE]' --data '{
      "name": "httpbin.org SO HTTPS Host:customhost.com",
      "origin_type": "single_origin",
      "addresses": [
          {
              "address": "httpbin.org"
          }
      ],
      "origin_protocol_policy": "https",
      "host_header": "customhost.com"
}'

Chave	Descrição
`name`	Define a string como o nome da origem.
`origin_type`	Define o novo tipo de origem para `single_origin`. Para mais informações sobre balanceamento de carga, confira como configurar múltiplas origens com Load Balancer.
`addresses`	Recebe uma lista de objetos para cada endereço da origem. Como esta é uma entrada do tipo origem única, você pode enviar apenas um objeto com o valor de `address` dentro do array.
`origin_protocol_policy`	Quando `https`, força uma conexão HTTPS com a origem, não afetando o protocolo das requisições do usuário.
`host_header`	Define a string como o valor do cabeçalho `Host` enviado para a origem.

Você receberá uma resposta semelhante a esta:

{
  "results": {
      "origin_id": <origin_id>,
      "origin_key": <origin_key>,
      "name": "httpbin.org SO HTTPS Host:customhost.com",
      "origin_type": "single_origin",
      "addresses": [
          {
              "address": "httpbin.org",
              "weight": null,
              "server_role": "primary",
              "is_active": true
          }
      ],
      "origin_protocol_policy": "https",
      "is_origin_redirection_enabled": false,
      "host_header": "customhost.com",
      "method": "",
      "origin_path": "",
      "connection_timeout": 60,
      "timeout_between_bytes": 120,
      "hmac_authentication": false,
      "hmac_region_name": "",
      "hmac_access_key": "",
      "hmac_secret_key": ""
  }
}

Execute a seguinte requisição POST em seu terminal, substituindo [TOKEN VALUE] por seu personal token, a variável <edge_application_id> por seu ID de edge application, e a variável <origin_id> pelo ID da origem de quando você criou uma nova origem via API:

curl --location 'https://api.azionapi.net/edge_applications/<edge_application_id>/rules_engine/request/rules' --header 'Accept: application/json; version=3' --header 'Content-Type: application/json' --header 'Authorization: Token [TOKEN VALUE]' --data '{
  "name": "Set httpbin /httpbin",
  "behaviors": [
      {
          "name": "set_origin",
          "target": "<origin_id>"
      }
  ],
  "criteria": [
      [
          {
              "variable": "${uri}",
              "operator": "is_equal",
              "conditional": "if",
              "input_value": "/httpbin"
          }
      ]
  ]
}'

Você irá receber uma resposta confirmando que a regra foi criada.
Aguarde alguns minutos para que as alterações se propaguem e acesse xxxxxxxxxx.map.azionedge.net/httpbin. Além disso, tente acessar qualquer outro URI não configurado: você deve receber um erro 404.

Execute a seguinte requisição POST em seu terminal, substituindo [TOKEN VALUE] por seu personal token e a variável <edge_application_id> por seu ID de edge application:

curl --request POST --url https://api.azion.com/v4/edge_connector/connectors --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data '{
  "name": "httpbin.org SO HTTPS Host:customhost.com",
  "active": true,
  "type": "http",
  "attributes": {
    "addresses": [
      {
        "active": true,
        "address": "httpbin.org",
        "http_port": 80,
        "https_port": 443
      }
    ],
    "connection_options": {
      "dns_resolution": "preserve",
      "transport_policy": "force_https",
      "http_version_policy": "http1_1",
      "host": "customhost.com",
      "path_prefix": "",
      "following_redirect": false,
      "real_ip_header": "X-Real-IP",
      "real_port_header": "X-Real-PORT"
    },
    "modules": {
      "load_balancer": {
        "enabled": false,
        "config": {
          "method": "round_robin",
          "max_retries": 0,
          "connection_timeout": 60,
          "read_write_timeout": 120
        }
      },
      "origin_shield": {
        "enabled": false,
        "config": null
      }
    }
  }
}'

Chave	Descrição
`name`	Define a string como o nome da origem.
`type`	Define o novo tipo de edge connector como `http`. Para mais informações sobre balanceamento de carga, confira como configurar múltiplas origens.
`addresses`	Recebe uma lista de objetos para cada endereço da origem. Como esta é uma entrada do tipo origem única, você pode enviar apenas um objeto com o valor de `address` dentro do array.
`transport_policy`	Quando `https`, força uma conexão HTTPS com a origem, não afetando o protocolo das requisições do usuário.
`host`	Define a string como o valor do cabeçalho `Host` enviado para a origem.

Você receberá uma resposta semelhante a esta:

{
"state": "pending",
"data": {
  "id": <edge_connector_id>,
  "name": "httpbin.org SO HTTPS Host:customhost.com",
  "last_editor": "your-email@example.com",
  "last_modified": "2025-08-14T18:12:20.161667Z",
  "active": true,
  "product_version": "1.0",
  "type": "http",
  "attributes": {
    "addresses": [
      {
        "active": true,
        "address": "httpbin.org",
        "http_port": 80,
        "https_port": 443,
        "modules": null
      }
    ],
    "connection_options": {
      "dns_resolution": "preserve",
      "transport_policy": "force_https",
      "http_version_policy": "http1_1",
      "host": "customhost.com",
      "path_prefix": "",
      "following_redirect": false,
      "real_ip_header": "X-Real-IP",
      "real_port_header": "X-Real-PORT"
    },
    "modules": {
      "load_balancer": {
        "enabled": false,
        "config": null
      },
      "origin_shield": {
        "enabled": false,
        "config": null
      }
    }
  }
}
}

Execute a seguinte requisição POST em seu terminal para vincular o novo Edge Connector à sua Edge Application, substituindo [TOKEN VALUE] por seu personal token, a variável <edge_application_id> por seu ID de edge application, e a variável <edge_connector_id> pelo ID do Edge Connector do passo anterior:

curl --request POST --url https://api.azion.com/v4/edge_application/applications/<edge_application_id>/request_rules --header 'Accept: application/json' --header 'Authorization: Token [TOKEN VALUE]' --header 'Content-Type: application/json' --data '{
"name": "string",
"active": true,
"criteria":
  [
    {
      "conditional": "if",
      "variable": "${uri}",
      "operator": "is_equal",
      "argument": "/httpbin"
    }
  ],
"behaviors": [
  {
    "type": "set_edge_connector",
    "attributes": {
      "value": "<edge_connector_id>"
    }
  }
]
}'

Você receberá uma resposta confirmando que a regra foi criada.
Aguarde alguns minutos para que as alterações se propaguem e acesse xxxxxxxxxx.map.azionedge.net/httpbin. Além disso, tente acessar qualquer outro URI não configurado: você deve receber um erro 404.