KehittäjätTaltiot ja liikenne

Taltiot, tallennustila ja liikenne

Pysyvät taltiot#

Kontin omat tiedostot korvataan jokaisessa julkaisussa. Kaikki, mitä sovelluksesi pitää säilyttää, kuten lataukset tai SQLite-tiedosto, kuuluu konttiin liitetylle taltiolle.

hw $API/applications/$APP/storages | jq

hw -X POST $API/applications/$APP/storages -d '{"type": "persistent", "name": "uploads", "mount_path": "/app/uploads"}'
hw -X POST $API/applications/$APP/start   # mounts it

Kutsu	Mitä se tekee
`GET /applications/{uuid}/storages`	`{persistent_storages, file_storages}`
`POST /applications/{uuid}/storages`	Lisää taltio (`type: persistent`, `name`, `mount_path`) tai tiedostoliitos (`type: file`, `mount_path`, `content`)
`PATCH /applications/{uuid}/storages`	Muuta yhtä (`uuid`:n perusteella)
`DELETE /applications/{uuid}/storages/{storage_uuid}`	Poista se ja sen data

Tiedostoliitokset sijoittavat antamasi tiedoston (esimerkiksi asetustiedoston) polkuun mount_path. Taltio sijaitsee yhdellä palvelimella: usealla kopiolla jokaisella palvelimella on omansa. Data, joka jokaisen kopion pitää nähdä, kuuluu hallinnoituun tietokantaan.

Taltioiden varmuuskopiot#

Varmuuskopioi taltio aikataulun mukaan ja säilytä tietty määrä arkistoja palvelimella:

hw -X PUT $API/applications/$APP/storages/$VOLUME/backups -d '{"frequency": "0 3 * * *", "retention_amount_locally": 7}'
hw -X POST $API/applications/$APP/storages/$VOLUME/backups/run   # one now
hw -X DELETE $API/applications/$APP/storages/$VOLUME/backups     # schedule and archives

frequency on cron-lauseke tai hourly, daily, weekly tai monthly.
stop_during_backup: true pysäyttää sovelluksen taltion arkistoinnin ajaksi, jotta käytössä olevista tiedostoista saadaan yhtenäinen kopio.
Jos haluat pitää arkistot myös palvelimen ulkopuolella, lisää S3-yhteensopiva bucket (POST /s3-storages) ja anna save_s3: true sekä sen s3_storage_uuid.

Tallennustaltiot#

Kun palvelimen oma levy on liian pieni, lisää siihen tallennustaltio: 10–1000 Gt lohkotallennustilaa, liitettynä palvelimella polkuun /mnt/volume-<id> ja laskutettuna tunneittain palvelimen tilauksella. Osoita sovelluksen taltio (host_path) tai tietokantavedos tähän polkuun.

SRV=$(hw $API/hostwolf/servers | jq -r '[.[] | select(.status == "ready")][0].uuid')   # a ready purchased server (app server or VPS)

hw "$API/hostwolf/servers/$SRV/volumes/offer?size_gb=50" | jq    # sizes allowed in its city and the price

# Without "confirm": true nothing is bought; the 422 answer has the price.
hw -X POST $API/hostwolf/servers/$SRV/volumes -H "Idempotency-Key: $(uuidgen)"   -d '{"size_gb": 50, "backups": true, "autogrow_max_gb": 200, "confirm": true}'

hw $API/hostwolf/servers/$SRV/volumes | jq '.[] | {id, status, size_gb, mount_path, monthly_price}'

Kutsu	Mitä se tekee
`GET /hostwolf/servers/{uuid}/volumes`	Palvelimen taltiot kokoineen, käyttöasteineen, varmuuskopioineen ja hintoineen
`GET /hostwolf/servers/{uuid}/volumes/offer`	Palvelimen kaupungissa sallitut koot ja koon `size_gb` hinta
`POST /hostwolf/servers/{uuid}/volumes`	Lisää taltio (`size_gb`, `backups`, `autogrow_max_gb`, `confirm`)
`PATCH /hostwolf/servers/{uuid}/volumes/{id}`	Suurenna sitä (`size_gb`), ota varmuuskopiot käyttöön tai pois käytöstä, aseta automaattisen kasvun raja
`POST /hostwolf/servers/{uuid}/volumes/{id}/detach`	Poista liitos ja irrota se palvelimesta
`DELETE /hostwolf/servers/{uuid}/volumes/{id}`	Poista se ja sen tiedostot
`GET /hostwolf/volumes`	Tiimin kaikki taltiot; `?status=detached` irrotetuille
`POST /hostwolf/volumes/{id}/attach`	Liitä irrotettu taltio palvelimeen samassa kaupungissa (`server_uuid`, `confirm`)

Hinta: määräytyy kaupungin palveluntarjoajan mukaan katalogin kautta. Vultr-kaupungeissa taltio maksaa 1,24 $ kuukaudessa 10 Gt:lta, 3,11 $ 25 Gt:lta ja 12,38 $ 100 Gt:lta, ja se laskutetaan tunneittain (kuukausihinta ÷ 730).
Vahvistus: uusi taltio, suurempi koko, varmuuskopioiden käyttöönotto ja automaattisen kasvun raja nostavat laskua, joten ne vaativat "confirm": true. Ilman sitä mikään ei muutu, ja 422-vastauksessa on confirm_required: true, luettava message ja hinta kentässä quote.
Suurentaminen tapahtuu käytön aikana: tiedostojärjestelmä kasvaa mukana, eikä mikään pysähdy. Taltioita ei voi pienentää; lisää sen sijaan pienempi taltio ja poista vanha.
Taltioiden muutokset on rajoitettu 10:een minuutissa yhdessä konsolin painikkeiden kanssa.

Automaattinen kasvu#

Aseta autogrow_max_gb, niin taltio kasvaa itsestään, kun se on 85-prosenttisesti täynnä: 25 %, vähintään 10 Gt, rajaasi asti. Tiedostojärjestelmä kasvaa käytön aikana, ja uusi koko laskutetaan siitä lähtien. 0 poistaa sen käytöstä.

Varmuuskopiot#

Öiset varmuuskopiot ovat oletuksena käytössä. Ne salataan, tallennetaan muualle Amsterdamiin ja säilytetään 7 päivää. Maksat niiden viemästä tilasta: 0,23 $ kuukaudessa 10 Gt:sta, 2,23 $ 100 Gt:sta.

hw $API/hostwolf/volumes/$VOL/backups | jq                                 # newest first
hw -X POST $API/hostwolf/servers/$SRV/volumes/$VOL/backups                  # one now
hw -X POST $API/hostwolf/servers/$SRV/volumes/$VOL/restore   -d '{"backup_id": "4f1c2a9b", "target": "new", "confirm": true}'

target: "same" palauttaa itse taltioon: varmuuskopion jälkeen kirjoitetut tiedostot poistetaan, eikä taltio ole käytettävissä ennen kuin palautus on valmis.
target: "new" palauttaa uuteen samankokoiseen taltioon samalla palvelimella, ja se laskutetaan kuten mikä tahansa taltio.
PATCH … {"backups": false} poistaa ne käytöstä; olemassa olevat varmuuskopiot poistetaan 7 päivän kuluttua.

Irrotus, liittäminen ja 7 päivän lisäaika#

Irrotus (POST …/detach) poistaa taltion liitoksen ja irrottaa sen palvelimesta. Taltio säilyttää tiedostonsa, ja sitä laskutetaan edelleen, kunnes liität sen uudelleen tai poistat sen. Pysäytä ensin kaikki, mikä kirjoittaa siihen.
Kun palvelin poistetaan, sen taltiot irrotetaan ja säilytetään 7 päivää maksutta. kept_until näyttää päivämäärän; sen jälkeen taltio ja sen tiedostot poistetaan.
Liitä irrotettu taltio mihin tahansa valmiiseen palvelimeesi samassa kaupungissa kutsulla POST /hostwolf/volumes/{id}/attach. Se liitetään samaan polkuun noin minuutissa. Poistetun palvelimen taltiota laskutetaan siitä lähtien taas, joten se vaatii "confirm": true.
Irrotetun taltion varmuuskopiot voi palauttaa uuteen taltioon toisella palvelimella samassa kaupungissa: POST /hostwolf/volumes/{id}/restore parametreilla backup_id, server_uuid ja confirm.
DELETE /hostwolf/volumes/{id} poistaa irrotetun taltion heti.

Liikenne#

Jokaiseen palvelimeen sisältyy 1 Tt lähtevää liikennettä kuukaudessa. Sen ylittävä jokainen Gt maksaa 0,01 $, ja summa lisätään kyseisen palvelimen laskuun. Saapuva liikenne on ilmaista.

hw $API/hostwolf/servers/$SRV/traffic | jq
# {"month": "2026-10", "outbound_bytes": 12400000000, "outbound": "12.4 GB", "included_bytes": 1000000000000,
#  "overage_bytes": 0, "price_per_gb": 0.01, "bill_so_far": 0, "sampled_at": "…"}

hw "$API/hostwolf/traffic?month=2026-09" | jq '.bill_so_far, .servers[].outbound'   # every server, any month

Liikenne luetaan 10 minuutin välein. Konsolin Analytiikka-sivu näyttää pyynnöt sovelluksittain.

Portti 25 (lähtevä sähköposti) on estetty kaikilla palvelimilla; lähetä sähköpostit palveluntarjoajan rajapinnan tai portin 587 kautta.

Jumissa, tai puuttuuko päätepiste? Kerro meille osoitteessa app.hostwolf.net/contact tai [email protected].