IPv4 Manager
Dedizierte IPv4-Adressen für das, was du hostest.
Alles, was der IPv4 Manager mit deinen Adressen tut, hat eine Methode. Alle handeln für dein eigenes Konto und brauchen deinen API-Schlüssel. Jeder Aufruf ist ein POST an /cpi/<method> mit einem JSON-Body, der den Schlüssel enthält, und die Antwort ist { "code": ..., "data": ... }. Eine Ablehnung hat einen negativen code und einen Satz in data.
Was jeder Bildschirm tut, als Aufruf
Der Tarif wird im Dashboard im Tarif-Fenster gewählt. Dafür gibt es keine öffentliche Methode.
Deine Adressen lesen
ipv4_list antwortet mit einer Liste deiner Adressen in Adressreihenfolge. Jede hat:
ipv4_pool_status antwortet mit available, coming_soon, den prices nach internal, external und parked und den caps, die dein Tarif für internal und external erlaubt. Lies es vor einem Kauf: Wenn coming_soon true ist, ist nichts im Verkauf.
Eine Adresse kaufen
Finden, worauf sie zeigen kann
ipv4_attach_targets listet deine VPS, Deployments, Datacenter und Load Balancer auf, jeweils mit einer id, einem kind (vps, deployment, datacenter oder balancer) und einem label. Ein Workspace VPS ist nie ein Ziel für eine neue Adresse.
Sie kaufen
ipv4_purchase nimmt state (internal für ein Ding bei Xuda, external für deinen eigenen Server) und target_id. Gib bei internal die id aus der Liste an, mit ihrem kind und label. Gib bei external den Hostnamen deiner Maschine an. Die Standardkarte des Kontos wird mit der nächsten Rechnung belastet. Die Antwort ist die Zeile der neuen Adresse.
Sie benennen
ipv4_set_ptr nimmt die address und einen ptr-Hostnamen.
Der Reverse-DNS-Name wird getrimmt und in Kleinbuchstaben gespeichert und muss ein Hostname mit einem Punkt sein, wie mail.example.com.
Verschieben, parken und freigeben
ipv4_attachlässt eine Adresse, die du hältst, auf ein anderes Ziel zeigen, mittarget_typeinternaloderexternal, und wechselt ihren Zustand und ihren Preis. Die Rechnung wird anteilig berechnet.ipv4_parkhindert sie daran, etwas zu erreichen, und behält sie für dich zum Parkpreis.ipv4_releasegibt sie an den Pool zurück und beendet die Abrechnung. Die Antwort hatquarantine_until, den Tag, an dem sie in den Pool zurückkehrt. Du bekommst diese Adresse nicht zurück.
Wenn ein Aufruf abgelehnt wird
data sagt warum. Die Sätze, auf die es ankommt:
Die Abrechnung wird geprüft, bevor etwas reserviert wird. Wenn die Abrechnung nach einem Kauf nicht aktualisiert werden kann, wird die Reservierung rückgängig gemacht, daher hinterlässt ein abgelehnter Kauf keine Adresse.
Verbindungseinrichtung
ipv4_external_config antwortet mit mode, status und note für eine Adresse auf deinem eigenen Server. Heute lautet der Status pending: Die Schritte zum Einrichten des Tunnels und der Weiterleitung sind noch nicht fertig, und der Bildschirm sagt das. Ein Aufruf für eine Adresse, die nicht auf deinen eigenen Server zeigt, wird abgelehnt.