API VPS, tự động hóa máy chủ cloud bằng JSON REST

Có, API VPS miễn phí cho tất cả thành viên. Cấp khóa API và gửi yêu cầu đều miễn phí, máy chủ và các tùy chọn tạo bằng API được thanh toán với cùng giá như khi tạo trong bảng điều khiển. Bất kỳ thành viên nào đã thực hiện thanh toán đầu tiên đều có thể tạo khóa ngay trên trang khóa API.

Khi bạn thực hiện thanh toán đầu tiên, trang khóa API (/api-key) sẽ mở và bạn có thể tạo khóa tại đó. Đặt khóa vào tiêu đề Authorization của mỗi yêu cầu bằng cách sử dụng Bearer scheme. Khóa này mở khóa toàn bộ tài khoản của bạn, vì vậy đừng đưa nó vào kho mã; hãy giữ nó trong biến môi trường hoặc kho lưu trữ bí mật.

Đọc danh mục bán (GET /catalog), đọc danh sách máy chủ và thông tin một máy chủ (GET /servers, GET /servers/{id}), tạo máy chủ (POST /servers), bật, tắt và khởi động lại (start, stop, reboot), gia hạn một tháng (renew), xóa (DELETE /servers/{id}). Ví dụ yêu cầu và định dạng phản hồi có trong tài liệu API.

Một khóa gửi tối đa 300 yêu cầu mỗi phút. Vượt giới hạn sẽ trả về mã trạng thái 429 và lỗi rate_limited, nên trong script chỉ cần xử lý chờ một chút rồi gửi lại. Tự động hóa hằng ngày như xem danh sách máy chủ và quản lý nguồn hoạt động dư dả trong giới hạn này. Không tính phí theo số yêu cầu.

Khi yêu cầu POST /servers thành công, khoản thanh toán cho chu kỳ thanh toán bạn chọn sẽ được xử lý và máy chủ sẽ được tạo. Khoản thanh toán cho máy chủ không tạo thành công sẽ được hoàn lại vào số dư tài khoản của bạn.

Phản hồi của yêu cầu tạo máy chủ chứa giá trị root_password một lần. Nhận phản hồi là lưu ngay ở nơi an toàn. Trên bảng điều khiển cũng xem lại được trong 7 ngày, và gửi kèm số khóa SSH là kết nối ngay bằng khóa không cần mật khẩu. Bắt đầu kết nối SSH ngay bằng giá trị ipv4 trong phản hồi, rất tiện để nối với script triển khai.

Có, đưa số khóa SSH đã đăng ký vào giá trị ssh_key_id trong yêu cầu tạo máy chủ là khóa đó được đưa vào máy chủ mới. Đăng ký khóa một lần trên màn hình khóa SSH của bảng điều khiển, dấu vân tay hiển thị như ssh-keygen để nhận ra ngay khóa nào. Số khóa định một lần rồi dùng lại.

Gửi được yêu cầu HTTP là ngôn ngữ và công cụ nào cũng được. Thử ngay bằng curl, và gọi bằng cùng địa chỉ và tiêu đề từ requests của Python, fetch của Node.js, bước script của GitLab CI, chức năng yêu cầu HTTP của Terraform. Phản hồi đều là JSON nên dễ đọc kết quả.

Lỗi trả về dạng JSON chứa giá trị error kèm mã trạng thái không phải 2xx. Lý do được chia như khóa sai là unauthorized, thiếu giá trị là bad_request, thiếu số dư là not_enough_balance, yêu cầu không khớp trạng thái máy chủ là wrong_state để chương trình xử lý theo tình huống.

Có, API và bảng điều khiển làm việc với cùng tài khoản và cùng máy chủ. Máy chủ tạo bằng API hiện nguyên trong danh sách bảng điều khiển, và trên bảng điều khiển bạn cài lại hệ điều hành hay xem mật khẩu được. Giới hạn 10 máy chủ mỗi tài khoản áp dụng chung cho cả hai cách. Trộn thao tác tay và thao tác bằng mã thì trạng thái và ngày thanh toán vẫn luôn hiển thị như nhau.