Azion CLI custom-pages
Comandos da Azion CLI que criam, listam, descrevem, atualizam e excluem conjuntos de custom pages, com cada flag, seu tipo e seu padrão.
Os comandos custom-pages da Azion CLI criam, listam, descrevem, atualizam e excluem conjuntos de custom pages, o recurso Custom Pages que substitui as respostas de erro de um workload por páginas servidas a partir de um connector. Esses comandos gerenciam o conjunto e não o atribuem a um workload: quem faz isso é azion create workload-deployment --custom-page. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais da Azion CLI.
Criar
azion create custom-pages cria um conjunto de custom pages a partir de um arquivo JSON. O comando não tem uma flag por campo:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--file | — | string | — | Obrigatório. Caminho de um arquivo JSON com os atributos do conjunto de custom pages. Use - para ler o JSON da entrada padrão. Sem ela, o comando pede o caminho. |
Este arquivo descreve um conjunto ativo chamado my-pages com uma página. Um código de status 404 recebe a página em /404.html no connector com ID 123475:
Passe o arquivo para o comando de criação:
O comando imprime o ID do conjunto:
Listar
azion list custom-pages lista os conjuntos de custom pages da sua conta, 50 por página:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--details | — | — | — | Adiciona as colunas LAST EDITOR e LAST MODIFIED às colunas ID, NAME e ACTIVE. |
--filter | — | string | — | Nome pelo qual a lista é filtrada. |
--order-by | — | string | — | Campo pelo qual a lista é ordenada. |
--page | — | int | 1 | Número da página a retornar. |
--page-size | — | int | 50 | Número de conjuntos em cada página. |
Este comando retorna a primeira página de uma lista dividida em páginas de um conjunto:
O comando imprime uma linha por conjunto:
Descrever
azion describe custom-pages imprime as configurações de um conjunto de custom pages:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--custom-page-id | — | int | — | ID do conjunto de custom pages a descrever. |
Este comando descreve o conjunto com ID 123:
O comando imprime o ID, o nome, a última alteração e o estado do conjunto:
Com --format json, o comando imprime o objeto completo: active, created_at, id, is_versioned, last_editor, last_modified, name, pages, product_version, version, version_id e version_state. Cada entrada de pages contém um code e um objeto page com um type e attributes: connector, custom_status_code, ttl e uri.
Um ID que não existe falha com este erro:
Atualizar
azion update custom-pages altera o nome, o estado ativo ou as páginas de um conjunto de custom pages a partir de um arquivo JSON:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--custom-page-id | — | int | — | ID do conjunto de custom pages a atualizar. |
--file | — | string | — | Obrigatório. Caminho de um arquivo JSON com os atributos a alterar. Use - para ler o JSON da entrada padrão. Sem ela, o comando pede o caminho. |
Este arquivo renomeia o conjunto para my-pages-updated:
Passe o arquivo para o comando de atualização com o ID do conjunto:
O comando imprime o ID do conjunto atualizado:
Os campos que o arquivo deixa de fora mantêm seus valores. Depois desta atualização, o conjunto continua ativo e mantém sua página 404.
Excluir
azion delete custom-pages exclui um conjunto de custom pages:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--custom-page-id | — | int | — | ID do conjunto de custom pages a excluir. |
Este comando exclui o conjunto com ID 123:
O comando confirma a exclusão:
Usar um arquivo JSON
azion create custom-pages e azion update custom-pages leem o conjunto de custom pages de um arquivo JSON com --file. Essa é a única forma de passar seus atributos.
O arquivo traz os campos do conjunto:
nameeactivedescrevem o conjunto.pagescontém uma entrada por código de status. Cada entrada traz o código de status emcode, como uma string, por exemplo"404", e um objetopage.page.typeépage_connector, epage.attributestrazconnector, o ID do connector que serve a página,ttleuri, o caminho da página nesse connector.
Para saber o que cada campo faz e os valores que ele aceita, consulte Configurações de custom page.
Uma página do tipo page_default que traz somente ttl é recusada antes de o conjunto ser criado, embora o arquivo seja um JSON válido:
Na atualização, o arquivo traz somente os campos a alterar, e os campos que ele deixa de fora mantêm seus valores.