Comando cache settings e seus subcomandos
Conheça os comandos e subcomandos que possibilitam o gerenciamento de Cache Settings na Plataforma Azion usando a Azion CLI.
1. Listando suas configurações de cache
Lista as configurações de cache configuradas em uma edge application.
Uso
$ azioncli cache-settings --application-id 123455555
Flags obrigatórias
application-id
A flag
–application-id fornece o ID da edge application e, com base nisso, as configurações de cache relacionadas à ela são listadas.
Flags opcionais
details
A opção --details
exibe todos os campos relevantes ao listar.
filter
A opção --filter
filtra os itens por nome.
order_by
A opção --order_by
ordena a saída com base no campo informado.
page
A opção --page
retorna uma página da lista com base no campo selecionado.
page_size
A opção --page_size
define quantos itens devem ser listados por página. Por padrão, são 10
.
sort
A opção --sort
define a ordem dos itens na lista. O valor deve ser asc
ou desc
.
help
A opção --help
exibe mais informações sobre o subcomando list
.
2. Criando configurações de cache
Cria uma configuração de cache, com base em atributos informados, que será usada com edge applications.
Uso
$ azioncli cache_settings create --name cachesettingsname --application-id 00000000001
Flags obrigatórias
name
A flag --name
fornece o nome da configuração de cache.
application-id
A flag --application-id
fornece o ID para a edge application relacionada a essa configuração de cache.
Flags opcionais
help
A opção --help
exibe mais informações sobre o subcomando create
.
adaptive-delivery-action
A opção --adaptive-delivery-action
informa a ação de adaptive delivery da configuração de cache. Por padrão, é definido como ignore
.
browser-cache-settings
A opção --browser-cache-settings
configura a quantidade de tempo que o conteúdo é armazenado em cache no navegador.
browser-cache-settings-maximum-ttl
A opção --browser-cache-settings-maximum-ttl
informa o TTL máximo da configuração de cache do navegador.
cache-by-cookies
A opção --cache-by-cookies
define se o cache por cookies está ativo ou não. Por padrão, é definido como ignore
.
cache-by-query-string
A opção --cache-by-query-string
define como você deseja que o conteúdo seja armazenado em cache de acordo com as variações da Query String em suas URLs. Por padrão, é definido como ignore
.
cdn-cache-settings
A opção --cdn-cache-settings
configura a quantidade de tempo que as edge applications levam para armazenar em cache o conteúdo. Podendo ser tanto Honor Origin Cache Headers
quanto Override Cache Settings
. Por padrão, é honor
.
cdn-cache-settings-maximum-ttl
A opção --browser-cache-settings-maximum-ttl
informa o TTL máximo da configuração de cache do navegador. Por padrão, é 60
.
cookie-names
A opção --cookie-names
distingue objetos no cache da Azion por nome/valor de cookies.
enable-caching-for-options
A opção --enable-caching-for-options
informa se o caching for options está ativo ou não. Por padrão, é false
.
enable-caching-for-post
A opção --enable-caching-for-options
informa se o caching for options está ativo ou não.
enable-caching-string-sort
A opção --enable-caching-string-sort
informa se o caching string sort está ativo ou não.
in
A opção --in
informa o caminho para um arquivo JSON contendo todos os atributos da configuração de cache que será criada.
Observação: se as flags
--in
e--application-id
forem fornecidas, todas as informações serão acessadas pelo caminho do arquivo que foi passado pela flag, portanto, as outras flags não serão necessárias.
l2-caching-enabled
A opção --l2-caching-enabled
informa se o cache L2 está ativo ou não.
query-string-fields
A opção --query-string-fields
fornece uma lista de query strings parameters a serem considerados na configuração Cache Settings que irá segregar o cache para a mesma URL.
slice-configuration-enabled
A opção --slice-configuration-enabled
informa se a configuração de slice está ativa ou não.
slice-configuration-range
A opção --slice-configuration-range
fornece o range da configuração do slice.
slice-l2-caching-enabled
A opção --slice-configuration-enabled
informa se a configuração de slice está ativa ou não.
3. Atualizando as configurações de cache
Atualiza uma configuração de cache com base no ID informado e nos atributos fornecidos.
Uso
$ azioncli cache_settings update --application-id 1673635839 --cache-settings-id 115247 --name "cachesettingstest"
Flags obrigatórias
application-id
A flag --application-id
informa o ID da edge application relacionada à configuração de cache.
cache-settings-id
A flag --cache-settings-id
informa o identificador único de uma configuração de cache.
Flags opcionais
help
A opção --help
exibe mais informações sobre o subcomando update
.
name
A flag --name
fornece o nome da configuração de cache.
adaptive-delivery-action
A opção --adaptive-delivery-action
informa a ação de adaptive delivery da configuração de cache. Por padrão, é definido como ignore
.
browser-cache-settings
A opção --browser-cache-settings
configura a quantidade de tempo que o conteúdo é armazenado em cache no navegador.
browser-cache-settings-maximum-ttl
A opção --browser-cache-settings-maximum-ttl
informa o TTL máximo da configuração de cache do navegador.
cache-by-cookies
A opção --cache-by-cookies
define se o cache por cookies está ativo ou não. Por padrão, é definido como ignore
.
cache-by-query-string
A opção --cache-by-query-string
define como você deseja que o conteúdo seja armazenado em cache de acordo com as variações da Query String em suas URLs. Por padrão, é definido como ignore
.
cdn-cache-settings
A opção --cdn-cache-settings
configura a quantidade de tempo que as edge applications levam para armazenar em cache o conteúdo. Podendo ser tanto Honor Origin Cache Headers
quanto Override Cache Settings
. Por padrão, é honor
.
cdn-cache-settings-maximum-ttl
A opção --cdn-cache-settings-maximum-ttl
informa o TTL máximo da configuração de cache do navegador. Por padrão, é 60
.
cookie-names
A opção --cookie-names
distingue objetos no cache da Azion por nome/valor de cookies.
enable-caching-for-options
A opção --enable-caching-for-options
informa se o caching for options está ativo ou não. Por padrão, é false
.
enable-caching-for-post
A opção --enable-caching-for-post
informa se o caching for post está ativo ou não.
enable-caching-string-sort
A opção --enable-caching-string-sort
informa se o caching string sort está ativo ou não.
in
A opção --in
informa o caminho para um arquivo JSON contendo todos os atributos da configuração de cache que será alterada.
Observação: se as flags
--in
e--application-id
forem fornecidas, todas as informações serão acessadas pelo caminho do arquivo que foi passado pela flag--in
, portanto, as outras flags não serão necessárias.
l2-caching-enabled
A opção --l2-caching-enabled
informa se o cache L2 está ativo ou não.
query-string-fields
A opção --query-string-fields
fornece uma lista de query strings parameters a serem considerados na configuração de cache que irá segregar o cache para a mesma URL.
slice-configuration-enabled
A opção --slice-configuration-enabled
informa se a configuração de slice está ativa ou não.
slice-configuration-range
A opção --slice-configuration-range
fornece o range da configuração do slice.
slice-l2-caching-enabled
A opção --slice-l2-caching-enabled
informa se a configuração de slice está ativa ou não.
4. Descrevendo uma configuração de cache
Retorna detalhes sobre uma configuração de cache específica, com base em um determinado ID.
Uso
$ azioncli cache_settings describe --application-id 1673635839 --cache-settings-id 107313
Flags obrigatórias
application-id
A flag --application-id
informa o ID da edge application relacionada à configuração de cache.
cache-settings-id
A flag --cache-settings-id
informa o identificador único de uma configuração de cache.
Flags opcionais
out
A opção --out
exporta a saída do comando describe
para um determinado caminho de arquivo.
format
A opção --format
, seguida pelo valor json
, altera o formato de saída para JSON.
help
A opção --help
exibe mais informações sobre o subcomando describe
.
5. Excluindo uma configuração de cache
Exclui uma configuração de cache na plataforma da Azion.
Uso
$ azioncli cache_settings delete --application-id 0000092 --cache-settings-id 0029
Flags obrigatórias
application-id
A flag --application-id
informa o ID da edge application relacionada à configuração de cache.
cache-settings-id
A flag --cache-settings-id
informa o identificador único de uma configuração de cache.
Flags opcionais
help
A opção --help
exibe mais informações sobre o subcomando delete
.
Leia também
- Comando edge applications e seus subcomandos
- Comando edge functions e seus subcomandos
- Gerenciando suas edge functions utilizando a Azion CLI
- Como criar uma edge application usando a Azion CLI
Não encontrou o que procurava? Abra um ticket.