Azion CLI personal-token
Comandos da Azion CLI que criam, listam, descrevem e excluem personal tokens, com cada flag, seu tipo e seu padrão.
Os comandos personal-token da Azion CLI criam, listam, descrevem e excluem os seus personal tokens, as credenciais que autenticam as suas chamadas à Azion API e os seus comandos da CLI. Cada token tem um UUID, que a flag --id recebe. As opções que todo comando aceita, como --format, --out e -y, estão em Opções globais.
Criar
azion create personal-token cria um personal token com o nome, a expiração e a descrição que você passa:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--description | — | string | — | Descrição do personal token. |
--expiration | — | string | — | Obrigatório, a menos que --file seja definido. Tempo até o token expirar: um número seguido de d para dias ou de m para meses, como 1d ou 9m. Sem ele, o comando pergunta a expiração. |
--file | — | string | — | Caminho de um arquivo JSON com os atributos do personal token. Use - para ler o JSON da entrada padrão. |
--name | — | string | — | Nome do personal token. |
Em --expiration, m significa meses, e não minutos: 9m cria um token que expira nove meses depois. Um valor sem número, como tomorrow, é recusado com Error: expected integer.
Este comando cria um token chamado my-token que expira no dia seguinte:
O comando imprime o valor do token. Nenhum outro comando personal-token o imprime, então guarde o valor ao criar o token:
Listar
azion list personal-token lista os seus personal tokens. A lista exibe o UUID, o nome e a expiração de cada token, nunca o valor dele:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--details | — | — | — | Adiciona as colunas CREATED AT e DESCRIPTION às colunas ID, NAME e EXPIRES AT. |
Este comando lista os personal tokens do usuário:
O comando imprime uma linha por token. Um token que passou da expiração continua na lista até você excluí-lo, como old-token abaixo:
Descrever
azion describe personal-token imprime os atributos de um personal token, sem o valor dele:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--id | — | string | — | UUID do personal token a descrever. |
Este comando descreve o token com UUID 11111111-2222-4333-8444-555555555555:
O comando imprime o UUID, o nome, as datas e a descrição do token:
Com --format json, o comando imprime os mesmos atributos nas chaves created, description, expires_at, name e uuid.
Um UUID que não corresponde a nenhum token do usuário falha com este erro:
Excluir
azion delete personal-token exclui um personal token:
| Flag | Curta | Tipo | Padrão | Descrição |
|---|---|---|---|---|
--id | — | string | — | Obrigatório. UUID do personal token a excluir. Sem ele, o comando pergunta o UUID. |
Este comando exclui o token com UUID 11111111-2222-4333-8444-555555555555:
O comando confirma a exclusão:
Um UUID que não corresponde a nenhum token, como o UUID de um token que você já excluiu, falha com este erro:
Usar um arquivo JSON
azion create personal-token lê os atributos do token de um arquivo JSON com --file. O comando lê name, expires_at e description, e expires_at aceita os mesmos valores que --expiration.
Este arquivo cria um token chamado my-file-token que expira nove meses depois de ser criado:
Passe o arquivo para o comando de criação:
O comando imprime o valor do token: