Referência da CLI Rediacc (Cloud / Experimental)

Visão Geral

Estes comandos requerem o **adaptador cloud** (experimental) -- ativado quando uma configuração contém os campos `apiUrl` e `token`. Para a referência principal da CLI, consulte [Aplicação CLI](/pt/docs/cli-application).

1. Autenticação

Comandos de autenticação

1.1 login

Autenticar com a Rediacc

rdc auth login [options]

Flag	Descrição	Obrigatório	Predefinição
-e, --email <email>	Endereço de e-mail	Não	-
-p, --password <password>	Palavra-passe (para login não interativo)	Não	-
-m, --master-password <password>	Palavra-passe mestre para encriptação do vault	Não	-
-n, --name <name>	Nome da sessão	Não	-
--endpoint <url>	URL do endpoint da API	Não	-
--save-as <name>	Guardar credenciais numa configuração nomeada	Não	-

1.2 logout

Apagar credenciais armazenadas

rdc auth logout

1.3 status

Verificar o estado atual de autenticação

rdc auth status

1.4 register

Registar uma nova organização e conta de utilizador

Após o registo, verifique o seu e-mail para obter o código de ativação.

rdc auth register [options]

Flag	Descrição	Obrigatório	Predefinição
--organization <name>	Nome da organização	Sim	-
-e, --email <email>	Endereço de e-mail	Sim	-
-p, --password <password>	Palavra-passe (para login não interativo)	Sim	-
-m, --master-password <password>	Palavra-passe mestre para encriptação do vault	Não	-
--endpoint <url>	URL do endpoint da API	Não	-
--plan <plan>	Plano de subscrição (COMMUNITY, PROFESSIONAL, BUSINESS, ENTERPRISE)	Não	COMMUNITY

1.5 activate

Ativar conta com código de verificação

rdc auth activate [options]

Flag	Descrição	Obrigatório	Predefinição
-e, --email <email>	Endereço de e-mail	Sim	-
-p, --password <password>	Palavra-passe (para login não interativo)	Sim	-
--code <code>	Código de ativação por e-mail	Sim	-
--endpoint <url>	URL do endpoint da API	Não	-

1.6 tfa

Gestão de autenticação de dois fatores

disable

Desativar a autenticação de dois fatores

rdc auth tfa disable [options]

Flag	Descrição	Obrigatório	Predefinição
--code <code>	Código TFA atual para verificação	Não	-
-y, --yes	Ignorar pedido de confirmação	Não	-

enable

Ativar a autenticação de dois fatores

rdc auth tfa enable

status

Verificar o estado do 2FA

rdc auth tfa status

1.7 token

Gestão de tokens

fork

Criar um token com fork para outra aplicação

rdc auth token fork [options]

Flag	Descrição	Obrigatório	Predefinição
-n, --name <name>	Nome do token	Não	CLI Fork
-e, --expires <hours>	Expiração em horas (1-720)	Não	24

list

Listar tokens/sessões ativas

rdc auth token list

revoke

Revogar um token específico

rdc auth token revoke <requestId>

Dica: O seu token de autenticação é guardado localmente na sua configuração. Use `--save-as` para guardar credenciais numa configuração nomeada para múltiplos ambientes.

---

2. Gestão de Organizações

Comandos de gestão de organizações

2.1 list

Listar organizações

rdc organization list

2.2 info

Obter informações da organização

rdc organization info

2.3 dashboard

Obter dados do painel da organização

rdc organization dashboard

2.4 vault

Gestão do vault da organização

get

Obter dados do vault da organização

rdc organization vault get

list

Listar todos os tipos de vault

rdc organization vault list

update

Atualizar dados do vault da organização

rdc organization vault update [options]

Flag	Descrição	Obrigatório	Predefinição
--vault <json>	Conteúdo do vault como string JSON	Não	-
--vault-version <n>	Versão atual do vault para bloqueio otimista	Não	-

2.5 export

Exportar dados da organização

rdc organization export [options]

Flag	Descrição	Obrigatório	Predefinição
--path <path>	Caminho para guardar o ficheiro de saída	Não	-

2.6 import

Importar dados da organização

rdc organization import <path> [options]

Flag	Descrição	Obrigatório	Predefinição
--mode <mode>	Modo de importação (merge ou replace)	Não	merge

2.7 maintenance

Ativar ou desativar o modo de manutenção (bloqueia sessões de não administradores)

rdc organization maintenance <action>

Aviso: Quando o modo de manutenção está ativado, os utilizadores não administradores não conseguem iniciar sessão.

---

3. Gestão de Utilizadores

Comandos de gestão de utilizadores

3.1 list

Listar todos os utilizadores

rdc user list

3.2 create

Criar um novo utilizador

rdc user create <email> [options]

Flag	Descrição	Obrigatório	Predefinição
-p, --password <password>	Palavra-passe para o novo utilizador	Não	-

3.3 activate

Ativar uma conta de utilizador

rdc user activate <email> <activationCode>

3.4 deactivate

Desativar uma conta de utilizador

rdc user deactivate <email> [options]

Flag	Descrição	Obrigatório	Predefinição
-f, --force	Ignorar pedidos de confirmação	Não	-

3.5 reactivate

Reativar uma conta de utilizador desativada

rdc user reactivate <email>

3.6 update-email

Alterar o endereço de email de um utilizador

rdc user update-email <currentEmail> <newEmail>

3.7 update-password

Alterar a sua palavra-passe

rdc user update-password [options]

Flag	Descrição	Obrigatório	Predefinição
--password <password>	Nova palavra-passe (modo não interativo)	Não	-
--confirm <confirm>	Confirmar palavra-passe (modo não interativo)	Não	-

3.8 update-language

Definir o idioma preferido do utilizador atual

rdc user update-language <language>

3.9 exists

Verificar se um utilizador existe

rdc user exists <email>

3.10 vault

Gestão do vault do utilizador

get

Obter dados do vault do utilizador atual

rdc user vault get

update

Atualizar dados do vault do utilizador atual

rdc user vault update [options]

Flag	Descrição	Obrigatório	Predefinição
--vault <json>	Conteúdo do vault como string JSON	Não	-
--vault-version <n>	Versão atual do vault para bloqueio otimista	Não	-

3.11 permission

Gestão de permissões do utilizador

assign

Atribuir um grupo de permissões a um utilizador

rdc user permission assign <userEmail> <groupName>

---

4. Gestão de Equipas

Gestão de equipas

4.1 list

Listar equipas

rdc team list [options]

Flag	Descrição	Obrigatório	Predefinição
--search <text>	Pesquisar em {{field}}	Não	-
--sort <field>	Ordenar por campo	Não	-
--desc	Ordenar por ordem decrescente	Não	-

4.2 create

Criar uma equipa

rdc team create [options]

Flag	Descrição	Obrigatório	Predefinição
--name <name>	Nome do recurso	Sim	-

4.3 member

Gestão de membros de equipa

list

Listar membros da equipa

rdc team member list <teamName>

add

Adicionar um utilizador a uma equipa

rdc team member add <teamName> <userEmail>

remove

Remover um utilizador de uma equipa

rdc team member remove <teamName> <userEmail>

---

5. Gestão de Permissões

Comandos de gestão de permissões

5.1 list

Listar permissões

rdc permission list

5.2 group

Gestão de grupos de permissões

list

Listar todos os grupos de permissões

rdc permission group list

create

Criar um novo grupo de permissões

rdc permission group create <name>

delete

Eliminar um grupo de permissões

rdc permission group delete <name> [options]

Flag	Descrição	Obrigatório	Predefinição
-f, --force	Ignorar pedidos de confirmação	Não	-

show

Mostrar detalhes do grupo de permissões

rdc permission group show <name>

5.3 add

Adicionar uma permissão a um grupo

rdc permission add <groupName> <permission>

5.4 remove

Remover uma permissão de um grupo

rdc permission remove <groupName> <permission>

---

6. Gestão de Regiões

Gestão de regiões

6.1 list

Listar regiões

rdc region list [options]

Flag	Descrição	Obrigatório	Predefinição
--search <text>	Pesquisar em {{field}}	Não	-
--sort <field>	Ordenar por campo	Não	-
--desc	Ordenar por ordem decrescente	Não	-

---

7. Gestão de Bridges

Gestão de bridges

7.1 list

Listar bridges

rdc bridge list [options]

Flag	Descrição	Obrigatório	Predefinição
-r, --region <name>	Nome da região	Não	-
--search <text>	Pesquisar em {{field}}	Não	-
--sort <field>	Ordenar por campo	Não	-
--desc	Ordenar por ordem decrescente	Não	-

7.2 reset-auth

Repor token de autorização da bridge

rdc bridge reset-auth <name> [options]

Flag	Descrição	Obrigatório	Predefinição
-r, --region <name>	Nome da região	Não	-

---

8. Gestão de Repositórios

Comandos de gestão de repositórios

8.1 list

Listar repositórios

rdc repository list [options]

Flag	Descrição	Obrigatório	Predefinição
-t, --team <name>	Nome da equipa	Não	-

8.2 create

Criar um novo repositório

rdc repository create <name> [options]

Flag	Descrição	Obrigatório	Predefinição
-t, --team <name>	Nome da equipa	Não	-
--tag <tag>	Tag do repositório	Não	latest
--parent <name>	Repositório pai (para forks)	Não	-
--parent-tag <tag>	Tag do repositório pai	Não	-

8.3 rename

Renomear um repositório

rdc repository rename <oldName> <newName> [options]

Flag	Descrição	Obrigatório	Predefinição
-t, --team <name>	Nome da equipa	Não	-
--tag <tag>	Tag do repositório	Não	latest

8.4 delete

Eliminar um repositório

rdc repository delete <name> [options]

Flag	Descrição	Obrigatório	Predefinição
-t, --team <name>	Nome da equipa	Não	-
--tag <tag>	Tag do repositório	Não	latest
-f, --force	Ignorar pedidos de confirmação	Não	-

8.5 promote

Promover um fork para estado grand

rdc repository promote <name> [options]

Flag	Descrição	Obrigatório	Predefinição
-t, --team <name>	Nome da equipa	Não	-
--tag <tag>	Tag do repositório	Não	latest
-f, --force	Ignorar pedidos de confirmação	Não	-

Nota: Promover um fork separa-o do seu repositório grand (pai), tornando-o independente.

8.6 vault

Gestão do vault do repositório

get

Obter dados do vault do repositório

rdc repository vault get <repositoryName> [options]

Flag	Descrição	Obrigatório	Predefinição
-t, --team <name>	Nome da equipa	Não	-
--tag <tag>	Tag do repositório	Não	latest

update

Atualizar dados do vault do repositório

rdc repository vault update <repositoryName> [options]

Flag	Descrição	Obrigatório	Predefinição
-t, --team <name>	Nome da equipa	Não	-
--tag <tag>	Tag do repositório	Não	latest
--vault <json>	Conteúdo do vault como string JSON	Não	-
--vault-version <n>	Versão atual do vault para bloqueio otimista	Não	-

---

9. Operações de Fila

Gestão de filas

O sistema de fila está no centro da execução de tarefas do Rediacc. Todas as operações (deploy, backup, execução de scripts) passam pela fila.

9.1 list

Listar itens da fila

rdc queue list [options]

Flag	Descrição	Obrigatório	Predefinição
-t, --team <name>	Nome da equipa	Não	-
--status <status>	Filtrar por estado	Não	-
--priority-min <n>	Prioridade mínima (1-5)	Não	-
--priority-max <n>	Prioridade máxima (1-5)	Não	-
--search <text>	Pesquisar por ID de tarefa, equipa, máquina, bridge	Não	-
--sort <field>	Ordenar por campo	Não	-
--desc	Ordenar por ordem decrescente	Não	-
--limit <n>	Número máximo de resultados	Não	50

9.2 create

Criar um item na fila

rdc queue create [options]

Flag	Descrição	Obrigatório	Predefinição
-f, --function <name>	—	Sim	-
-t, --team <name>	Nome da equipa	Não	-
-m, --machine <name>	Nome da máquina	Não	-
-b, --bridge <name>	Nome da bridge	Não	-
-p, --priority <1-5>	Prioridade (1=mais alta)	Não	3
--param <key=value>	Parâmetros da função	Não	-
--vault <json>	JSON bruto do vault (para scripts/CI)	Não	-

9.3 cancel

Cancelar um item da fila

rdc queue cancel <taskId>

9.4 retry

Repetir um item falhado da fila

rdc queue retry <taskId>

9.5 trace

Rastrear a execução de um item da fila

rdc queue trace <taskId> [options]

Flag	Descrição	Obrigatório	Predefinição
-w, --watch	Monitorizar atualizações	Não	-
--interval <ms>	Intervalo de polling em milissegundos	Não	2000

Dica: Use `--watch` para acompanhar a tarefa em tempo real até à sua conclusão.

9.6 delete

Eliminar um item da fila

rdc queue delete <taskId> [options]

Flag	Descrição	Obrigatório	Predefinição
-f, --force	Ignorar pedidos de confirmação	Não	-

---

10. Gestão de Armazenamento Ceph

Gestão de armazenamento distribuído Ceph

10.1 cluster

Gestão de clusters Ceph

list

Listar clusters Ceph

rdc ceph cluster list

create

Criar um novo cluster Ceph

rdc ceph cluster create <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--vault <content>	Conteúdo do vault como string JSON	Não	-

delete

Eliminar um cluster Ceph

rdc ceph cluster delete <name> [options]

Flag	Descrição	Obrigatório	Predefinição
-f, --force	Ignorar pedidos de confirmação	Não	-

machines

Listar máquinas num cluster Ceph

rdc ceph cluster machines <name>

vault

Gestão do vault do cluster Ceph

get:

Obter dados do vault do cluster

rdc ceph cluster vault get <name>

update:

Atualizar dados do vault do cluster

rdc ceph cluster vault update <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--vault <content>	Conteúdo do vault como string JSON	Sim	-

10.2 pool

Gestão de pools Ceph

list

Listar pools Ceph

rdc ceph pool list [options]

Flag	Descrição	Obrigatório	Predefinição
--team <name>	Nome da equipa	Não	-
--cluster <name>	Nome do cluster Ceph	Não	-

create

Criar um novo pool Ceph

rdc ceph pool create <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--cluster <name>	Nome do cluster Ceph	Sim	-
--team <name>	Nome da equipa	Sim	-
--vault <content>	Conteúdo do vault como string JSON	Não	-

delete

Eliminar um pool Ceph

rdc ceph pool delete <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--team <name>	Nome da equipa	Sim	-
-f, --force	Ignorar pedidos de confirmação	Não	-

vault

Gestão do vault do pool Ceph

get:

Obter dados do vault do pool

rdc ceph pool vault get <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--team <name>	Nome da equipa	Sim	-

update:

Atualizar dados do vault do pool

rdc ceph pool vault update <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--team <name>	Nome da equipa	Sim	-
--vault <content>	Conteúdo do vault como string JSON	Sim	-

10.3 image

Gestão de imagens RBD Ceph

list

Listar imagens RBD

rdc ceph image list [options]

Flag	Descrição	Obrigatório	Predefinição
--pool <name>	Nome do pool Ceph	Não	-
--team <name>	Nome da equipa	Não	-

create

Criar uma nova imagem RBD

rdc ceph image create <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--pool <name>	Nome do pool Ceph	Sim	-
--team <name>	Nome da equipa	Sim	-
--machine <name>	Nome da máquina	Sim	-
--vault <content>	Conteúdo do vault como string JSON	Não	-

delete

Eliminar uma imagem RBD

rdc ceph image delete <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--pool <name>	Nome do pool Ceph	Sim	-
--team <name>	Nome da equipa	Sim	-
-f, --force	Ignorar pedidos de confirmação	Não	-

10.4 snapshot

Gestão de snapshots RBD Ceph

list

Listar snapshots RBD

rdc ceph snapshot list [options]

Flag	Descrição	Obrigatório	Predefinição
--image <name>	Nome da imagem RBD	Não	-
--pool <name>	Nome do pool Ceph	Não	-
--team <name>	Nome da equipa	Não	-

create

Criar um novo snapshot RBD

rdc ceph snapshot create <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--image <name>	Nome da imagem RBD	Sim	-
--pool <name>	Nome do pool Ceph	Sim	-
--team <name>	Nome da equipa	Sim	-
--vault <content>	Conteúdo do vault como string JSON	Não	-

delete

Eliminar um snapshot RBD

rdc ceph snapshot delete <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--image <name>	Nome da imagem RBD	Sim	-
--pool <name>	Nome do pool Ceph	Sim	-
--team <name>	Nome da equipa	Sim	-
-f, --force	Ignorar pedidos de confirmação	Não	-

10.5 clone

Gestão de clones RBD Ceph

list

Listar clones RBD

rdc ceph clone list [options]

Flag	Descrição	Obrigatório	Predefinição
--snapshot <name>	Nome do snapshot RBD	Não	-
--image <name>	Nome da imagem RBD	Não	-
--pool <name>	Nome do pool Ceph	Não	-
--team <name>	Nome da equipa	Não	-

create

Criar um novo clone RBD a partir de um snapshot

rdc ceph clone create <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--snapshot <name>	Nome do snapshot RBD	Sim	-
--image <name>	Nome da imagem RBD	Sim	-
--pool <name>	Nome do pool Ceph	Sim	-
--team <name>	Nome da equipa	Sim	-
--vault <content>	Conteúdo do vault como string JSON	Não	-

delete

Eliminar um clone RBD

rdc ceph clone delete <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--snapshot <name>	Nome do snapshot RBD	Sim	-
--image <name>	Nome da imagem RBD	Sim	-
--pool <name>	Nome do pool Ceph	Sim	-
--team <name>	Nome da equipa	Sim	-
-f, --force	Ignorar pedidos de confirmação	Não	-

machines

Listar máquinas atribuídas a um clone

rdc ceph clone machines <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--snapshot <name>	Nome do snapshot RBD	Sim	-
--image <name>	Nome da imagem RBD	Sim	-
--pool <name>	Nome do pool Ceph	Sim	-
--team <name>	Nome da equipa	Sim	-

assign

Atribuir máquinas a um clone

rdc ceph clone assign <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--snapshot <name>	Nome do snapshot RBD	Sim	-
--image <name>	Nome da imagem RBD	Sim	-
--pool <name>	Nome do pool Ceph	Sim	-
--team <name>	Nome da equipa	Sim	-
--machines <names>	Nomes das máquinas (separados por vírgula)	Sim	-

unassign

Remover máquinas de um clone

rdc ceph clone unassign <name> [options]

Flag	Descrição	Obrigatório	Predefinição
--snapshot <name>	Nome do snapshot RBD	Sim	-
--image <name>	Nome da imagem RBD	Sim	-
--pool <name>	Nome do pool Ceph	Sim	-
--team <name>	Nome da equipa	Sim	-
--machines <names>	Nomes das máquinas (separados por vírgula)	Sim	-

---

11. Auditoria e Conformidade

Comandos de registo de auditoria

11.1 list

Listar entradas do registo de auditoria

rdc audit list

11.2 log

Ver registos de auditoria

rdc audit log [options]

Flag	Descrição	Obrigatório	Predefinição
--limit <n>	Número máximo de resultados	Não	100

11.3 trace

Rastrear o histórico de auditoria de uma entidade

rdc audit trace <entityType> <entityId>

11.4 history

Ver histórico de entidade

rdc audit history <entityType> <entityId>

---