Quản lý Cloud VPS — Portal

Quản lý Cloud VPS: Danh sách, Thông tin chi tiết, Bảo mật, Quản lý, Hành động

Tổng quan

Quản lý Cloud VPS: Danh sách, Thông tin chi tiết, Bảo mật, Quản lý, Hành động

Danh sách: Danh sách Backup, Danh sách Cloud VPS, Danh sách Snapshot
Thông tin chi tiết: Chi tiết Cloud VPS, Thông tin Server VPS
Bảo mật: Lấy Private Key, Lấy SSH Key Pair, Reset mật khẩu VPS
Quản lý: Cập nhật ghi chú VPS, Cấu hình Auto Snapshot, Tạo Snapshot
Hành động: Reboot Hard VPS, Reboot Soft VPS, Shutdown VPS
Authentication: API key Bearer token qua header Authorization: Bearer YOUR_API_KEY

Base URL: https://developers-dev.inet.vn/api/gateway/v1

Response wrapper: Tất cả response được wrap trong { success, data, meta }. Response schema bên dưới mô tả nội dung field data. Xem chi tiết tại Response Format.

Danh sách

Danh sách Backup

GET /vps/{vpsId}/backup

Lấy danh sách backup volume của Cloud VPS.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/backup"

Danh sách Cloud VPS

GET /vps

Lấy danh sách Cloud VPS với bộ lọc và phân trang.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`name`	query	string	Không	Lọc theo tên VPS (để trống = tất cả)
`status`	query	string	Không	Lọc theo trạng thái: trial, active, suspended, expired
`page`	query	integer	Không	Số trang (bắt đầu từ 1)
`pageSize`	query	integer	Không	Số bản ghi mỗi trang

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps"

Response

JSON

{
  "size": 1,
  "number": 1,
  "content": [
    {
      "id": 1,
      "name": "example_name",
      "image": "example_image",
      "planId": 1,
      "status": "example_status",
      "planName": "example_planName",
      "roidType": "example_roidType",
      "trialDay": 1,
      "issueDate": "example_issueDate",
      "dataExtend": "example_dataExtend",
      "expireDate": "example_expireDate",
      "flagCpanel": true,
      "createdDate": "example_createdDate",
      "autoSnapshot": 1
    }
  ],
  "totalPages": 1,
  "totalElements": 1,
  "numberOfElements": 1
}

Trường	Kiểu	Mô tả
`size`	integer	Kích thước trang
`number`	integer	Trang hiện tại (0-based)
`content`	array	Danh sách Cloud VPS
`content[].id`	integer	ID Cloud VPS
`content[].name`	string	Tên VPS
`content[].image`	string	Tên OS image
`content[].planId`	integer	ID gói dịch vụ
`content[].status`	string	Trạng thái: trial, active, suspended, expired
`content[].planName`	string	Tên gói dịch vụ
`content[].roidType`	string	Loại dịch vụ (vps)
`content[].trialDay`	integer	Số ngày dùng thử (0 = không trial)
`content[].issueDate`	string	Ngày kích hoạt (dd/MM/yyyy HH:mm)
`content[].dataExtend`	string	JSON chứa thông số kỹ thuật VPS (CPU, RAM, disk, IP, volume...)
`content[].expireDate`	string	Ngày hết hạn (dd/MM/yyyy HH:mm)
`content[].flagCpanel`	boolean	Có cPanel hay không
`content[].createdDate`	string	Ngày tạo (dd/MM/yyyy HH:mm)
`content[].autoSnapshot`	integer	Số ngày auto snapshot (0 = tắt)
`totalPages`	integer	Tổng số trang
`totalElements`	integer	Tổng số bản ghi
`numberOfElements`	integer	Số phần tử trang hiện tại

Danh sách Snapshot

GET /vps/{vpsId}/snapshot

Lấy danh sách snapshot của Cloud VPS.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/snapshot"

Thông tin chi tiết

Chi tiết Cloud VPS

GET /vps/{vpsId}

Lấy thông tin chi tiết Cloud VPS theo ID.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}"

Response

JSON

{
  "id": 1,
  "name": "example_name",
  "note": "example_note",
  "image": "example_image",
  "planId": 1,
  "status": "example_status",
  "planName": "example_planName",
  "roidType": "example_roidType",
  "trialDay": 1,
  "issueDate": "example_issueDate",
  "dataExtend": "example_dataExtend",
  "expireDate": "example_expireDate",
  "flagCpanel": true,
  "createdDate": "example_createdDate",
  "autoSnapshot": 1
}

Trường	Kiểu	Mô tả
`id`	integer	ID Cloud VPS
`name`	string	Tên VPS
`note`	string	Ghi chú
`image`	string	Tên OS image
`planId`	integer	ID gói dịch vụ
`status`	string	Trạng thái: trial, active, suspended, expired
`planName`	string	Tên gói dịch vụ
`roidType`	string	Loại dịch vụ (vps)
`trialDay`	integer	Số ngày dùng thử (0 = không trial)
`issueDate`	string	Ngày kích hoạt (dd/MM/yyyy HH:mm)
`dataExtend`	string	JSON chứa thông số kỹ thuật VPS (CPU, RAM, disk, IP, volume...)
`expireDate`	string	Ngày hết hạn (dd/MM/yyyy HH:mm)
`flagCpanel`	boolean	Có cPanel hay không
`createdDate`	string	Ngày tạo (dd/MM/yyyy HH:mm)
`autoSnapshot`	integer	Số ngày auto snapshot (0 = tắt)

Thông tin Server VPS

GET /vps/{vpsId}/getserver

Lấy thông tin server (CPU, RAM, disk, IP) của Cloud VPS.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/getserver"

Response

JSON

{
  "id": "example_id",
  "name": "example_name",
  "flavor": {
    "ram": 1,
    "disk": 1,
    "vcpus": 1
  },
  "status": "example_status",
  "key_name": "example_key_name",
  "addresses": "example_addresses",
  "OS-EXT-STS:vm_state": "example_OS-EXT-STS:vm_state",
  "OS-EXT-STS:power_state": "example_OS-EXT-STS:power_state"
}

Trường	Kiểu	Mô tả
`id`	string	UUID server
`name`	string	Tên server
`flavor`	object	Cấu hình phần cứng
`flavor.ram`	integer	RAM (MB)
`flavor.disk`	integer	Disk (GB)
`flavor.vcpus`	integer	Số vCPU
`status`	string	Trạng thái (active, shutoff, error)
`key_name`	string	Tên SSH keypair
`addresses`	object	Địa chỉ IP theo network
`OS-EXT-STS:vm_state`	string	Trạng thái VM (active, stopped)
`OS-EXT-STS:power_state`	string	Trạng thái nguồn (1=running, 4=shutdown)

Bảo mật

Lấy Private Key

GET /vps/{vpsId}/privatekey

Lấy SSH private key của Cloud VPS.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`typeKey`	query	string	Có	Loại key: 'linux' (RSA PEM) hoặc 'windows' (PuTTY PPK format)

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/privatekey?typeKey=value"

Lấy SSH Key Pair

GET /vps/{vpsId}/keypair

Lấy SSH key pair của Cloud VPS.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/keypair"

Response

JSON

{
  "name": "example_name",
  "public_key": "example_public_key",
  "fingerprint": "example_fingerprint"
}

Trường	Kiểu	Mô tả
`name`	string	Tên SSH key pair
`public_key`	string	SSH public key (RSA format)
`fingerprint`	string	Fingerprint của SSH public key

Reset mật khẩu VPS

POST /vps/{vpsId}/password

Reset mật khẩu root/admin của Cloud VPS.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/password"

Quản lý

Cập nhật ghi chú VPS

PATCH /vps/{vpsId}/note

Cập nhật ghi chú cho Cloud VPS.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS

Request Body

Trường	Kiểu	Bắt buộc	Mô tả
`note`	string	Không	Nội dung ghi chú

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/note"

Response

JSON

{
  "id": 1,
  "note": "example_note",
  "modifiedDate": "example_modifiedDate"
}

Trường	Kiểu	Mô tả
`id`	integer	ID Cloud VPS
`note`	string	Ghi chú vừa cập nhật
`modifiedDate`	string	Thời điểm cập nhật ghi chú

Cấu hình Auto Snapshot

PATCH /vps/{vpsId}/auto-snapshot

Cấu hình tự động tạo snapshot định kỳ cho Cloud VPS.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS

Request Body

Trường	Kiểu	Bắt buộc	Mô tả
`autoSnapshot`	integer	Có	Số ngày tự động snapshot (0 = tắt, 3 = mỗi 3 ngày)

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/auto-snapshot"

Response

JSON

{
  "id": 1,
  "autoSnapshot": 1,
  "modifiedDate": "example_modifiedDate",
  "autoSnapshotDate": "example_autoSnapshotDate"
}

Trường	Kiểu	Mô tả
`id`	integer	ID Cloud VPS
`autoSnapshot`	integer	Số ngày auto snapshot đã cập nhật
`modifiedDate`	string	Thời điểm cập nhật
`autoSnapshotDate`	string	Ngày dự kiến tạo snapshot tiếp theo (dd/MM/yyyy HH:mm)

Tạo Snapshot

POST /vps/{vpsId}/snapshot

Tạo snapshot cho Cloud VPS.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/snapshot"

Tạo Volume

POST /vps/{vpsId}/volume

Tạo volume (ổ đĩa) mới cho Cloud VPS.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS

Request Body

Trường	Kiểu	Bắt buộc	Mô tả
`image`	string	Có	Tên image (VD: Ubuntu-22.04)

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image":"example_image"}' \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/volume"

Xóa Backup

DELETE /vps/{vpsId}/backup/{backupId}

Xóa backup volume của Cloud VPS.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS
`backupId`	path	string	Có	ID của backup

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/backup/{backupId}"

Xóa Snapshot

DELETE /vps/{vpsId}/snapshot/{snapshotId}

Xóa snapshot của Cloud VPS.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS
`snapshotId`	path	string	Có	ID của snapshot

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/snapshot/{snapshotId}"

Xóa Volume

DELETE /vps/{vpsId}/volume/{volumeId}

Xóa volume (ổ đĩa) của Cloud VPS.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS
`volumeId`	path	string	Có	ID của volume

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/volume/{volumeId}"

Hành động

Reboot Hard VPS

POST /vps/{vpsId}/reboot-hard

Khởi động lại Cloud VPS (hard reboot - ép buộc restart ngay lập tức).

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/reboot-hard"

Reboot Soft VPS

POST /vps/{vpsId}/reboot-soft

Khởi động lại Cloud VPS (soft reboot - gửi tín hiệu shutdown rồi start).

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/reboot-soft"

Shutdown VPS

POST /vps/{vpsId}/shutdown

Tắt Cloud VPS.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/shutdown"

Start VPS

POST /vps/{vpsId}/start

Bật Cloud VPS đang tắt.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/start"

URL Console VPS

GET /vps/{vpsId}/console

Lấy URL truy cập console (noVNC) của Cloud VPS.

Tham số	Vị trí	Kiểu	Bắt buộc	Mô tả
`vpsId`	path	string	Có	ID của VPS

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://developers-dev.inet.vn/api/gateway/v1/vps/{vpsId}/console"