> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/vi/automation-api/api-tables-description.md).

# Mô tả các bảng API

Sau đây là mô tả ngắn gọn về từng bảng API. Để biết thêm chi tiết, thêm **/#swagger** vào cuối URL VergeUI của bạn (hoặc điều hướng đến **System->API Documentation**). Swagger cung cấp thông tin chi tiết về từng bảng và cho phép bạn kiểm tra từng phương thức với hành động Get/Post/Put/Delete. Để biết thêm hướng dẫn về cách tích hợp với API, hãy tham khảo [API Documentation](/knowledge-base/vi/automation-api/verge-api-guide.md) trang.

## Bảng API

### auth\_source\_states

Cung cấp danh sách các trạng thái nguồn xác thực.

### auth\_sources

Bảng nguồn ủy quyền để quản lý các nguồn ủy quyền như OpenID hoặc AzureAD.

### billing

Được dùng để lấy thông tin thanh toán cho môi trường hiện tại. Dữ liệu này được lưu dưới dạng dữ liệu thanh toán với ngày từ->đến.

### billing\_actions

Được dùng để gửi các hành động thanh toán. Hành động chính là "generate", hành động này tạo ra một hóa đơn mới.

* **Trường:**
  * **action** : Xem danh sách hành động bên dưới.
* **Hành động:**
  * **generate** : Tạo hóa đơn
* **Ví dụ:**

  ```plaintext
  URL: '/v4/billing_actions'
  POST(JSON): {"action": "generate"}
  ```

### catalog\_logs

Nhật ký cụ thể cho Catalog.

### catalog\_repositories

Các kho Catalog và danh sách con cho catalog, nhật ký, quyền, v.v.

### catalog\_repository\_actions

Được dùng để gửi các hành động của kho Catalog.

* **Trường:**
  * **repository** : ID hàng của kho bạn muốn làm mới.
  * **action** : Hành động mặc định là làm mới. Xem danh sách hành động bên dưới.
* **Hành động:**
  * **refresh** : Làm mới Kho Catalog.
* **Ví dụ:**

  ```plaintext
  URL: '/v4/catalog_repository_actions'
  POST(JSON): {"repository": 1, "action": "refresh"}
  ```

### catalog\_repository\_logs

Xem và đăng nhật ký Kho Catalog.

### catalog\_repository\_status

Được dùng để lưu và cập nhật trạng thái Kho Catalog. Những trạng thái này xác định trạng thái và tình trạng của một Kho Catalog.

### catalogs

Bảng Catalog cho phép bạn cập nhật/đăng/xóa Catalog.

### certificates

Chứng chỉ SSL cho trang web của bạn.

### clone\_iso

Lưu trữ thông tin và trạng thái của chương trình Clone ISO của Verge.io.

### clone\_iso\_actions

Các hành động cho tính năng Clone ISO.

* **Trường:**
  * **action** : Mặc định là "update." Xem danh sách hành động bên dưới.
* **Hành động:**
  * **update** : Cập nhật ảnh ISO.
  * **delete** : Xóa ảnh ISO.
  * **cancel** : Hủy bản dựng hiện tại.
* **Ví dụ:**

  ```plaintext
  URL: '/v4/clone_iso_actions'
  POST(JSON): {"action": "update"}
  ```

### cloud\_restore

Lưu trữ thông tin khi thực hiện Cloud Restore.

### cloud\_snapshot\_actions

Các hành động cho tính năng System Snapshot.

### cloud\_snapshot\_tenant\_actions

Các hành động cho tính năng System Snapshot dành cho Tenant.

### cloud\_snapshot\_tenants

System Snapshot cho Tenant.

### cloud\_snapshot\_vm\_actions

Các hành động cho VM và System Snapshot.

### cloud\_snapshot\_vms

Được dùng để lưu thông tin khi một System Snapshot được tải xuống VM.

### cloud\_snapshots

Bảng System Snapshot bao gồm thông tin về System Snapshot, cùng với danh sách các VM, Tenant và Sync Queue. Điều này có thể dùng để xem những VM nào được bao gồm trong một System Snapshot.

### cloudinit\_files

Các thao tác cho tính năng Cloudinit Files.

### cluster\_actions

Cluster Actions được dùng để gửi các hành động cho Cluster.

* **Trường:**
  * **cluster** : ID hàng của Cluster (bắt buộc).
  * **action** : Xem danh sách hành động bên dưới.
  * **params** : Các tham số được cung cấp ở dạng JSON (tùy chọn).
* **Hành động:**
  * **shutdown** : Tắt Cluster.
  * **cancel\_shutdown** : Hủy yêu cầu tắt hiện tại.
* **Ví dụ:**

  ```plaintext
  URL: '/v4/cluster_actions'
  POST(JSON): {"cluster": 1, "action": "shutdown", "params": "{}"}
  ```

### cluster\_stats\_history\_long

Bảng cluster\_stats\_history\_long lưu lịch sử thống kê Cluster trong thời gian dài.

### cluster\_stats\_history\_short

Bảng cluster\_stats\_history\_short lưu thống kê Cluster trong thời gian ngắn, lưu các thống kê gần nhất để truy cập nhanh.

### cluster\_status

Xử lý trạng thái của tất cả các cluster.

### cluster\_tier\_stats

Xử lý thống kê cho các tier vSAN của một cluster.

### cluster\_tier\_stats\_history\_long

Lưu thống kê lịch sử cho các Tier của Cluster trong thời gian dài.

### cluster\_tier\_stats\_history\_short

Lưu thống kê lịch sử cho các Tier của Cluster trong thời gian ngắn, lưu các thống kê gần nhất để truy cập nhanh.

### cluster\_tier\_status

Được dùng cho trạng thái Tier của Cluster.

### cluster\_tiers

Lưu danh sách các Tier cho cluster.

### clusters

Bảng chính cho dữ liệu về các Cluster.

### file\_actions

Bảng file\_actions gửi các hành động với tệp.

* **Trường:**
  * **file** : ID tệp từ bảng files (bắt buộc).
  * **action** : Xem danh sách hành động bên dưới.
  * **params** : Các tham số được cung cấp ở dạng JSON (tùy chọn).
* **Hành động:**
  * **overwrite** : Ghi đè tệp.
  * **add\_link** : Thêm liên kết tệp.
  * **delete\_link** : Xóa liên kết tệp.
  * **delete\_reference** : Xóa tham chiếu tệp.
* **Ví dụ:**

  ```plaintext
  URL: '/v4/file_actions'
  POST(JSON): {"file": 1, "action": "add_link", "params": "{}"}
  ```

### files

Thông tin liên quan đến các tệp đã lưu trữ.

### files\_public\_links

Xử lý các liên kết công khai cho tệp.

### group\_logs

Nhật ký liên quan đến nhóm.

### groups

Bảng quản lý nhóm.

### help\_actions

Xử lý các hành động liên quan đến trợ giúp.

### help\_search

Bảng tìm kiếm cho tài liệu trợ giúp.

### licenses

Xử lý giấy phép VergeOS.

### logs

Xử lý nhật ký hệ thống.

### machine\_console

Xử lý các tương tác với console của máy.

### machine\_console\_active

Theo dõi các phiên console máy đang hoạt động.

### machine\_console\_active\_chat

Theo dõi các tương tác chat trong các console máy đang hoạt động.

### machine\_device\_gpu\_stats\_history\_long

Lưu thống kê GPU lịch sử trong thời gian dài.

### machine\_device\_gpu\_stats\_history\_short

Lưu thống kê GPU lịch sử trong thời gian ngắn.

### machine\_device\_settings\_nvidia\_vgpu

Xử lý cài đặt cho thiết bị Nvidia vGPU.

### machine\_device\_settings\_tpm

Xử lý cài đặt cho thiết bị TPM.

### machine\_device\_stats

Theo dõi thống kê thiết bị.

### machine\_device\_status

Theo dõi trạng thái thiết bị.

### machine\_devices

Bảng thông tin thiết bị của máy.

### machine\_drive\_phys

Dữ liệu ổ đĩa vật lý cho máy.

### machine\_drive\_stats

Thống kê ổ đĩa cho máy.

### machine\_drive\_stats\_history\_long

Lưu thống kê ổ đĩa lịch sử trong thời gian dài.

### machine\_drive\_stats\_history\_short

Lưu thống kê ổ đĩa lịch sử trong thời gian ngắn.

### machine\_drive\_status

Theo dõi trạng thái ổ đĩa cho máy.

### machine\_drives

Bảng cho ổ đĩa máy.

### machine\_logs

Theo dõi nhật ký máy.

### machine\_nic\_stats

Thống kê NIC cho máy.

### machine\_nic\_stats\_history\_long

Thống kê NIC lịch sử trong thời gian dài.

### machine\_nic\_stats\_history\_short

Thống kê NIC lịch sử trong thời gian ngắn.

### machine\_nic\_status

Trạng thái NIC cho máy.

### machine\_nics

Bảng cho các NIC trong máy.

### machine\_snapshots

Theo dõi các snapshot của máy.

### machine\_stats

Thống kê chung cho máy.

### machine\_stats\_history\_long

Thống kê lịch sử cho máy trong thời gian dài.

### machine\_stats\_history\_short

Thống kê lịch sử cho máy trong thời gian ngắn.

### machine\_status

Theo dõi trạng thái cho máy.

### machines

Bảng chính cho dữ liệu máy.

***

{% hint style="info" %}
**Thông tin tài liệu**

* Cập nhật lần cuối: 2024-08-29
* Phiên bản vergeOS: 4.12.6
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/vi/automation-api/api-tables-description.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
