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.

  1. Consulta lista de configurações
  2. Consulta dados de uma configuração
  3. Deletar uma configuração
  4. Criar uma nova configuração
  5. Sobrescrever uma configuração
  6. Atualizar campos de uma configuração

1. Consulta lista de configurações

Retorna a lista de configurações de Content Delivery.

GET /content_delivery/configurations

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

Exemplo de Requisição

Exemplo de Resposta


2. Consulta dados de uma configuração

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

GET /content_delivery/configurations/:conf_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

Exemplo de Requisição

Exemplo de Resposta


3. Deletar uma configuração

Remove uma configuração de Content Delivery.

DELETE /content_delivery/configurations/:conf_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 a ser removida.
Para obter o Id de uma configuração, consulte a Lista de Configurações.
path number

Exemplo de Requisição

Exemplo de Resposta


4. Criar uma nova configuração

Cria uma nova configuração de Content Delivery.

POST /content_delivery/configurations

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
Configuration

(obrigatório)

A Configuration que se deseja criar deve ser enviada codificada no formato json com os seguintes campos :

  • name (string): o nome da configuração que se quer criar.
  • origin_address (string): endereço da Origem para o Content Delivery. Pode ser utilizado endereço IP ou Hostname (FQDN) da Origem.
  • origin_host_header (string): o cabeçalho Host que será enviado para sua origem.
  • cname (array of strings): a lista de domínios do site (cnames). O valor default é vazio.
  • cname_access_only (boolean): define se a entrega do conteúdo deve ser realizada apenas pelos domínios listados no campo “cname” ou se o domínio da azion (azioncdn.net) também será utilizado. O valor default é false.
  • delivery_protocol (string): use o valor “http” caso o conteúdo seja entregue apenas por http; ou use “http,https” caso o conteúdo possa ser entregue tanto por http quanto por https. O valor default é “http“.
  • digital_certificate (number): o id do certificado SSL, previamente cadastrado na plataforma como Custom Certificate, que deve ser utilizado em caso de entrega através de https. O valor default é null, representando que o certificado SSL compartilhado da Azion será utilizado.
  • origin_protocol_policy (string): use o valor “preserve” para definir que a conexão com a origem deve respeitar o scheme (http ou https) utilizado pelo usuário para acessar a CDN; use “http” para forçar que a conexão com a origem seja por http, independente do scheme utilizado pelo usuário; ou use “https” para forçar que a conexão com a origem seja por https, independente do scheme utilizado pelo usuário. O valor default é  “preserve“.
  • browser_cache_settings (boolean): use o valor false para definir que o browser do usuário deverá respeitar os cabeçalhos de cache enviados pela origem; ou use true para definir um valor customizado de browser_cache_settings_maximum_ttl. O valor default é false.
  • browser_cache_settings_maximum_ttl (number): utilizado em conjunto com browser_cache_settings em true, este valor define o TTL (time-to-live), em segundos, para os objetos permanecerem em browser cache. O valor default é 0.
  • cdn_cache_settings (string): use o valor “honor” para definir que a CDN deverá respeitar os cabeçalhos de cache enviados pela origem; use  “override” para definir um valor customizado de cdn_cache_settings_maximum_ttl; ou use “bypass” (requer o produto Application Acceleration), caso deseje que as requisições ignorem o cache. O valor default é “honor“.
  • cdn_cache_settings_maximum_ttl (number): utilizado em conjunto com cdn_cache_settings em “override“, este valor define o TTL, em segundos, para os objetos permanecerem em cache na CDN. O valor default  é 0.
body json

Exemplo de Requisição

1
2
3
4
5
6
7
8
9
{
   "name": "Your Site Name",
   "origin_address": "yourorigin.com",
   "cname": ["www.yoursite.com"],
   "delivery_protocol": "http",
   "cdn_cache_settings": "override",
   "cdn_cache_settings_maximum_ttl": 2592000
}
 

Exemplo de Resposta

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
   "active" : true,
  "id" : 1487160529,
   "cname" : [
      "www.yoursite.com"
   ],
   "digital_certificate" : null,
   "rawlogs" : false,
   "delivery_protocol" : "http",
   "cname_access_only" : false,
   "name" : "Your Site Name",
   "domain_name": "41368h.ha.azioncdn.net"
}
 


5. Sobrescrever uma configuração

Sobreescreve todos os campos de uma configuração de Content Delivery, preservando o id. Os campos 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

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 a ser substituída.
Para obter o Id de uma configuração, consulte a Lista de Configurações.
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 novo nome da configuração.
  • cname (array of strings): a lista de domínio do site (cnames). O valor default é vazio.
  • cname_access_only (boolean): define se a entrega do conteúdo deve ser realizada apenas pelos domínios listados no campo “cname” ou se o domínio da azion (azioncdn.net) também será utilizado. O valor default é false.
  • delivery_protocol (string): use o valor “http” caso o conteúdo seja entregue apenas por http; ou use “http,https” caso o conteúdo possa ser entregue tanto por http quanto por https. O valor default é “http“.
  • digital_certificate (number): o id do certificado SSL, previamente cadastrado na plataforma como Custom Certificate, que deve ser utilizado em caso de entrega através de https. O valor default é null, representando que o certificado SSL compartilhado da Azion será utilizado.
  • rawlogs (boolean): define se a configuração deverá gravar logs no Cloud Storage, para clientes que possuem o produto Rawlogs. O valor default é false.
  • active (boolean): define se a configuração está ativa. O valor default é true.
body json

Exemplo de Requisição

1
2
3
4
5
6
{
   "name": "Alternate Name",
   "cname": ["www.yoursite.com"],
   "delivery_protocol": "http",
}
 

Exemplo de Resposta

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
   "active" : true,
  "id" : 1487160529,
   "cname" : [
      "www.yoursite.com"
   ],
   "digital_certificate" : null,
   "rawlogs" : false,
   "delivery_protocol" : "http",
   "cname_access_only" : false,
   "name" : "Alternate Name",
   "domain_name": "41368h.ha.azioncdn.net"
}
 


6. Atualizar campos de uma configuração

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

PATCH /content_delivery/configurations/:conf_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 a ser atualizada.
Para obter o Id de uma configuração, consulte a Lista de Configurações.
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 novo nome da configuração.
  • cname (array of strings): a lista de domínio do site (cnames).
  • cname_access_only (boolean): define se a entrega do conteúdo deve ser realizada apenas pelos domínios listados no campo “cname” ou se o domínio da azion (azioncdn.net) também será utilizado.
  • delivery_protocol (string): use o valor “http” caso o conteúdo seja entregue apenas por http; ou use “http,https” caso o conteúdo possa ser entregue tanto por http quanto por https.
  • digital_certificate (number): o id do certificado SSL, previamente cadastrado na plataforma como Custom Certificate, que deve ser utilizado em caso de entrega através de https. O valor null representa o certificado SSL compartilhado da Azion.
  • rawlogs (boolean): define se a configuração deverá gravar logs no Cloud Storage, para clientes que possuem o produto Rawlogs.
  • active (boolean): define se a configuração está ativa.
body json

Exemplo de Requisição

1
2
3
4
{
   "cname": ["www.yoursite1.com", "www.yoursite2.com"],
}
 

Exemplo de Resposta

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
   "active" : true,
  "id" : 1487160529,
   "cname" : [
      "www.yoursite1.com",
      "www.yoursite2.com"
   ],
   "digital_certificate" : null,
   "rawlogs" : false,
   "delivery_protocol" : "http",
   "cname_access_only" : false,
   "name" : "Your Site Name",
   "domain_name": "41368h.ha.azioncdn.net"
}