Σύνδεση domain
Στρέψτε ένα από τα δικά domain του λογαριασμού στο έργο αυτού του κλειδιού μέσω DNS, με κλειδί πεδίου Εφαρμογής.
Το agent_domain_connect είναι κλήση με πεδίο έργου: σε αντίθεση με κάθε άλλη εγγραφή σε αυτή την ενότητα, δεν παίρνει app_id. Το έργο στο οποίο στρέφει ένα domain είναι αυτό από το οποίο δημιουργήθηκε το ίδιο το κλειδί API, οπότε αυτή η συνταγή χρειάζεται κλειδί Εφαρμογής (που δημιουργείται από την καρτέλα API του ίδιου του έργου), όχι κλειδί Λογαριασμού. Το agent_domain_list είναι η συνοδευτική ανάγνωση, τα δικά domain του λογαριασμού, ώστε να στέλνετε πάντα ένα όνομα που ο λογαριασμός κατέχει πράγματι.
Μέθοδοι
Domains: list
List the account's registered domains (name, status, which app each is attached to). Use this BEFORE asking the user to type a domain: if they say 'connect one of my domains', call this and present the options.
Domains: connect to this VPS
Point one of the account's own domains (from agent_domain_list) at THIS project's VPS via DNS. Optional subdomain (e.g. 'app' -> app.example.com); omit to use the apex. Prefer a subdomain unless the user explicitly wants the apex. Attaching replaces any existing record on that exact hostname.
Και οι δύο μέθοδοι επιλύουν το uid από το κλειδί που στέλνετε, όπως παντού αλλού, αλλά το agent_domain_connect επιλύει από αυτό και το app_id, και μόνο ένα κλειδί που δημιουργήθηκε από την καρτέλα API ενός έργου φέρει ένα. Αν την καλέσετε με κλειδί Λογαριασμού απαντά -1, 'no app is bound to this action', πριν καν κοιτάξει το domain. Δείτε την Πιστοποίηση για τα τρία πεδία κλειδιών.
Οδηγός βήμα προς βήμα
Καταγράψτε τα domain του λογαριασμού
Κανένα πεδίο πέρα από το κλειδί σας. Κάθε γραμμή είναι ένα domain που ο λογαριασμός κατοχύρωσε μέσω Xuda ή συνέδεσε εκχωρώντας τους nameservers του, ανεξάρτητα από το ποιο έργο (αν υπάρχει) δείχνει αυτή τη στιγμή, και το δικό του status.
2. Στρέψτε ένα στο έργο αυτού του κλειδιού
Το domain πρέπει να είναι ένα από τα ονόματα που επέστρεψε η προηγούμενη κλήση. Το subdomain είναι προαιρετικό και άσχετο με το όνομα του ίδιου του έργου του κλειδιού εφαρμογής, είναι μια ετικέτα στο domain ("app" για το app.example.com): παραλείψτε το για να στρέψετε αντ' αυτού το apex του domain. Η νέα εκτέλεση με διαφορετικό subdomain δεν διαταράσσει ένα hostname που έχετε ήδη συνδέσει, αντικαθίσταται μόνο η εγγραφή αυτού ακριβώς του hostname.
Η απάντηση
Το agent_domain_list περιορίζει κάθε αποθηκευμένο έγγραφο domain σε τέσσερα πεδία:
Το connection_type είναι registered για ένα domain που αγοράστηκε μέσω Xuda (το Xuda είναι ο καταχωρητής και το DNS) ή connected για ένα που κατοχυρώθηκε αλλού με τους nameservers του εκχωρημένους στο Xuda (Μόνο DNS, η κατοχύρωση μένει εκεί που ήταν). Και τα δύο λειτουργούν με τον ίδιο τρόπο για το agent_domain_connect.
Το agent_domain_connect απαντά με την εγγραφή DNS που έγραψε πραγματικά:
Το type εξαρτάται από το είδος έργου στο οποίο έχει πεδίο το κλειδί, όχι από κάτι που στέλνετε: ένα έργο VPS παίρνει εγγραφή A προς την IP του (ή AAAA σε ένα farm VM χωρίς δημόσια IPv4), όλα τα άλλα παίρνουν CNAME προς το δικό τους URL πρόσβασης του έργου. Κάθε εγγραφή περνά από proxy του Cloudflare (proxied: true), οπότε ο επισκέπτης παίρνει HTTPS στην άκρη με κάθε τρόπο. Το ssl_mode ορίζεται μόνο στη διαδρομή VPS, όπου το Xuda ελέγχει και ορίζει επίσης τη λειτουργία SSL προέλευσης της ζώνης (full, strict ή flexible): επιστρέφει null για στόχο CNAME, αφού το δικό του Universal SSL του Cloudflare καλύπτει την περίπτωση χωρίς ρύθμιση ζώνης προς αναφορά.