Kaspersky Security for Virtualization 5.x Light Agent

取得租戶虛擬機清單

2024年1月10日

ID 199649

可讓您取得所有已註冊租戶虛擬機的清單。

方法:

GET /api/2.0/virtualization/tenants/{tenant ID}/vms

其中:

{tenant ID} – Integration Server 資料庫中的租戶識別碼(必要參數)。

如果請求成功完成,REST API 會返回一個虛擬機清單,和每個租戶虛擬機的以下資訊:

<vm id="{資料庫中的 ID}" biosId={BIOS ID} created="{日期和時間}" updated="{日期和時間}">

<name>{name}</name>

<userData><![CDATA[{其他資訊}]]></userData>

</vm>

其中:

  • {ID in the database} – Integration Server 資料庫中分配給虛擬機的識別碼。
  • {BIOS ID} – UUID 格式的虛擬機識別碼(BIOS ID)。
  • created="{date and time}" – 虛擬機在 Integration Server 資料庫中註冊的日期與時間,格式為 YYYY-MM-DDThh:mm:ss。
  • updated="{date and time}" – 虛擬機資料在 Integration Server 資料庫中更新的日期與時間,格式為 YYYY-MM-DDThh:mm:ss。
  • {name} – 虛擬機名稱。
  • {additional information} – Integration Server 資料庫中儲存的虛擬機其他相關資訊。

返回代碼:

  • 200 (OK) – 請求成功完成。回應返回租戶虛擬機清單。
  • 403 (Forbidden) – 存取資源遭拒。
  • 404 (Not Found) VIRMT_TenantWithSpecifiedIdNotFound – 未在 Integration Server 資料庫中找到具有指定識別碼的租戶。

此文章對您有幫助嗎?
我們可以如何改善?
感謝您的意見回饋!您正協助我們改善。
感謝您的意見回饋!您正協助我們改善。