Ferramentas para publicar
Publique um rascunho ou volte a disponibilizar uma versão anterior.
Nesta página
Um Space é uma área de trabalho partilhada na app.
Publique um rascunho, verifique versões ou volte a disponibilizar uma versão anterior.
Nota
A ligação corresponde ao Space. É membro desse Space e o Space não está bloqueado.
hosting_list_deploys pode ser chamada com qualquer função, incluindo Apenas leitura. As outras quatro exigem Proprietário, Administrador ou Utilizador; isto também se aplica a hosting_deploy_status.
Atenção
hosting_deploy conclui precisamente o rascunho do projeto e publica-o: o que não estiver no rascunho não faz parte da nova versão. Um novo rascunho começa vazio e não é uma cópia da versão publicada; consulte Ferramentas para ficheiros. Sem um ficheiro index.html na pasta principal, não é possível concluir.
Todas as ferramentas desta página funcionam na primeira chamada sem uma frase de confirmação. Não é garantido que a aplicação lhe faça uma pergunta.
hosting_deploy Publish deployment
altera dadoselimina, substitui ou altera o que é visível
Conclui o rascunho e publica-o. Com deploy, publica, em alternativa, uma versão concluída específica; voltar a publicar não conta para o limite do plano.
A resposta indica o endereço e o acesso necessário para websites privados. Se os limites de ficheiros ou armazenamento forem excedidos, a nova versão é descartada; as versões anteriores permanecem.
| Parâmetro | Tipo | Indicação | Descrição |
|---|---|---|---|
space | Número inteiro | obrigatório | A Space-ID de dez dígitos. |
project | Número inteiro | obrigatório | O número do projeto apresentado por hosting_list_projects. |
deploy | Número inteiro | opcional | O número de uma versão concluída deste projeto. Se não for indicado, a ferramenta publica o rascunho. |
hosting_deploy_status Deployment status
altera dadoselimina, substitui ou altera o que é visível
Consulta o estado da versão indicada; sem número, consulta o rascunho, se existir, ou a versão publicada.
A chamada guarda o estado na aplicação. Ao concluir uma versão, as versões anteriores podem ser eliminadas definitivamente; se a nova versão não couber no plano, é esta que é descartada.
| Parâmetro | Tipo | Indicação | Descrição |
|---|---|---|---|
space | Número inteiro | obrigatório | A Space-ID de dez dígitos. |
project | Número inteiro | obrigatório | O número do projeto apresentado por hosting_list_projects. |
deploy | Número inteiro | opcional | O número de uma versão deste projeto. Se não for indicado, a ferramenta utiliza o rascunho, se existir, ou a versão publicada. |
hosting_list_deploys List deployments
apenas lê
Lista as versões e o número da versão publicada para chamadas posteriores com deploy.
A resposta indica o estado, tamanho, cópias de segurança, problemas e utilização do plano.
| Parâmetro | Tipo | Indicação | Descrição |
|---|---|---|---|
space | Número inteiro | obrigatório | A Space-ID de dez dígitos. |
project | Número inteiro | obrigatório | O número do projeto apresentado por hosting_list_projects. |
hosting_rollback Roll back deployment
altera dadoselimina, substitui ou altera o que é visível
Volta a publicar uma versão que ainda existe e já foi publicada anteriormente. Esta ação não consome uma publicação; a versão anteriormente ativa permanece.
Se a versão já estiver ativa, nada muda. Os visitantes veem a alteração assim que esta for transmitida ao nó de alojamento.
| Parâmetro | Tipo | Indicação | Descrição |
|---|---|---|---|
space | Número inteiro | obrigatório | A Space-ID de dez dígitos. |
project | Número inteiro | obrigatório | O número do projeto apresentado por hosting_list_projects. |
deploy | Número inteiro | obrigatório | O número da versão à qual o projeto deve voltar. Só pode ser utilizada uma versão que já tenha sido publicada. |
hosting_set_offline Take project offline or online
altera dadoselimina, substitui ou altera o que é visível
Coloca o website de um projeto offline ou volta a colocá-lo online. Colocar offline não elimina nada: as versões, os domínios e as definições permanecem.
Quando está offline, os visitantes veem uma página de erro em todos os endereços; não são fornecidos endereços de carregamento. As alterações têm efeito após a transmissão.
| Parâmetro | Tipo | Indicação | Descrição |
|---|---|---|---|
space | Número inteiro | obrigatório | A Space-ID de dez dígitos. |
project | Número inteiro | obrigatório | O número do projeto apresentado por hosting_list_projects. |
offline | Valor booleano | obrigatório | true coloca o website offline; false volta a colocá-lo online. |
O plano limita as publicações e as versões
O plano Free permite 3 publicações no total e conserva 3 versões e 1 cópia de segurança por projeto. O plano Max permite qualquer número de publicações e conserva 5 versões e 3 cópias de segurança.
Atenção
Uma nova versão concluída pode eliminar definitivamente as versões mais antigas. A versão publicada, o rascunho e as cópias de segurança estão protegidos.
Voltar a publicar não conta; quando as publicações estão esgotadas, continua a não ser possível escrever nem carregar novos ficheiros. Consulte os limites do plano.
Uma cópia de segurança é uma versão concluída que permanece
As cópias de segurança permanecem quando são criadas novas versões e não contam para as versões normalmente conservadas. hosting_list_deploys e hosting_deploy_status mostram a respetiva identificação.
Como definir uma cópia de segurança?
Nenhuma ferramenta do Connector define ou remove a marcação de cópia de segurança. Faça-o na aplicação: na lista de versões da página do projeto, no menu de uma versão, com Manter como cópia de segurança e Remover a marca de cópia de segurança. Saiba mais em Gerir versões e cópias de segurança.
Um Space suspenso não disponibiliza websites
Após o fim da subscrição, as ferramentas podem continuar a funcionar, embora os visitantes não vejam nenhum website. Aplicam-se os limites do plano Free; o campo offline mostra apenas o interruptor do projeto individual.
hosting_create_upload não recebe um endereço de carregamento. Altere o Space para Free na aplicação ou contrate uma nova subscrição; nenhuma ferramenta faz esta alteração.
A TEISENDA envia um aviso quando o armazenamento escasseia
Quando é enviado cada e-mail e a quem?
A TEISENDA verifica aproximadamente a cada cinco minutos se a utilização justifica um e-mail; a própria chamada da ferramenta não o envia. Consulte os limiares, destinatários e repetições em E-mails sobre a utilização.
Se algo não funcionar
Quando uma solução indica uma ferramenta, peça à aplicação que a chame. Se uma mensagem remeter para Planos, siga o caminho para o plano nas definições do Space.
O plano deste Space permite … implementações, das quais … já foram utilizadas. Não foi enviado nada e não foi criada nenhuma versão. O plano deste Space consta no TEISENDA, em Definições › Planos.
hosting_deploy foi chamada sem número de versão e o plano do Space não permite outra publicação; no plano Free são três no total. A TEISENDA não carregou nada e não criou nada. Voltar a publicar uma versão já publicada não consome uma publicação e continua a ser possível: com hosting_rollback ou com hosting_deploy e o respetivo número. O plano Max permite mais publicações; consulte Planos Free e Max.
O plano deste Space permite … implementações, das quais … já foram utilizadas. A versão … está concluída, mas não publicada. O plano deste Space consta no TEISENDA, em Definições › Planos.
hosting_deploy foi chamada com o número de uma versão concluída que nunca tinha sido publicada, e o plano do Space não permite outra publicação. A versão permanece concluída, mas não publicada. Voltar a publicar uma versão anteriormente publicada não consome uma publicação e continua a ser possível com hosting_rollback ou com hosting_deploy e o respetivo número. O plano Max permite mais publicações; consulte Planos Free e Max.
A versão indicada já está publicada.
Não é uma rejeição: hosting_rollback ou hosting_deploy foi chamada com o número da versão que já está publicada. A ferramenta informa-o e não altera nada. Não precisa de fazer nada; se pretende voltar a uma versão anterior, indique outra versão.
Não há nenhuma versão aberta. Primeiro, coloque ficheiros com hosting_put_files.
O projeto não tem um rascunho que hosting_deploy possa publicar. Escreva primeiro ficheiros com hosting_put_files.
O projeto ainda não tem nenhuma implementação.
hosting_deploy_status foi chamada sem número e o projeto ainda não tem nenhuma versão. Escreva primeiro ficheiros com hosting_put_files.
A versão … não existe neste projeto.
O projeto não tem uma versão com o número indicado no argumento deploy, por exemplo, porque a TEISENDA a eliminou quando o nó de alojamento concluiu versões mais recentes. Consulte com hosting_list_deploys as versões que o projeto ainda tem.
A versão indicada nunca foi publicada. Para a publicar, utilize hosting_deploy.
hosting_rollback foi chamada para uma versão que nunca tinha sido publicada. Publicá-la seria uma primeira publicação e contaria para o plano. Utilize hosting_deploy com o número dessa versão ou indique uma versão que já tenha sido publicada.
A versão ainda não está pronta.
hosting_deploy foi chamada com o número de uma versão que não está concluída; nos websites atualmente existentes, trata-se do rascunho. Com um número, a ferramenta apenas publica e não conclui nada. Para o rascunho, chame hosting_deploy sem número; desta forma, conclui-o e publica-o. Uma versão carregada através da interface da aplicação é concluída pelo próprio nó; consulte quando com hosting_deploy_status.
Falta o index.html na pasta principal.
A versão não tem um ficheiro index.html na pasta principal. Por isso, não pode ser concluída nem publicada. Coloque um ficheiro index.html na pasta principal e publique novamente.
A versão indicada não foi aceite e foi descartada.
A TEISENDA descartou a versão concluída; as versões anteriores permanecem inalteradas. A mensagem indica um de três motivos:
- A versão é maior do que o tamanho permitido por versão no plano. Reduza o tamanho do website.
- Contém mais ficheiros do que o número permitido por versão no plano. Reduza o número de ficheiros.
- Com esta versão, o Space utilizaria mais armazenamento do que o plano permite. Elimine versões ou cópias de segurança na TEISENDA; o plano Max e os seus pacotes oferecem mais armazenamento. Consulte Comprar e cancelar pacotes.
O plano Max não estabelece um limite próprio por versão; consulte Planos Free e Max. A mensagem sobre armazenamento cheio antes do carregamento encontra-se nas Ferramentas para ficheiros.
As mensagens sobre o Space e o número do projeto encontram-se nas ferramentas para Spaces e projetos. Todas as restantes mensagens que podem surgir em qualquer ferramenta encontram-se em Resolver erros do Connector.