文档中心知识库API Explorer
文档中心›ZCF›ZStack Cloud›探索更多›CLI命令使用手册ZCF
文档目录

VMware管理

概览

VMware管理：通过VMware提供的公开API接口纳管VMware vCenter，无缝集成VMware vCenter Server虚拟化管理平台部分功能，实现ZStack Cloud统一管理多虚拟化平台。若用户已在数据中心部署VMware vCenter Server，支持通过VMware管理功能纳管VMware vCenter，查看VMware vCenter Server所管理的vSphere服务器资源和虚拟机资源，能够在虚拟数据中心中使用VMware vSphere资源，并在VMware vCenter集群中完成对云主机的常用操作。

  • VMware管理以单独的功能模块形式提供，需提前购买VMware管理模块许可证，且需在购买云平台许可证基础上使用，不可单独使用。

  • 目前ZStack Cloud支持的vCenter版本包括：5.5、6.0、6.5、6.7、7.0、8.0。

相关定义

  • vSphere: VMware推出的一套完整的企业级虚拟化平台软件，支持将数据中心转换为包括计算、存储和网络资源的聚合计算基础架构。vSphere由多种软件应用组成，其中ESXi和vCenter为vSphere两大核心组件。
  • ESXi: Type 1 虚拟化hypersivor (Bemetal hypervisor)，直接安装在裸机物理服务器之上，支持在ESXi物理机上创建和管理多台虚拟机。
  • vCenter Server: VMware vCenter物理资源和虚拟资源集中式管理平台，支持一键式访问和管理ESXi物理机、虚拟机、Datastore和网络等资源。

外部访问原理

ZStack Cloud通过异步事件监听方式，发送云资源控制请求到vCenter，并接收返回的事件内容。ZStack Cloud支持接收vCenter主动推送的内容，实现双向信息同步功能。

ZStack Cloud管控vCenter逻辑图如图 1所示：
图 1. ZStack Cloud管控vCenter逻辑图


清单

vCenter清单（VCenter Inventory）

名字 描述 可选的 可选的参数值 起始支持版本
tagUuid 标签UUID 3.9.0
createDate 创建时间 3.9.0
description 对资源的详细描述 3.9.0
domainName 域名 3.9.0
groupBy 根据列或表达式的值将行分组到子组中。该字段相当于 MySQL 中的 Group By 子句，例如 groupBy=type。 3.9.0
https 是否启用 HTTPS 登录 3.9.0
lastOpDate 最后一次修改时间 3.9.0
name 名称 3.9.0
port 端口 3.9.0
state 状态 3.9.0
status 状态 3.9.0
systemTags 系统标签 3.9.0
userName 用户名 3.9.0
userTags 用户标签 3.9.0
uuid 资源UUID 3.9.0
version 版本 3.9.0
zoneUuid 区域UUID 3.9.0

示例

{
    "inventories": [
        {
            "createDate": "Nov 21, 2024 6:24:18 PM",
            "description": "",
            "domainName": "172.25.100.65",
            "https": true,
            "lastOpDate": "Feb 18, 2025 9:28:46 AM",
            "name": "VC-8.1",
            "port": 443,
            "state": "Enabled",
            "status": "Connected",
            "userName": "administrator@vsphere.local",
            "uuid": "f7e5d1a308814c4da76e1be644917e7b",
            "version": "8.0.2",
            "zoneUuid": "2187f079256a4ee7b75fa30f81847ff3"
        }
    ],
    "success": true
}

vCenterCluster 清单（VCenterCluster Inventory）

名字 描述 可选的 可选的参数值 起始支持版本
tagUuid 标签UUID 3.9.0
architecture 架构 3.9.0
createDate 创建时间 3.9.0
dataCenterUuid 数据中心UUID 3.9.0
description 对资源的详细描述 3.9.0
groupBy 根据列或表达式的值将行分组到子组中。该字段相当于 MySQL 中的 Group By 子句，例如 groupBy=type。 3.9.0
hypervisorType 虚拟机管理程序类型 3.9.0
lastOpDate 最后一次修改时间 3.9.0
morval morval 3.9.0
name 名称 3.9.0
state 状态 3.9.0
systemTags 系统标签 3.9.0
type 集群类型 3.9.0
userTags 用户标签 3.9.0
uuid 资源UUID 3.9.0
vCenterUuid vCenter UUID 3.9.0
zoneUuid 区域UUID 3.9.0
示例
{
    "inventories": [
        {
            "createDate": "Nov 21, 2024 6:24:21 PM",
            "dataCenterUuid": "137c93d03aa244469db3c56867b30416",
            "description": "from VCenter f7e5d1a308814c4da76e1be644917e7b",
            "hypervisorType": "ESX",
            "lastOpDate": "Nov 21, 2024 6:24:21 PM",
            "morval": "domain-c14",
            "name": "Cluster-1",
            "state": "Enabled",
            "type": "vmware",
            "uuid": "ba968534e0424b078da9945e00effec7",
            "vCenterUuid": "f7e5d1a308814c4da76e1be644917e7b",
            "zoneUuid": "2187f079256a4ee7b75fa30f81847ff3"
        }
    ],
    "success": true
}

vCenterPrimaryStorage清单（vCenterPrimaryStorage Inventory）

名字 描述 可选的 可选的参数值 起始支持版本
tagUuid 标签UUID 3.9.0
attachedClusterUuids 所属集群的UUID
availableCapacity 可用空间
availablePhysicalCapacity 物理可用空间
createDate 创建时间 3.9.0
datastore
description 对资源的详细描述 3.9.0
groupBy 以字段分组，相当于MySQL中的group by关键字。例如groupBy=type 3.9.0
lastOpDate 最后一次修改时间 3.9.0
mountPath 挂载路径
name 名称 3.9.0
state 状态 3.9.0
status 状态 3.9.0
systemTags 系统标签 3.9.0
systemUsedCapacity 系统使用空间
totalCapacity 总空间
totalPhysicalCapacity 总物理空间
type 种类
url 链接
userTags 用户标签 3.9.0
uuid 资源UUID 3.9.0
vCenterUuid vCenter UUID 3.9.0
zoneUuid 区域UUID 3.9.0

示例

        {
            "attachedClusterUuids": [],
            "availableCapacity": 119990648832,
            "availablePhysicalCapacity": 118475456512,
            "createDate": "Feb 18, 2025 9:28:44 AM",
            "datastore": "datastore-64",
            "lastOpDate": "Feb 18, 2025 9:28:46 AM",
            "mountPath": "VCenter",
            "name": "SSD-120G",
            "state": "Enabled",
            "status": "Connected",
            "totalCapacity": 119990648832,
            "totalPhysicalCapacity": 119990648832,
            "type": "VCenter",
            "url": "ds:///vmfs/volumes/6729cceb-c36f6dca-fdf6-ac1f6bedba22/",
            "uuid": "50b35920b4864e52b63fa3af78e055cc",
            "vCenterUuid": "f7e5d1a308814c4da76e1be644917e7b",
            "zoneUuid": "2187f079256a4ee7b75fa30f81847ff3"
        }

vCenterDatacenter 清单（vCenterDatacenter Inventory）

名字 描述 可选的 可选的参数值 起始支持版本
tagUuid 标签UUID 3.9.0
groupBy 根据列或表达式的值将行分组到子组中。该字段相当于 MySQL 中的 Group By 子句，例如 groupBy=type。 3.9.0
morval morval 3.9.0
name 名称 3.9.0
systemTags 系统标签 3.9.0
userTags 用户标签 3.9.0
uuid 资源UUID 3.9.0
vCenterUuid vCenter UUID 3.9.0

示例

 {
            "attachedZoneUuids": [
                "2187f079256a4ee7b75fa30f81847ff3"
            ],
            "availableCapacity": 110357381120,
            "createDate": "Nov 21, 2024 6:24:20 PM",
            "datastore": "datastore-24",
            "lastOpDate": "Feb 18, 2025 9:28:46 AM",
            "name": "datastore1 (2)",
            "state": "Enabled",
            "status": "Connected",
            "totalCapacity": 112474456064,
            "type": "VCenter",
            "url": "ds:///vmfs/volumes/670c89de-fd7d700e-ed94-ac1f6be46604/",
            "uuid": "14ae850f45504fa18d61d74761f5ed66",
            "vCenterUuid": "f7e5d1a308814c4da76e1be644917e7b"
        }

vCenterBackupStorage 清单（vCenterBackupStorage Inventory）

名字 描述 可选的 可选的参数值 起始支持版本
tagUuid 标签UUID 3.9.0
attachedZoneUuids 所属区域的UUID 3.9.0
availableCapacity 可用空间 3.9.0
createDate 创建时间 3.9.0
datastore 3.9.0
description 对资源的详细描述 3.9.0
groupBy 根据列或表达式的值将行分组到子组中。该字段相当于 MySQL 中的 Group By 子句，例如 groupBy=type。 3.9.0
lastOpDate 最后一次修改时间 3.9.0
name 名称 3.9.0
state 状态 3.9.0
status 状态 3.9.0
systemTags 系统标签 3.9.0
totalCapacity 系统总空间 3.9.0
type 类别 3.9.0
url 链接 3.9.0
userTags 用户标签 3.9.0
uuid 资源UUID 3.9.0
vCenterUuid vCenter UUID 3.9.0

示例

 {
            "attachedZoneUuids": [
                "2187f079256a4ee7b75fa30f81847ff3"
            ],
            "availableCapacity": 110357381120,
            "createDate": "Nov 21, 2024 6:24:20 PM",
            "datastore": "datastore-24",
            "lastOpDate": "Feb 18, 2025 9:28:46 AM",
            "name": "datastore1 (2)",
            "state": "Enabled",
            "status": "Connected",
            "totalCapacity": 112474456064,
            "type": "VCenter",
            "url": "ds:///vmfs/volumes/670c89de-fd7d700e-ed94-ac1f6be46604/",
            "uuid": "14ae850f45504fa18d61d74761f5ed66",
            "vCenterUuid": "f7e5d1a308814c4da76e1be644917e7b"
        }

vCenterResourcePool 清单（VCenterResourcePool Inventory）

名字 描述 可选的 可选的参数值 起始支持版本
CPULevel 3.9.0
CPULimit 3.9.0
CPUOverheadLimit 3.9.0
CPUReservation 3.9.0
CPUShares 3.9.0
tagUuid 标签UUID 3.9.0
createDate 创建时间 3.9.0
groupBy 根据列或表达式的值将行分组到子组中。该字段相当于 MySQL 中的 Group By 子句，例如 groupBy=type。 3.9.0
lastOpDate 最后一次修改时间 3.9.0
memoryLevel 3.9.0
memoryLimit 3.9.0
memoryOverheadLimit 3.9.0
memoryReservation 3.9.0
memoryShares 3.9.0
morval morval 3.9.0
name 名称 3.9.0
parentUuid 3.9.0
subResources 3.9.0
systemTags 系统标签 3.9.0
userTags 用户标签 3.9.0
uuid 资源UUID 3.9.0
vCenterClusterUuid 3.9.0

操作（Operations）

添加vCenter资源(AddVCenter)

用户可以使用AddVCenter添加vCenter资源。 例如：
AddVCenter username=11 password=22 zoneUuid=56963d0046b330839488e795b5109e44 name=333 domainName=www.vcenter.com

参数（Parameters）

名字 描述 可选的 可选的参数值 起始支持版本
username 登录 vCenter 用户名 0.6
password 登录 vCenter 用户密码 0.6
zoneUuid vCenter 将要添加至的目标区域UUID 0.6
name vCenter 的名称 0.6
https (可选) 是否启用 HTTPS 登录（默认开启） 是 0.6
domainName vCenter 域名 0.6
description vCenter 的详细描述 是 0.6
resourceUuid vCenter 的UUID。若指定，云主机会使用该字段值作为UUID。 是 0.6
systemTags 系统标签 是 0.6
userTags 用户标签 是 0.6
port 是 0.6

查询vCenter资源(QueryVCenter)

用户可以使用QueryVCenter查询vCenter资源。 例如：
QueryVCenter uuid=56963d0046b330839488e795b5109e44

原生域查询（Primitive Fields of Query）

请参见vCenter清单（VCenter Inventory）

删除vCenter资源(DeleteVCenter)

用户可以使用DeleteVCenter删除vCenter资源。 例如：
DeleteVCenter uuid=56963d0046b330839488e795b5109e44

参数（Parameters）

名字 描述 可选的 可选的参数值 起始支持版本
uuid vCenter 资源的UUID，唯一标示该资源。 0.6
deleteMode 删除模式(Permissive 或者 Enforcing, 默认 Permissive) 是 0.6
systemTags 系统标签 是 0.6
userTags 用户标签 是 0.6

更新vCenter资源(UpdateVCenter)

用户可以使用UpdateVCenter更新vCenter资源。 例如：
UpdateVCenter uuid=56963d0046b330839488e795b5109e44

参数（Parameters）

名字 描述 可选的 可选的参数值 起始支持版本
uuid vCenter 资源的UUID，唯一标示该资源。 2.3.2
name 资源名称 是 2.3.2
description 资源的详细描述 是 2.3.2
username 是 2.3.2
password 是 2.3.2
domainName 是 2.3.2
port 是 2.3.2
state vCenter 启用状态 是
  • Enabled
  • Disabled
 4.8.0
systemTags 是 2.3.2
userTags 是 2.3.2

同步vCenter资源(SyncVCenter)

用户可以使用SyncVCenter同步vCenter资源。 例如：
SyncVCenter uuid=56963d0046b330839488e795b5109e44

参数（Parameters）

名字 描述 可选的 可选的参数值 起始支持版本
uuid vCenter 资源的UUID，唯一标示该资源。 2.2
systemTags 系统标签 是 2.2
userTags 用户标签 是 2.2

查询vCenter集群(QueryVCenterCluster)

用户可以使用QueryVCenterCluster查询vCenter集群。 例如：
QueryVCenterCluster uuid=56963d0046b330839488e795b5109e44

原生域查询（Primitive Fields of Query）

请参见vCenterCluster 清单（VCenterCluster Inventory）

嵌套和扩展域查询（Nested And Expanded Fields of Query）

域 清单 描述 起始支持版本
host 物理机清单（Host Inventory）
l2Network 二层网络清单（L2Network Inventory）
l2VlanNetwork 二层Vlan 网络清单（L2VlanNetwork Inventory）
primaryStorage 主存储清单（primaryStorage Inventory）
vmInstance 云主机清单（vmInstance Inventory）
zone 区域清单（Zone Inventory）

查询vCenter主存储(QueryVCenterPrimaryStorage)

用户可以使用QueryVCenterPrimaryStorage查询vCenter主存储。 例如：
QueryVCenterPrimaryStorage uuid=56963d0046b330839488e795b5109e44

原生域查询（Primitive Fields of Query）

请参见vCenterPrimaryStorage清单（vCenterPrimaryStorage Inventory）

嵌套和扩展域查询（Nested And Expanded Fields of Query）

域 清单 描述 起始支持版本
cluster 集群清单（Cluster Inventory）
volume 云盘清单（Volume Inventory）
volumeSnapshot 云盘快照清单(VolumeSnapshot Inventory)
zone 区域清单（Zone Inventory）

查询vCenter镜像服务器(QueryVCenterBackupStorage)

用户可以使用QueryVCenterBackupStorage查询vCenter镜像服务器。 例如：
QueryVCenterPrimaryStorage uuid=56963d0046b330839488e795b5109e44

原生域查询（Primitive Fields of Query）

请参见vCenterBackupStorage 清单（vCenterBackupStorage Inventory）

嵌套和扩展域查询（Nested And Expanded Fields of Query）

域 清单 描述 起始支持版本
image 镜像清单（Image Inventory）
volumeSnapshot 快照组清单(VolumeSnapshotGroup Inventory)
zone 区域清单（Zone inventory）

查询vCenter资源池(QueryVCenterResourcePool)

用户可以使用QueryVCenterResourcePool查询vCenter资源池。 例如：
QueryVCenterResourcePool uuid=56963d0046b330839488e795b5109e44

原生域查询（Primitive Fields of Query）

请参见vCenterResourcePool 清单（VCenterResourcePool Inventory）

嵌套和扩展域查询（Nested And Expanded Fields of Query）

域 清单 描述 起始支持版本
usage
上一篇从云盘备份数据新建弹性裸金属实例(CreateBareMetal2InstanceFromVolumeBackup)下一篇云平台监控
CLI命令使用手册 | 5.5.30 | ZStack Cloud · ZCF | ZStack 资源中心