Siirry sisältöön

IPv4 Manager

Omat IPv4-osoitteet isännöimillesi kohteille.

Avaa IPv4 Manager
Tarkistettu koontinäyttöä vasten 18. marraskuuta 2026

Kaikelle, mitä IPv4 Manager tekee osoitteillesi, on metodi. Kaikki toimivat omalla tililläsi ja vaativat API-avaimesi. Jokainen kutsu on POST osoitteeseen /cpi/<method> JSON-rungolla, joka sisältää avaimen, ja vastaus on { "code": ..., "data": ... }. Kieltäytymisen code on negatiivinen ja data sisältää lauseen.

bash
curl -s https://xuda.ai/cpi/ipv4_list \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY"}'

Mitä kukin näkymä tekee kutsuna

Paketti valitaan kojelaudassa pakettien ikkunasta. Sillä ei ole julkista metodia.

Osoitteidesi lukeminen

ipv4_list vastaa listalla osoitteistasi osoitejärjestyksessä. Jokaisella on:

ipv4_pool_status vastaa kentillä available, coming_soon, prices tiloittain internal, external ja parked sekä caps, jotka pakettisi sallii kohdissa internal ja external. Lue se ennen ostoa: kun coming_soon on tosi, mikään ei ole myynnissä.

Osoitteen osto

Etsi, mihin se voi osoittaa

ipv4_attach_targets listaa VPS:si, käyttöönotot, datakeskukset ja kuormantasaajat, kullakin id, kind (vps, deployment, datacenter tai balancer) ja label. Workspace VPS ei ole koskaan uuden osoitteen kohde.

Osta se

ipv4_purchase ottaa kentät state (internal Xudassa olevalle asialle, external omalle palvelimellesi) ja target_id. Kohteelle internal anna listan id sekä sen kind ja label. Kohteelle external anna koneesi isäntänimi. Tilin oletuskortilta veloitetaan sen seuraavalla laskulla. Vastaus on uuden osoitteen rivi.

Nimeä se

ipv4_set_ptr ottaa kentät address ja ptr-isäntänimen.

curl -s https://xuda.ai/cpi/ipv4_purchase \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","state":"internal","target_id":"YOUR_TARGET_ID","kind":"vps","label":"My server"}'

curl -s https://xuda.ai/cpi/ipv4_set_ptr \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","address":"YOUR_ADDRESS","ptr":"mail.example.com"}'
const call = async (method, body) => {
  const res = await fetch(`https://xuda.ai/cpi/${method}`, {
    method: 'POST',
    headers: { 'content-type': 'application/json' },
    body: JSON.stringify({ api_key: 'YOUR_API_KEY', ...body }),
  });
  return res.json();
};

const bought = await call('ipv4_purchase', { state: 'internal', target_id: 'YOUR_TARGET_ID', kind: 'vps', label: 'My server' });
if (bought.code > 0) await call('ipv4_set_ptr', { address: bought.data.address, ptr: 'mail.example.com' });
import requests

def call(method, **body):
    res = requests.post(f'https://xuda.ai/cpi/{method}', json={'api_key': 'YOUR_API_KEY', **body})
    return res.json()

bought = call('ipv4_purchase', state='internal', target_id='YOUR_TARGET_ID', kind='vps', label='My server')
if bought['code'] > 0:
    call('ipv4_set_ptr', address=bought['data']['address'], ptr='mail.example.com')

Käänteinen DNS-nimi tallennetaan trimmattuna ja pienillä kirjaimilla, ja sen täytyy olla pisteellinen isäntänimi, kuten mail.example.com.

Siirtäminen, parkkeeraus ja vapauttaminen

  • ipv4_attach osoittaa hallussasi olevan osoitteen toiseen kohteeseen, target_type on internal tai external, ja vaihtaa sen tilan ja hinnan. Lasku suhteutetaan.
  • ipv4_park estää sitä tavoittamasta mitään ja säilyttää sen sinulle parkkihintaan.
  • ipv4_release palauttaa sen varantoon ja lopettaa laskutuksen. Vastauksessa on quarantine_until, päivä, jolloin se palaa varantoon. Sitä osoitetta et saa takaisin.

Kun kutsu evätään

data kertoo syyn. Tärkeät lauseet:

Laskutus tarkistetaan ennen kuin mitään varataan. Jos laskutusta ei voi päivittää oston jälkeen, varaus perutaan, joten evätty osto ei jätä osoitetta jälkeensä.

Yhteyden asetukset

ipv4_external_config vastaa kentillä mode, status ja note omalla palvelimellasi olevalle osoitteelle. Tällä hetkellä tila on pending: tunnelin ja edelleenlähetyksen asetusvaiheet eivät ole vielä valmiita, ja näkymä kertoo sen. Kutsu osoitteelle, joka ei osoita omalle palvelimellesi, evätään.

Millainen tämä opas on?

Päivitetty viimeksi 19. marraskuuta 2026