> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Como usar um link de compartilhamento de template na Vertra Cloud com segurança

> Abra um link de compartilhamento de template, leia a prévia, o selo Não verificado, a cópia da imagem e a vaga usada, e denuncie abusos se algo parecer errado.

Um link de compartilhamento de template permite que alguém lhe entregue um template privado sem publicá-lo. Abra-o, leia a prévia e, se confiar no autor, crie o app ou a stack a partir dele. O template **não é verificado pela Vertra**: ele vem de uma pessoa, não do catálogo.

Você precisa de uma conta para criar qualquer coisa a partir de um link. A prévia em si abre sem login.

## A prévia

Antes de você criar qualquer coisa, a página do link mostra:

* o autor;
* o que será criado (os serviços e a memória total);
* o plano necessário e a vaga de imagem que será usada;
* o selo **Não verificado pela Vertra**;
* se o código é fechado, um aviso: os valores que você preencher (por exemplo, a chave do seu provedor de modelos) vão para um código que você não vê, e você está confiando no autor.

Continue só se confiar em quem enviou o link. Veja [Templates fechados](https://docs.vertracloud.app/pt-br/templates/use/closed-templates.md).

## Dois tipos de link

O autor escolhe o tipo ao criar o link.

| | Link de uso (padrão) | Link de cópia completa |
| - | - | - |
| O que você recebe | Apps ou uma stack criados a partir do template, com a sua própria cópia da imagem. | Um template privado seu: manifesto, código, Dockerfile e imagem. |
| Código | Aberto ou fechado, conforme o autor decidiu. | Sempre visível. |
| Atualizações do autor | Sim, quando você clica em **Atualizar**. | Não: sua cópia é independente. |
| Vaga de imagem | Uma. | Uma. |
| Conta para | Os requisitos da receita. | Seu limite de templates privados, além da receita. |

## A cópia da imagem e a sua vaga

Quando um template de link executa uma imagem, a plataforma cria um registro de imagem **na sua conta**: uma cópia da imagem, então nada é reconstruído e você não recebe Dockerfile nem contexto de build. Ela usa **uma vaga de imagem** da sua conta (veja [Vagas de imagem](https://docs.vertracloud.app/pt-br/templates/overview.md#vagas-de-imagem)); o autor mantém a dele. A cópia aparece na sua lista de imagens como, por exemplo, "Bot X (from Agency Y)".

Como a imagem é sua, se o autor apagar depois a imagem, o template ou a conta dele, nada muda para o que você criou. O link deixa de funcionar, mas as suas cópias continuam rodando.

**Atualizar** copia a nova versão para a sua conta, desde que o link e o template ainda existam.

## Revogação

O autor pode **revogar** o link: nenhum novo uso é possível e nenhuma atualização é mais oferecida. O que você já criou continua sendo seu e continua rodando. O autor nunca pode parar, apagar ou ler nada na sua conta.

Um link também pode expirar, esgotar os usos ou ser revogado, e a página diz qual foi o caso:

| Mensagem | Significado |
| - | - |
| `SHARE_LINK_NOT_FOUND` | O link não existe, ou o template dele foi removido. |
| `SHARE_LINK_REVOKED` | O autor revogou o link. |
| `SHARE_LINK_EXPIRED` | O link passou da validade. |
| `SHARE_LINK_EXHAUSTED` | O link atingiu o número máximo de usos. |

## Denunciar um template

Um template de link é uma forma de distribuir o código de alguém sem revisão, então toda prévia e todo app criado a partir de um template tem um botão **Denunciar**. Escolha um motivo (código malicioso, golpe ou fraude, direitos autorais, segredo vazado ou outro), adicione detalhes de até 1.000 caracteres sem senhas nem dados pessoais e envie. A equipe da Vertra analisa, e o autor não é informado de quem denunciou.

Para casos graves, ou se você tiver evidências, escreva também para [abuse@vertracloud.app](mailto:abuse@vertracloud.app). A Vertra Cloud pode revogar um link ou um template e, em caso de malware, parar todas as cópias, aplicando seus termos de uso.

## Criar a partir do link

Abra o link e avance pelo assistente, que funciona como o de [qualquer template](https://docs.vertracloud.app/pt-br/templates/use/using-a-template.md). Na CLI, use `vertra template deploy --share <link-or-token> --name my-app`. Um link de cópia completa entrega um template, não um deploy, então a CLI o recusa em `deploy`.

Para a API, veja [Preview a share link](https://docs.vertracloud.app/pt-br/api-reference/endpoint/templates/share-links/preview.md), [Deploy from a share link](https://docs.vertracloud.app/pt-br/api-reference/endpoint/templates/share-links/deploy.md), [Copy a template](https://docs.vertracloud.app/pt-br/api-reference/endpoint/templates/share-links/copy.md) e [Report](https://docs.vertracloud.app/pt-br/api-reference/endpoint/templates/share-links/report.md). Para criar seus próprios links, veja [Links de compartilhamento](https://docs.vertracloud.app/pt-br/templates/create/share-links.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.