Azion CLI device-group
Comandos da Azion CLI que criam, listam, descrevem, atualizam e excluem os device groups de uma aplicação, com cada flag e seu tipo.
Os comandos device-group da Azion CLI criam, listam, descrevem, atualizam e excluem device groups, os nomes e as expressões regulares que uma aplicação compara com o header User-Agent de cada requisição. Um device group pertence a uma aplicação, então todo comando recebe o --application-id dessa aplicação. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais.
Criar
azion create device-group cria um device group em uma aplicação, com o nome e a expressão regular que você passa:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--application-id | — | int | — | ID da aplicação que guarda o device group. |
--file | — | string | — | Caminho de um arquivo JSON com os atributos do device group. Use - para ler o JSON da entrada padrão. |
--name | — | string | — | Nome do device group. Aceita apenas letras e dígitos. |
--user-agent | — | string | — | Obrigatório, a menos que --file seja definido. Expressão regular a comparar com o header User-Agent de cada requisição. Sem ela, o comando pergunta a expressão. |
O comando precisa de Application Accelerator ativado na aplicação. Enquanto ele está desativado, o comando falha com este erro:
Este comando ativa Application Accelerator na aplicação com ID 1234567890. A flag --application-accelerator está em Azion CLI application:
O comando imprime o ID da aplicação atualizada:
Um nome com hífen ou underscore é recusado com este erro:
Este comando cria um device group chamado mobile que corresponde a dispositivos Android e a dispositivos cujo header contém Mobile:
O comando imprime o ID do device group:
Listar
azion list device-group lista os device groups de uma aplicação, 50 por página:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--application-id | — | int | — | ID da aplicação cujos device groups você lista. |
--details | — | — | — | É aceita, mas não adiciona colunas: a lista mantém as colunas ID, NAME e USER AGENT. |
--filter | — | string | — | Nome pelo qual filtrar a lista. |
--order-by | — | string | — | Campo pelo qual ordenar a lista. |
--page | — | int | 1 | Número da página a retornar. |
--page-size | — | int | 50 | Número de device groups em cada página. |
Este comando lista os device groups da aplicação com ID 1234567890:
O comando imprime uma linha por device group:
Descrever
azion describe device-group imprime as configurações de um device group:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--application-id | — | int | — | Obrigatório. ID da aplicação que guarda o device group. |
--group-id | — | int | — | Obrigatório. ID do device group a descrever. |
Este comando descreve o device group com ID 1238:
O comando imprime o ID, o nome e a expressão regular do device group:
Com --format json, o comando imprime o objeto completo: created_at, id, name e user_agent.
Atualizar
azion update device-group altera o nome ou a expressão regular de um device group:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--application-id | — | int | — | Obrigatório. ID da aplicação que guarda o device group. |
--file | — | string | — | Caminho de um arquivo JSON com os atributos a alterar. Use - para ler o JSON da entrada padrão. |
--group-id | — | int | — | Obrigatório. ID do device group a atualizar. |
--name | — | string | — | Novo nome do device group. |
--user-agent | — | string | — | Nova expressão regular a comparar com o header User-Agent. |
Este comando adiciona dispositivos iPhone à expressão regular do device group com ID 1238:
O comando imprime o ID do device group atualizado:
Excluir
azion delete device-group exclui um device group de uma aplicação:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--application-id | — | int | — | Obrigatório. ID da aplicação que guarda o device group. |
--group-id | — | int | — | Obrigatório. ID do device group a excluir. |
Este comando exclui o device group com ID 1239:
O comando confirma a exclusão:
Usar um arquivo JSON
azion create device-group e azion update device-group leem os atributos do device group de um arquivo JSON com --file. O arquivo traz name e user_agent.
Este arquivo cria um device group chamado tablet que corresponde a dispositivos iPad e tablet:
Passe o arquivo para o comando de criação com o ID da aplicação:
O comando imprime o ID do device group:
Este arquivo renomeia um device group para tabletupdated:
Passe o arquivo para o comando de atualização com os IDs da aplicação e do device group:
O comando imprime o ID do device group atualizado:
Um campo que o arquivo omite mantém o seu valor. Depois dessa atualização, o device group com ID 1239 ainda tem (iPad|Tablet) como user_agent.