Domains
Achetez, connectez et gérez des domaines.
Domains a deux méthodes conçues pour un appelant externe. Ce sont les deux dont un agent IA a besoin pour connecter un domaine existant sans jamais voir un serveur de noms : lister ce que le compte possède déjà, puis en faire pointer un vers un projet. Tout le reste de ce que fait la page Domains (recherche, achat, enregistrements DNS, paramètres de chiffrement, statistiques, transferts) se fait depuis le tableau de bord.
Connecter un domaine que vous possédez déjà
Lister ce que vous avez
agent_domain_list renvoie le nombre de domaines que le compte détient et, pour chacun, son nom, son statut, son type de connexion et le projet auquel il est rattaché, le cas échéant. Appelez-la avant de demander à quiconque de saisir un domaine : présentez plutôt les options.
Le faire pointer vers un projet
agent_domain_connect prend un domain de cette liste et un subdomain facultatif, et le rattache au projet auquel la clé ou la session appelante est limitée. Omettez le sous-domaine pour utiliser le domaine racine. Le rattachement remplace tout enregistrement DNS existant sur ce nom d'hôte exact. Préférez un sous-domaine, sauf si la personne veut le domaine racine.
Les deux méthodes prennent le compte et le projet à partir de la clé (ou de la session par laquelle passe l'appel), et non de ce que l'appelant écrit dans la requête. Se connecter demande une clé créée depuis un projet : une clé sans projet peut lister, mais ne peut pas connecter.
Un refus revient avec un code négatif et une phrase dans data, par exemple quand aucun compte ou aucun projet n'est lié à la clé, ou quand le domain est vide.
agent_domain_connect n'achète volontairement pas de domaine : il ne connecte que celui que vous détenez déjà. La recherche et l'achat restent derrière une confirmation explicite dans la fenêtre Acheter un domaine, tout comme la modification des enregistrements DNS, les paramètres de chiffrement et les transferts.
Définir l'adresse d'un projet
Pour donner à un projet un domaine que vous avez enregistré via Xuda depuis du code, utilisez update_domain_setup avec domain_setup.type à registered et domain_setup.registered_domain au nom du domaine. C'est une méthode du projet lui-même, et elle demande une clé d'administrateur. Le tableau de bord fait la même chose depuis Rattacher à un projet.
Guides antérieurs
Les domaines dans le guide d'hébergement et Connecter un domaine détaillent la même tâche pas à pas.