Nesta página

Transferencia de Propriedade

A transferencia de propriedade permite que o Owner atual de um projeto passe o controle total para outro membro da equipe. Essa funcionalidade e util quando o responsavel pelo projeto muda ou quando voce precisa reorganizar a gestao dos seus projetos.

Requisitos

Antes de transferir a propriedade, certifique-se de que:

  • Voce e o Owner atual do projeto. Somente o Owner pode iniciar uma transferencia.
  • O membro que recebera a propriedade ja faz parte do projeto. Nao e possivel transferir para alguem que nao e membro.
  • O membro de destino possui quota suficiente no plano atual para receber o projeto.

O que acontece na transferencia

Quando a propriedade e transferida:

  • O membro escolhido se torna o novo Owner do projeto com controle total.
  • O Owner anterior e automaticamente rebaixado para o papel de Admin, mantendo amplo acesso ao projeto.
  • Todas as configuracoes do projeto sao preservadas (servicos, deploys, dominios, variaveis de ambiente, etc.).
  • A cobranca e a responsabilidade de quota passam para o plano resolvido do novo Owner.
  • O plano armazenado no projeto e atualizado para o plano resolvido do novo Owner.

Como transferir

  1. Acesse os membros do projeto — abra o projeto no dashboard e clique em Membros no menu lateral.

  2. Abra o menu do membro — encontre o membro que deve receber o projeto e abra o menu de acoes da linha.

  3. Previsualize a transferencia — clique em Transferir propriedade. A Guara Cloud verifica os limites do plano do membro antes de permitir a confirmacao.

  4. Confirme a transferencia — revise o impacto de papeis e quota, digite o email do destino ou o nome do projeto e clique em Transferir propriedade.

Comportamento da API

O dashboard primeiro chama POST /projects/:projectId/transfer-ownership/preview com:

{ "target_user_id": "..." }

A previsualizacao retorna o membro de destino, plano de destino, resultado dos papeis e quota_impact. Ela nao altera o projeto.

A transferencia final chama POST /projects/:projectId/transfer-ownership com o mesmo corpo. A API repete a verificacao de quota dentro da transacao de propriedade antes de gravar membros, dono do projeto, logs de auditoria, notificacoes ou mensagens de outbox.

Se o membro de destino exceder quota, a transferencia falha com OWNERSHIP_TRANSFER_TARGET_OVER_QUOTA e HTTP 402. A resposta inclui motivos bloqueantes para recursos como projetos, servicos por projeto, cron workers, armazenamento, CPU da conta e memoria da conta.

Perguntas frequentes

Posso recuperar a propriedade apos a transferencia?

Nao diretamente. O novo Owner precisara fazer uma nova transferencia de volta para voce. Se isso nao for possivel, entre em contato com o suporte.

A transferencia afeta meus servicos?

Nao. Todos os servicos continuam rodando normalmente. Nenhum deploy e interrompido ou reiniciado.

Posso transferir para um Viewer?

Sim, desde que a pessoa seja membro do projeto. O papel atual do membro nao importa — ao receber a propriedade, ele se torna Owner automaticamente.