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
  2. Consulta dados de uma origem
  3. Deletar uma origem
  4. Criar uma nova origem
  5. Sobrescrever uma origem
  6. Atualizar campos de uma origem

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 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: Token 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

Exemplo de Resposta


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 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: Token 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 origem, consulte a Lista de Origens.
path number

Exemplo de Requisição

Exemplo de Resposta


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: Token 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

Exemplo de Resposta


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: Token 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 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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
   "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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
   "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: Token 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

(obrigratório)

Id da origem a ser sobrescrita.
Para obter o Id de uma Origem, 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 (string): 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.
body json

Exemplo de Requisição

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
   "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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
   "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: Token 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 origem, 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.
body json

Exemplo de Requisição

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
   "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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
{
   "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
}