# Azion CLI profiles

O comando `profiles` da Azion CLI mostra os perfis configurados na sua máquina e troca o perfil ativo. Um perfil guarda o personal token de uma conta, então vários perfis permitem trabalhar com várias contas ou ambientes a partir da mesma máquina. Para criar ou excluir um perfil, use os comandos de [Azion CLI profile](/pt-br/documentacao/devtools/cli/recursos/profile/). As opções que todo comando aceita, como `--debug` e `--timeout`, estão em [Opções globais](/pt-br/documentacao/devtools/cli/globals/).

---

## Uso

`azion profiles` abre um seletor com todos os perfis que você configurou, a menos que você passe `--refresh`:

```bash
azion profiles [flags]
```

| Flag        | Curta | Tipo | Padrão | Descrição                                                                                                                                                 |
| ----------- | ----- | ---- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--help`    | `-h`  | —    | —      | Imprime a ajuda do comando.                                                                                                                               |
| `--refresh` | —     | —    | —      | Verifica de novo qual versão da Azion API a conta do perfil ativo usa e salva o resultado, em vez de abrir o seletor. Use quando a conta mudou de versão. |

O seletor é interativo: mova o cursor com as setas do teclado e pressione Enter para escolher um perfil. O comando precisa de um terminal para ler a sua escolha. Sem um, como em um script, ele imprime a lista e termina com `Error: EOF`. Nenhum comando lista os perfis sem um seletor.

O seletor sempre abre com o cursor em `default`, qualquer que seja o perfil ativo. Para ver o perfil ativo, execute [`azion whoami`](/pt-br/documentacao/devtools/cli/whoami/), que o imprime como `Active Profile`.

---

## Exemplos

### Trocar o perfil ativo

Este comando abre o seletor em uma máquina com dois perfis, `default` e `my-profile`:

```bash
azion profiles
```

O comando lista os perfis, com o cursor em `default`:

```text
? Choose a profile:  [Use arrows to move, type to filter]
> default
  my-profile
```

Depois que você move o cursor para `my-profile` e pressiona Enter, o comando substitui a lista pela sua escolha e não imprime mais nada:

```text
? Choose a profile: my-profile
```

`my-profile` passa então a ser o perfil ativo, e o `~/.azion/profiles.json` o indica:

```text
Name = 'my-profile'
```

### Criar um perfil

O seletor lista apenas os perfis que existem. `azion create profile` cria um, com um personal token que você criou com `azion create personal-token`:

```bash
azion create profile --name my-profile --personal-token "[TOKEN VALUE]"
```

O comando verifica o token, pergunta se o novo perfil deve ser o padrão e não cria nada quando o token é inválido. Para cada flag que ele aceita, consulte [Azion CLI profile](/pt-br/documentacao/devtools/cli/recursos/profile/#criar).

### Verificar de novo a versão da API de uma conta

A CLI detecta qual versão da Azion API uma conta usa e guarda a resposta. Este comando a verifica de novo para o perfil ativo:

```bash
azion profiles --refresh
```

O comando lê a versão na Azion, salva o resultado e não abre nenhum seletor. Use quando a conta mudou de versão da API e a CLI continua agindo pela versão que registrou antes. Ele falha quando nenhum token está disponível, ou quando o token não autoriza mais a conta.

---

## Recursos relacionados

- [Azion CLI profile](/pt-br/documentacao/devtools/cli/recursos/profile.md): Os comandos que criam e excluem os perfis que este seletor lista.
- [Azion CLI whoami](/pt-br/documentacao/devtools/cli/whoami.md): O comando que imprime o perfil ativo e a conta que ele usa.
- [Azion CLI login](/pt-br/documentacao/devtools/cli/login.md): O comando que autentica a CLI e salva um personal token localmente.
- [Opções globais](/pt-br/documentacao/devtools/cli/globals.md): As opções que todo comando aceita, como `--config`, `--token` e `-y`.