Skip to main content

Administrar tenants

Objetivo​

O tenant representa uma organização ou conta da Magalu Cloud. Os recursos e as permissões ficam separados por tenant. Quando você tem acesso a mais de um tenant, a CLI permite escolher em qual deles os comandos serão executados. Neste guia, você vai aprender a listar os tenants disponíveis, consultar o tenant ativo e alternar entre eles.

Pré-requisitos​

Como fazer​

Listar os tenants​

Liste os tenants aos quais você tem acesso:

mgc auth tenant list

O resultado mostra o UUID de cada tenant, que é usado para ativá-lo.

Consultar o tenant ativo​

Veja em qual tenant os comandos estão sendo executados no momento:

mgc auth tenant current

Alternar o tenant ativo​

Você pode definir o tenant ativo de duas formas:

  • Informando o UUID do tenant:

    mgc auth tenant set --uuid="ad468668-4cd4-4336-905e-90a390502e97"

  • Selecionando o tenant em uma lista:

    mgc auth tenant select

A partir daí, todos os comandos são executados no tenant selecionado.

info

Se você se autentica com uma API key, pela variável MGC_API_KEY ou pela flag --api-key, os comandos são executados no tenant em que a chave foi criada. Nesse caso, alternar o tenant ativo não tem efeito.

Perguntas frequentes​

O tenant selecionado vale para todos os workspaces?
Não. A seleção do tenant fica salva junto com as credenciais do workspace ativo. Ao trocar de workspace, a CLI passa a usar o tenant definido nele. Veja mais em Administrar workspaces.

Por que um tenant não aparece na listagem?
A listagem mostra apenas os tenants aos quais a conta autenticada tem acesso. Confira se você fez login com a conta correta e se ela tem permissão no tenant desejado.

Próximos passos​