Domains
Compre, ligue e gira domínios.
Os Domínios têm dois métodos pensados para um chamador externo. São os dois de que um agente de IA precisa para ligar um domínio existente sem nunca ver um servidor de nomes: listar o que a conta já possui e depois apontar um para um projeto. Tudo o resto que a página dos Domínios faz (pesquisa, compra, registos DNS, definições de encriptação, análises, transferências) é feito a partir do painel.
Ligar um domínio que já possui
Listar o que tem
agent_domain_list devolve quantos domínios a conta tem e, para cada um, o seu nome, estado, tipo de ligação e o projeto a que está associado, se houver. Chame-o antes de pedir a alguém que escreva um domínio: apresente as opções em vez disso.
Apontá-lo para um projeto
agent_domain_connect recebe um domain dessa lista e um subdomain opcional, e associa-o ao projeto a que a chave ou a sessão que chama está limitada. Omita o subdomínio para usar o apex. Associar substitui qualquer registo DNS existente nesse nome de anfitrião exato. Prefira um subdomínio, a menos que a pessoa queira o apex.
Ambos os métodos tiram a conta e o projeto da chave (ou da sessão por onde a chamada chega), e não do que o chamador escreve no pedido. Ligar precisa de uma chave criada a partir de um projeto: uma chave sem projeto pode listar, mas não pode ligar.
Uma recusa volta com um code negativo e uma frase em data, por exemplo quando nenhuma conta ou nenhum projeto está associado à chave, ou quando o domain está vazio.
agent_domain_connect deliberadamente não compra um domínio, apenas liga um que já possui. A pesquisa e a compra ficam atrás de uma confirmação explícita na janela Comprar um domínio, tal como a edição de registos DNS, as definições de encriptação e as transferências.
Definir o endereço de um projeto
Para dar a um projeto, a partir de código, um domínio que registou através do Xuda, use update_domain_setup com domain_setup.type definido como registered e domain_setup.registered_domain definido como o nome. É um método do próprio projeto e precisa de uma chave de administrador. O painel faz o mesmo a partir de Associar a um projeto.
Guias anteriores
Domínios no guia de alojamento e Ligar um domínio percorrem a mesma tarefa passo a passo.