Origins

Através da API do Content Delivery você pode consultar, remover ou atualizar suas configurações existentes, bem como criar novas configurações de Content Delivery. Para origens, utilize os endpoints que seguem.


1. Consulta lista de origens

Retorna a lista de origens de uma configuração de Content Delivery.

GET /content_delivery/configurations/:conf_id/origins

Permissão necessária: View Security Settings

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization

(obrigatório)
A autenticação por Token previamente criado através do endpoint de Criação de Token.

ex.:

Authorization:
583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
header string
:conf_id

(obrigatório)
Id da configuração de Content Delivery a ser consultada. Para obter o Id de uma configuração, consulte a Lista de Configurações. path number

Exemplo de Requisição

GET /content_delivery/configurations/1492081095/origins
Accept: application/json; version=1
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

Exemplo de Resposta

HTTP/1.1 200 OK
[
   {
      "id": 1545,
      "name": "Default Single Origin",
      "origin_type": "single_origin",
      "method": "",
      "host_header": "www.domain.com",
      "origin_protocol_policy": "preserve",
      "addresses": [
         {
            "address": "single-origin.domain.com",
            "weight": null,
            "server_role": "primary",
            "is_active": true
         }
      ],
      "connection_timeout": 60,
      "timeout_between_bytes": 120
   },
   {
      "id": 1546,
      "name": "Azion Load Balancer",
      "origin_type": "load_balancer",
      "method": "round_robin",
      "host_header": "www.domain.com",
      "origin_protocol_policy": "preserve",
      "addresses": [
         {
            "address": "origin-1.domain.com",
            "weight": 1,
            "server_role": "primary",
            "is_active": true
         },
         {
            "address": "origin-2.domain.com",
            "weight": 1,
            "server_role": "primary",
            "is_active": true
         },
         {
            "address": "origin-3.domain.com",
            "weight": 3,
            "server_role": "primary",
            "is_active": true
         },
         {
            "address": "fallback-origin.domain.com",
            "weight": null,
            "server_role": "backup",
            "is_active": true
         }
      ],
      "connection_timeout": 60,
      "timeout_between_bytes": 120
   },
   {
      "id": 1547,
      "name": "Azion Cloud Storage",
      "origin_type": "single_origin",
      "method": "",
      "host_header": "11368h.st.azioncdn.net",
      "origin_protocol_policy": "preserve",
      "addresses": [
         {
            "address": "11368h.st.azioncdn.net",
            "weight": null,
            "server_role": "primary",
            "is_active": true
         }
      ],
      "connection_timeout": 60,
      "timeout_between_bytes": 120
   },
   {
      "id": 1548,
      "name": "Azion Media Packager",
      "origin_type": "single_origin",
      "method": "",
      "host_header": "21368h.st.azioncdn.net",
      "origin_protocol_policy": "preserve",
      "addresses": [
         {
            "address": "21368h.st.azioncdn.net",
            "weight": null,
            "server_role": "primary",
            "is_active": true
         }
      ],
      "connection_timeout": 60,
      "timeout_between_bytes": 120
   }
]

2. Consulta dados de uma origem

Retorna dados de uma origem de uma configuração de Content Delivery.

GET /content_delivery/configurations/:conf_id/origins/:origin_id

Permissão necessária: View Security Settings

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization

(obrigatório)
A autenticação por Token previamente criado através do endpoint de Criação de Token.

ex.:

Authorization:
583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
header string
:conf_id

(obrigatório)
Id da configuração de Content Delivery a ser consultada. Para obter o Id de uma configuração, consulte a Lista de Configurações. path number
:origin_id

(obrigatório)
Id da origem a ser consultada. Para obter o Id de uma configuração, consulte a Lista de Origens. path number

Exemplo de Requisição

GET /content_delivery/configurations/1492081095/origins/1546
Accept: application/json; version=1
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

Exemplo de Resposta

HTTP/1.1 200 OK
{
    "id": 1546,
    "name": "Azion Load Balancer",
    "origin_type": "load_balancer",
    "method": "round_robin",
    "host_header": "www.domain.com",
    "origin_protocol_policy": "preserve",
    "addresses": [
       {
          "address": "origin-1.domain.com",
          "weight": 1,
          "server_role": "primary",
          "is_active": true
       },
       {
          "address": "origin-2.domain.com",
          "weight": 1,
          "server_role": "primary",
          "is_active": true
       },
       {
          "address": "origin-3.domain.com",
          "weight": 3,
          "server_role": "primary",
          "is_active": true
       },
       {
          "address": "fallback-origin.domain.com",
          "weight": null,
          "server_role": "backup",
          "is_active": true
       }
    ],
    "connection_timeout": 60,
    "timeout_between_bytes": 120
 } 

3. Deletar uma origem

Remove uma Origem de uma configuração de Content Delivery.

DELETE /content_delivery/configurations/:conf_id/origins/:origin_id

Permissão necessária: Edit Content Delivery

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization

(obrigatório)
A autenticação por Token previamente criado através do endpoint de Criação de Token.

ex.:

Authorization:
583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
header string
:conf_id

(obrigatório)
Id da configuração de Content Delivery que possui a origem que será removida. Para obter o Id de uma configuração, consulte a Lista de Configurações. path number
:origin_id

(obrigatório)
Id da Origem a ser removida. Para obter o Id de uma Origem, consulte a Lista de Origens. path number

Exemplo de Requisição

DELETE /content_delivery/configurations/1467640447/origins/1526
Accept: application/json; version=1
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf

Exemplo de Resposta

HTTP/1.1 204 NO CONTENT

4. Criar uma nova origem

Cria uma nova origem em uma configuração de Content Delivery.

POST /content_delivery/configurations/:conf_id/origins

Permissão necessária: Edit Content Delivery

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization

(obrigatório)
A autenticação por Token previamente criado através do endpoint de Criação de Token.

ex.:

Authorization:
583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
header string
Content-Type

(obrigatório)
Id da configuração de Content Delivery para a qual a origem deve ser criada.

ex.:

Content-Type: application/json
header string
:conf_id

(obrigatório)
Id da configuração de Content Delivery para a qual a origem deve ser criada. Para obter o Id de uma configuração, consulte a Lista de Configurações. path number
Configuration

(obrigatório)
A origem que se deseja criar deve ser enviada codificada no formato json com os seguintes campos:

  • name (string): o nome da origem que se quer criar.
  • origin_type (choice): escolha entre single_origin ou load_balancer (requer o produto Azion Load Balancer).
  • method (choice): para uma origem Load Balancer, utilize os valores ip_hash, least_connections ou round_robin. Para single_origin utilize o valor vazio (“”).
  • host_header (string): o cabeçalho Host que será enviado para sua origem.
  • origin_protocol_policy (choice): escolha preserve se desejar que o mesmo scheme (http ou https) de conexão do usuário com o Edge seja utilizado pelo Edge para se conectar em sua origem; http se desejar forçar a conexão com a origem por http, independentemente do scheme utilizado pelo usuário; ou https se desejar forçar a conexão com a origem por https.
  • addresses (array): array de endereços estruturados como segue. Para single_origin, apenas 1 endereço pode ser definido.
    • address (string): hostname (FQDN) ou endereço IP de sua origem.
    • weight (number): peso atribuído a uma origem Load Balancer. Utilize null para single_origin.
    • server_role (choice): escolha entre primary e backup em uma origem Load Balancer. Utilize primary para single_origin.
    • is_active (boolean): utilize true ou false para definir se o endereço está ativo em uma configuração Load Balancer. Utilize true para single_origin.
  • connection_timeout (number): timeout de conexão com a origem (em segundos).
  • timeout_between_bytes (number): timeout em segundos para uma conexão sem transferência de dados.
body json

Exemplo de Requisição

POST /content_delivery/configurations/1473450681/origins
Accept: application/json; version=1
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
Content-Type: application/json
{
    "name": “Another_Origin”,
    "origin_type": "single_origin",
    "host_header": "www.domain.com",
    "origin_protocol_policy": "preserve",
    "addresses": [
       {
          "address": "single-origin.domain.com"
       }
    ],
    "connection_timeout": 60,
    "timeout_between_bytes": 120
} 

Exemplo de Resposta

HTTP/1.1 201 CREATED
{
    "id": 1549,
    "name": "Another_Origin",
    "origin_type": "single_origin",
    "method": "",
    "host_header": "www.domain.com",
    "origin_protocol_policy": "preserve",
    "addresses": [
       {
          "address": "single-origin.domain.com",
          "weight": null,
          "server_role": "primary",
          "is_active": true
       }
    ],
    "connection_timeout": 60,
    "timeout_between_bytes": 120
 } 

5. Sobrescrever uma origem

Sobrescreve todos os campos de uma Origem, preservando o id. Os campos opcionais não informados serão substituídos pelos valores default. Considere utilizar o método PATCH no lugar de PUT, para atualizar somente alguns campos da configuração sem alterar o valor dos demais.

PUT /content_delivery/configurations/ :conf_id /origins/ :origin_id

Permissão necessária: Edit Content Delivery

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization

(obrigatório)
A autenticação por Token previamente criado através do endpoint de Criação de Token.

ex.:

Authorization:
583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
header string
Content-Type

(obrigatório)
O tipo de codificação utilizada no Body (application/json).

ex.:

Content-Type: application/json
header string
:conf_id

(obrigatório)
Id da configuração de Content Delivery para a qual a Origem deve ser substituída. Para obter o Id de uma configuração, consulte a Lista de Configurações. path number
:origin_id

(obrigatório)
Id da origem a ser sobrescrita. Para obter o Id de uma configuração, consulte a Lista de Origens. path number
Configuration

(obrigatório)
Os novos valores de cada campo da configuração. Os campos não preenchidos serão substituídos pelo valor default. Se você desejar alterar apenas um dos campos, utilize o método PATCH ao invés do PUT.

  • name o nome da origem que se quer sobrescrever.
  • origin_type (choice): escolha entre single_origin ou load_balancer (requer o produto Azion Load Balancer).
  • method (choice): para uma origem Load Balancer, utilize os valores ip_hash, least_connections ou round_robin. Para single_origin utilize o valor vazio (“”).
  • host_header (string): o cabeçalho Host que será enviado para sua origem.
  • origin_protocol_policy (choice): escolha preserve se desejar que o mesmo scheme (http ou https) de conexão do usuário com o Edge seja utilizado pelo Edge para se conectar em sua origem; http se desejar forçar a conexão com a origem por http, independentemente do scheme utilizado pelo usuário; ou https se desejar forçar a conexão com a origem por https.
  • addresses (array): array de endereços estruturados como segue. Para single_origin, apenas 1 endereço pode ser definido.
    • address (string): hostname (FQDN) ou endereço IP de sua origem.
    • weight (number): peso atribuído a uma origem Load Balancer. Utilize null para single_origin.
    • server_role (choice): escolha entre primary e backup em uma origem Load Balancer. Utilize primary para single_origin.
    • is_active (boolean): utilize true ou false para definir se o endereço está ativo em uma configuração Load Balancer. Utilize true para single_origin.
  • connection_timeout (number): timeout de conexão com a origem (em segundos).
  • timeout_between_bytes (number): timeout em segundos para uma conexão sem transferência de dados.
path number

Exemplo de Requisição

PUT /content_delivery/configurations/1492081095/origins/1549
Accept: application/json; version=1
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
Content-Type: application/json
{
    "name": "Another_Origin",
    "origin_type": "single_origin",
    "host_header": "www.domain.com",
    "origin_protocol_policy": "http",
    "addresses": [
       {
          "address": "single-origin.domain.com:8080"
       }
    ],
    "connection_timeout": 60,
    "timeout_between_bytes": 120
 } 

Exemplo de Resposta

HTTP/1.1 200 OK
{
    "id": 1549,
    "name": "Another_Origin",
    "origin_type": "single_origin",
    "method": "",
    "host_header": "www.domain.com",
    "origin_protocol_policy": "http",
    "addresses": [
       {
          "address": "single-origin.domain.com:8080",
          "weight": null,
          "server_role": "primary",
          "is_active": true
       }
    ],
    "connection_timeout": 60,
    "timeout_between_bytes": 120
} 

6. Atualizar campos de uma origem

Atualiza um ou mais campos de uma Origem de uma configuração de Content Delivery, preservando o valor dos campos não informados.

PATCH /content_delivery/configurations/:conf_id/origins/:origin_id

Permissão necessária: Edit Content Delivery

Parâmetro Descrição Tipo de Parâmetro Tipo de Dado
Authorization

(obrigatório)
A autenticação por Token previamente criado através do endpoint de Criação de Token.

ex.:

Authorization:
583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
header string
Content-Type

(obrigatório)
O tipo de codificação utilizada no Body (application/json).

ex.:

Content-Type: application/json
header string
:conf_id

(obrigatório)
Id da configuração de Content Delivery para a qual a origem deve ser atualizada. Para obter o Id de uma configuração, consulte a Lista de Configurações. path number
:origin_id

(obrigatório)
Id da origem a ser atualizada. Para obter o Id de uma configuração, consulte a Lista de Origens. path number
Configuration

(obrigatório)
Devem ser informados um ou mais campos a serem atualizados. Os campos não informados não terão o seu valor alterado.

  • name (string): o nome da origem que se quer atualizar.
  • origin_type (choice): escolha entre single_origin ou load_balancer (requer o produto Azion Load Balancer).
  • method (choice): para uma origem Load Balancer, utilize os valores ip_hash, least_connections ou round_robin. Para single_origin utilize o valor vazio (“”).
  • host_header (string): o cabeçalho Host que será enviado para sua origem.
  • origin_protocol_policy (choice): escolha preserve se desejar que o mesmo scheme (http ou https) de conexão do usuário com o Edge seja utilizado pelo Edge para se conectar em sua origem; http se desejar forçar a conexão com a origem por http, independentemente do scheme utilizado pelo usuário; ou https se desejar forçar a conexão com a origem por https.
  • addresses (array): array de endereços estruturados como segue. Para single_origin, apenas 1 endereço pode ser definido.
    • address (string): hostname (FQDN) ou endereço IP de sua origem.
    • weight (number): peso atribuído a uma origem Load Balancer. Utilize null para single_origin.
    • server_role (choice): escolha entre primary e backup em uma origem Load Balancer. Utilize primary para single_origin.
    • is_active (boolean): utilize true ou false para definir se o endereço está ativo em uma configuração Load Balancer. Utilize true para single_origin.
  • connection_timeout (number): timeout de conexão com a origem (em segundos).
  • timeout_between_bytes (number): timeout em segundos para uma conexão sem transferência de dados.
path number

Exemplo de Requisição

PATCH /content_delivery/configurations/1492081095/origins/1546
Accept: application/json; version=1
Authorization: Token 583f8a9ca8d6d5ff2cb50f1d3c4d35cb8939f1bf
Content-Type: application/json
{
    "addressess": [
       {
          "address": "origin-1.domain.com",
          "weight": 1,
          "server_role": "primary",
          "is_active": false
       },
       {
          "address": "origin-2.domain.com",
          "weight": 1,
          "server_role": "primary",
          "is_active": true
       },
       {
          "address": "origin-3.domain.com",
          "weight": 3,
          "server_role": "primary",
          "is_active": true
       },
       {
          "address": "fallback-origin.domain.com",
          "weight": null,
          "server_role": "backup",
          "is_active":true
       }
    ]
 } 

Exemplo de Resposta

HTTP/1.1 200 OK
{
    "id": 1546,
    "name": "Azion Load Balancer",
    "origin_type": "load_balancer",
    "method": "round_robin",
    "host_header": "www.domain.com",
    "origin_protocol_policy": "preserve",
    "addresses": [
       {
          "address": "origin-1.domain.com",
          "weight": 1,
          "server_role": "primary",
          "is_active": true
       },
       {
          "address": "origin-2.domain.com",
          "weight": 1,
          "server_role": "primary",
          "is_active": true
       },
       {
          "address": "origin-3.domain.com",
          "weight": 3,
          "server_role": "primary",
          "is_active": true
       },
       {
          "address": "fallback-origin.domain.com",
          "weight": null,
          "server_role": "backup",
          "is_active": true
       }
    ],
    "connection_timeout": 60,
    "timeout_between_bytes": 120
 } 

Não encontrou o que procurava? Abra um ticket.