Configurar domínio personalizado
Vincule um domínio personalizado a uma aplicação com POST /v2/apps//network/custom, ou envie @ para removê-lo. Disponível no Standard, Pro e Enterprise.
POST
Configurar domínio personalizado
É necessário ter pelo menos o plano Standard para usar esta rota.
A mesma conta pode associar um domínio a várias aplicações (balanceamento de carga): até 2 aplicações no Standard, 5 no Pro e 10 no Enterprise. Veja Listar balanceadores de carga.
Requer uma chave de API com o escopo
Em caso de falha, a resposta inclui um
string
obrigatório
A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.
apps:write.
Substituir um domínio personalizado existente libera o hostname anterior na borda antes de associar o novo, a menos que outra aplicação na mesma conta ainda aponte para ele. A mesma validação roda tanto ao associar quanto ao remover (custom: "@"): em uma aplicação compartilhada em workspace, quem chama precisa da função admin no workspace ou ser o proprietário.
Um domínio só pode ser reivindicado por uma conta por vez: associar um hostname já pertencente a outra conta retorna DOMAIN_ALREADY_EXISTS. Para ver todos os hostnames configurados nas suas aplicações, veja Listar domínios. Depois de associado, obtenha os registros de validação necessários com Obter registros DNS.
Parâmetros
string
obrigatório
O ID da aplicação. Você pode encontrá-lo na URL da sua aplicação no dashboard.
string
obrigatório
O domínio totalmente qualificado a associar, ou
@ para remover o domínio personalizado atual da aplicação. Não pode ser um domínio da Square Cloud (squareweb.app, squarecloud.app, …).Resposta
string
Indica se a chamada foi bem-sucedida:
success se foi, error se não.code de erro:
Relacionados
- CLI:
squarecloud app network domain - SDKs:
api.apps.network.setDomain()(JavaScript),client.apps.network.set_domain()(Python),c.Apps.Network.SetDomain()(Go)

