Ferramentas de redirecionamentos
Consulte ou substitua os redirecionamentos do projeto através do Connector.
Nesta página
Leia as regras de redirecionamento do projeto ou substitua a lista completa.
Nota
A ligação aplica-se ao Space. Pertence a ele e o Space não está bloqueado. Um Space é uma área de trabalho partilhada na app.
hosting_list_redirects pode ser chamado com qualquer função, incluindo Apenas leitura. Para hosting_set_redirects, precisa de Proprietário, Administrador ou Utilizador.
hosting_list_redirects List redirects
apenas lê
Lista as regras de redirecionamento de um projeto pela sua ordem. Aplica-se a primeira regra correspondente.
| 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 indicado por hosting_list_projects. |
hosting_set_redirects Set redirects
altera dadoselimina, substitui ou altera o que é visível
Leia primeiro as regras existentes com hosting_list_redirects e envie na nova lista todas as regras que devem ser mantidas.
Atenção
As regras em falta são removidas; uma lista vazia remove todas. A ferramenta executa na primeira chamada sem frase de confirmação.
- Um projeto tem no máximo 200 regras. A origem de uma regra tem até 500 caracteres e o destino até 1.000. Se uma regra for inválida ou a lista demasiado longa, a TEISENDA não guarda a lista.
- Dois caminhos não podem ser a origem, incluindo tudo o que estiver abaixo deles:
/.teisendae/.well-known/acme-challenge. Pertencem 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 indicado por hosting_list_projects. |
rules | Lista de objetos | obrigatório | A lista completa, no máximo 200 regras; uma lista vazia remove todas. Cada regra é um objeto com source, target e, opcionalmente, status. source é a origem: um caminho que começa por /. Nele, :name ocupa um segmento do caminho e * no fim representa o restante. target é o destino: um caminho ou endereço completo com https. Pode reutilizar :name e * da origem no destino. status é 301, 302, 307 ou 308; se faltar, aplica-se 301. |
Se algo não funcionar
Quando uma solução indicar uma ferramenta, peça à aplicação que a chame.
A lista não foi guardada:
Esta mensagem só é devolvida por hosting_set_redirects. A TEISENDA não guardou a lista; depois da mensagem, aparece uma linha por regra inválida com a posição e o motivo. Corrija as regras indicadas e chame novamente a ferramenta com a lista completa. A linha indica um destes motivos:
- A origem está mal formada ou tem mais de 500 caracteres: A origem tem de ser um caminho que comece por / – sem espaços, ? nem #. :name preenche um segmento inteiro; /* só vai no fim.
- O destino está mal formado ou tem mais de 1.000 caracteres: O destino tem de ser um caminho que comece por / ou um endereço completo com https://.
- A origem é um caminho reservado, ou seja,
/.teisenda,/.well-known/acme-challengeou algo abaixo deles: Este caminho está reservado. - O destino indica um marcador desconhecido: O destino usa um marcador de posição que não existe na origem.
- O estado é diferente de 301, 302, 307 ou 308: Só são permitidos 301, 302, 307 e 308.
- A regra aponta para si mesma ou forma um ciclo: Esta regra aponta para si própria ou entra num ciclo com outras regras.
- A lista tem mais de 200 regras: Não são permitidas mais de … regras.
As mensagens sobre o Space e o número de projeto estão nas ferramentas de Spaces e projetos. Todas as restantes que podem aparecer em qualquer ferramenta estão em Resolver problemas do Connector.