Kaspersky Security for Virtualization 6.0 Light Agent

获取租户虚拟机列表

2024年8月2日

ID 259249

可让您获取所有已注册租户虚拟机的列表。

方法:

GET /api/2.0/virtualization/tenants/{租户 ID}/vms

其中:

{租户 ID} – Integration Server 数据库中的租户标识符(必需参数)。

如果请求成功,REST API 将返回虚拟机列表以及有关每个租户虚拟机的以下信息:

<vm id="{数据库中的 ID}" biosId={BIOS ID} created="{日期和时间}" updated="{日期和时间}">

<name>{名称}</name>

<userData><![CDATA[{其他信息}]]></userData>

</vm>

其中:

  • {数据库中的 ID} – Integration Server 数据库中分配给虚拟机的标识符。
  • {BIOS ID} – UUID 格式的虚拟机标识符 (BIOS ID)。
  • created="{日期和时间}" – Integration Server 数据库中注册虚拟机的日期和时间,格式为 YYYY-MM-DDThh:mm:ss。
  • updated="{日期和时间}" – Integration Server 数据库中更新虚拟机数据的日期和时间,格式为 YYYY-MM-DDThh:mm:ss。
  • {名称} – 虚拟机名称。
  • {其他信息} – Integration Server 数据库中存储的有关虚拟机的其他信息。

返回代码:

  • 200 (OK) – 请求成功完成。租户虚拟机的列表在响应中返回。
  • 403 (Forbidden) – 资源访问被拒绝。
  • 404 (Not Found) VIRMT_TenantWithSpecifiedIdNotFound – 在 Integration Server 数据库中找不到具有指定标识符的租户。

您觉得这篇文章有帮助吗?
我们可以做什么更好?
感谢您的反馈!你正在帮助我们进步。
感谢您的反馈!你正在帮助我们进步。