--- name: azion-gerencie-personal-tokens description: >- Crie e exclua personal tokens pelo Azion Console ou com a Azion CLI, e guarde o valor do token no momento em que o cria. --- # Gerencie personal tokens Você pode criar e excluir um [personal token](/pt-br/documentacao/fundamentos/personal-tokens/) pelo Azion Console ou com a [Azion CLI](/pt-br/documentacao/devtools/cli/). Um personal token autentica as suas requisições à [Azion API](/pt-br/documentacao/devtools/api/) e os comandos que você executa na CLI. Para revogar um token, exclua-o. --- Selecione a interface que você usa. Os pré-requisitos e cada procedimento desta página seguem essa escolha. ## Pré-requisitos - Uma conta Azion. Para criar uma, consulte [Criar uma conta](/pt-br/documentacao/fundamentos/criar-uma-conta/). **Console** - Acesso ao Azion Console. Para fazer login, consulte [Como acessar o Azion Console](/pt-br/documentacao/guias/plataforma/conta-e-billing/como-acessar-o-azion-console/). **CLI** - A Azion CLI instalada e autenticada na sua conta. Para configurá-la, consulte [Primeiros passos com a Azion CLI](/pt-br/documentacao/devtools/cli/primeiros-passos/). --- ## Crie um personal token Cada personal token tem um nome, uma descrição opcional e uma expiração. A Azion exibe o valor do token somente quando o token é criado, então guarde-o antes de continuar. **Console** Para criar um personal token no Azion Console: 1. **Abra a página Personal Tokens** Acesse [Azion Console](https://console.azion.com/) > **Account** > **Personal Token**. **Account** é o menu do avatar. 2. **Selecione + Personal Token** 3. **Dê um nome ao token** Na seção **General**, insira um **Name** que identifique o token. 4. **(Opcional) Descreva o token** Em **Description**, insira a finalidade do token. 5. **Defina a expiração** Na seção **Token**, selecione um valor em **Expires within**. O padrão é *1 day*. Os outros valores são: - *7 days*, *15 days*, *30 days* ou *90 days* - *1 year* - *Custom Date*, que abre um calendário para selecionar a data 6. **Selecione Save** 7. **Copie o token** Na caixa de diálogo **Personal Token has been created**, selecione **Copy**. O campo **Personal Token** mascara o valor até que você o exiba. 8. **Selecione Confirm** O token aparece na página **Personal Tokens** com a sua **Expiration Date**. Depois que a caixa de diálogo fecha, o valor não pode ser recuperado, e um token perdido precisa ser substituído por um novo. **CLI** Para criar um personal token com a Azion CLI, informe um nome, uma expiração e uma descrição opcional. Este comando cria um token chamado `my-token` que expira no dia seguinte: ```bash azion create personal-token --name my-token --expiration 1d --description 'Token for local CLI tests' ``` O comando imprime o valor do token: ```text Created Personal Token: [TOKEN VALUE] ``` A flag `--expiration` recebe um número seguido de `d` para dias ou de `m` para meses, como `1d` ou `9m`. Nenhum outro comando `personal-token` imprime o valor. Para criar o token a partir de um arquivo JSON com as chaves `name`, `expires_at` e `description`, consulte [Azion CLI personal-token](/pt-br/documentacao/devtools/cli/recursos/personal-token/). --- ## Exclua um personal token Excluir um personal token o revoga, e a exclusão não pode ser desfeita. O Azion Console pede que você confirme a exclusão com o nome do token, e a Azion CLI recebe o UUID do token. **Console** Para excluir um personal token no Azion Console: 1. **Abra a página Personal Tokens** Acesse [Azion Console](https://console.azion.com/) > **Account** > **Personal Token**. **Account** é o menu do avatar. 2. **Selecione Delete no token** Na linha do token, selecione **Delete**. A caixa de diálogo **Delete personal token** abre. 3. **Insira o nome do token** No campo da caixa de diálogo, insira o nome do token, como o rótulo de confirmação o cita. 4. **Selecione Delete** A mensagem **Personal token successfully deleted** aparece, e o token não aparece mais na página **Personal Tokens**. **CLI** A Azion CLI exclui um personal token pelo UUID dele. Para encontrar o UUID, liste os seus personal tokens: ```bash azion list personal-token ``` O comando imprime o UUID, o nome e a expiração de cada token, nunca o valor dele: ```text ID NAME EXPIRES AT 11111111-2222-4333-8444-555555555555 my-token 2027-01-15 23:59:59 +0000 UTC 22222222-3333-4444-8555-666666666666 ci-deploy 2026-12-20 23:59:59 +0000 UTC 33333333-4444-4555-8666-777777777777 cli-local 2027-09-17 23:59:59 +0000 UTC 44444444-5555-4666-8777-888888888888 old-token 2026-09-11 23:59:59 +0000 UTC ``` Um token que passou da expiração, como `old-token`, permanece na lista até que você o exclua. Para excluir o token, informe o UUID dele em `--id`. Este comando exclui o token chamado `my-token`: ```bash azion delete personal-token --id 11111111-2222-4333-8444-555555555555 ``` O comando exclui o token sem pedir confirmação e imprime: ```text Personal token 11111111-2222-4333-8444-555555555555 was successfully deleted ``` --- ## Próximos passos - [Primeiros passos com a Azion CLI](/pt-br/documentacao/devtools/cli/primeiros-passos.md): Salve o seu personal token na CLI e faça o deploy do seu primeiro projeto. - [Primeiros passos com a Azion API](/pt-br/documentacao/devtools/api/primeiros-passos.md): Envie as suas primeiras requisições à Azion API com o seu personal token. - [Azion CLI personal-token](/pt-br/documentacao/devtools/cli/recursos/personal-token.md): Todas as flags dos comandos que criam, listam, descrevem e excluem personal tokens. - [Azion API](/pt-br/documentacao/devtools/api.md): A URL base, o header de autenticação e os limites de taxa da API.