跳至主内容

获取容器

此方法返回网络容器。如果 父级ID 不是容器或其内部不包含任何其他容器，则将返回空列表。

服务

此方法要求您将 {服务} 名称置于API URL中。允许的服务包括：

  • 计算机 （对应“计算机与虚拟机”）

  • 虚拟机 （对应“虚拟机”）

  • 移动设备 （对应“移动设备”）

例如， 移动设备 服务的请求URL为：

https://您的域名/api/v1.0/jsonrpc/network/mobile

参数

参数名

类型

可选

描述

parentId

字符串

是

容器ID。若为空，则返回指定服务类型的顶层容器。

viewType

数值

是

虚拟环境清单的视图类型ID。视图类型取决于虚拟化平台。在VMWare集成中可选值为：

  • 1 - 主机和集群视图（默认）

  • 2 - 虚拟机视图

在Citrix和XenServer集成中可选值为：

  • 3 - 服务器视图（默认）

  • 4 - 文件夹视图

返回值

该方法返回一个包含网络容器对象列表的数组。每个对象包含以下字段：

  • id - 容器ID

  • name - 容器名称

示例

请求 : 

{
       "params": {
           "parentId": "559bd17ab1a43d241b7b23c6",
           "viewType": 4
       },
       "jsonrpc": "2.0",
       "method": "getContainers",
       "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f"
  }

响应 : 

{
      "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f",
      "jsonrpc":"2.0",
      "result": [
              {
                  "id" : "5582c385b1a43deb7f7b23c6",
                  "name" : "Xen 服务器"
              } 
      ]
  }
本节内容 :