Volume & snapshot

Endpoint di halaman ini butuh storage:read (baca) atau storage:write (ubah).

Buat dan pasang volume

Buat volume di zona VM

curl -s -X POST "$LEVIA_API/volumes" \
  -H "Authorization: Bearer $LEVIA_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name": "data-1", "region_id": "'$REGION'", "zone_id": "'$ZONE'", "size_gb": 20, "tier": "ssd"}'

tier: hdd, ssd, atau ssd-performance. Volume ditagih per GB per bulan. Status creating sampai available.

Pasang ke VM

curl -s -X POST "$LEVIA_API/volumes/$VOL/attach" \
  -H "Authorization: Bearer $LEVIA_KEY" -H "Content-Type: application/json" \
  -d '{"vm_id": "'$VM'"}'

VM harus di zona yang sama dengan volume. Status attaching lalu in-use; device_path (mis. /dev/vdb) menunjukkan disk di dalam VM.

Format dan mount di dalam VM

Volume baru masih kosong. Buat filesystem dan mount dari dalam VM, mis. mkfs.ext4 /dev/vdb, lalu mount /dev/vdb /data.

Perbesar, lepas, hapus

Aksi	Endpoint	Catatan
Perbesar	`POST /volumes/{id}/resize` `{"size_gb": 40}`	Hanya bisa membesar. Volume yang terpasang diperbesar tanpa dilepas; perbesar filesystem dari dalam VM (mis. `resize2fs`).
Lepas	`POST /volumes/{id}/detach`	Unmount dulu di dalam VM supaya data aman. Status `detaching` lalu `available`.
Hapus	`DELETE /volumes/{id}`	Lepas dulu dan hapus snapshot-nya. Volume yang masih punya snapshot ditolak `409 volume_has_snapshots`.

Cari volume yang terpasang ke sebuah VM: GET /volumes?vm_id=….

Snapshot volume

curl -s -X POST "$LEVIA_API/volumes/$VOL/snapshots" \
  -H "Authorization: Bearer $LEVIA_KEY" -H "Content-Type: application/json" \
  -d '{"name": "sebelum-upgrade"}'

Jawaban 202; status provisioning sampai active. Volume yang terpasang di-quiesce sebentar.
Snapshot ditagih per GB yang benar-benar terpakai.
Daftar: GET /volumes/{id}/snapshots, atau GET /snapshots?source_type=volume&source_id=….

Restore ke volume baru

curl -s -X POST "$LEVIA_API/volumes/$VOL/snapshots/$SNAP/restore" \
  -H "Authorization: Bearer $LEVIA_KEY" -H "Content-Type: application/json" \
  -d '{"name": "data-1-restored"}'

Restore membuat volume baru di zona yang sama; volume sumber tidak diubah. size_gb opsional. Status volume baru restoring sampai available, lalu pasang seperti volume biasa.

Snapshot VM

Snapshot disk utama VM (opsional dengan volume terpasang, include_volumes: true) dibuat lewat POST /vms/{id}/snapshots. Lihat Siklus hidup VM.

Daftar dan hapus snapshot

GET /snapshots memuat snapshot VM dan volume, dengan filter source_type (vm/volume), source_id, region_id, status, dan name.

Hapus	Endpoint
Snapshot apa pun	`DELETE /snapshots/{id}`
Snapshot volume	`DELETE /volumes/{id}/snapshots/{snapshot_id}`

Jawaban 200 (status: "deleted") atau 202 (status: "deleting").

Mulai

Konsep dasar

Panduan produk

Lainnya

Buat dan pasang volume

Perbesar, lepas, hapus

Snapshot volume

Restore ke volume baru

Snapshot VM

Daftar dan hapus snapshot

​Buat dan pasang volume

​Perbesar, lepas, hapus

​Snapshot volume

​Restore ke volume baru

​Snapshot VM

​Daftar dan hapus snapshot

Buat dan pasang volume

Perbesar, lepas, hapus

Snapshot volume

Restore ke volume baru

Snapshot VM

Daftar dan hapus snapshot