API ảnh chụp nhanh

Liệt kê tất cả ảnh chụp nhanh

Trả lại những bức ảnh chụp trong tài khoản của bạn, mới nhất trước, 25 mỗi trang.

Cần quyền: snapshots:list

Ví dụ về yêu cầu

curl -X GET "https://admin.vps.org/api/v1/snapshots/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

import requests

url = "https://admin.vps.org/api/v1/snapshots/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}

response = requests.get(url, headers=headers)
for snapshot in response.json()["results"]:
    print(snapshot["uuid"], snapshot["label"], snapshot["ready"])

const response = await fetch('https://admin.vps.org/api/v1/snapshots/', {
  headers: { 'Authorization': 'Bearer YOUR_API_TOKEN' }
});

const data = await response.json();
console.log(data.results);

Ví dụ về câu trả lời

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b",
      "label": "before-upgrade",
      "server_hostname": "web-01",
      "ready": true,
      "deleting": false,
      "created_at": "2026-09-14T18:30:00.000000Z",
      "size_gb": 3.4
    }
  ]
}

Các trường phản hồi

Chụp ảnh

Trả lại một đối tượng chụp ảnh với các trường ở trên. Dùng nó để hỏi sẵn sàng sau khi tạo một bức ảnh chụp.

curl -X GET "https://admin.vps.org/api/v1/snapshots/3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Tạo một bức ảnh chụp

Đang xếp hàng một bức ảnh chụp của máy phục vụ đã triển khai và trả lại uuid của bức ảnh chụp mới. Bức ảnh chụp được liệt kê ngay lập tức với sẵn sàng được đặt là sai.

Cần quyền: servers:snapshot

Các tham số thân yêu cầu

curl -X POST "https://admin.vps.org/api/v1/servers/8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b/snapshot/" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "snapshot", "snapshot_label": "before-upgrade"}'

import requests

server_uuid = "8c4f2a1e-5b3d-4e6f-9a7b-1c2d3e4f5a6b"
url = f"https://admin.vps.org/api/v1/servers/{server_uuid}/snapshot/"
headers = {"Authorization": "Bearer YOUR_API_TOKEN"}
data = {"action": "snapshot", "snapshot_label": "before-upgrade"}

response = requests.post(url, headers=headers, json=data)
print(response.json()["snapshot_uuid"])

Ví dụ về câu trả lời

{
  "message": "Snapshot queued successfully",
  "snapshot_uuid": "3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b"
}

Mã trạng thái phản hồi

Xoá ảnh chụp

Đang xếp hàng để xóa vĩnh viễn bức ảnh chụp. xóa là đúng cho đến khi nó biến mất.

Cần quyền: snapshots:delete

curl -X DELETE "https://admin.vps.org/api/v1/snapshots/3f9a1c0e5b7d4e2f8a6c1b3d5e7f9a0b/" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "message": "Snapshot deletion queued"
}

Mã trạng thái phản hồi

Ghi chú

• Không thể phục hồi một bức ảnh chụp qua API. Sử dụng bảng điều khiển tại admin.vps.org.
• Để phục hồi thông qua API, hãy sử dụng một bản sao lưu thay vì vậy. API sao lưu