Kaspersky Security for Virtualization 6.0 Light Agent

获取租户虚拟机列表

2024年1月25日

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 数据库中找不到具有指定标识符的租户。

Did you find this article helpful?
What can we do better?
Thank you for your feedback! You're helping us improve.
Thank you for your feedback! You're helping us improve.