清单 - 云主机 - 云资源池 - CLI命令使用手册 - 产品手册 - ZStack Cloud 4.4.0

ZStack Cloud 4.4.0>产品手册>CLI命令使用手册>云资源池>云主机>清单

清单

属性

名字	描述	可选的	可选的参数值	起始支持版本
uuid	请参见资源属性			0.6
name	请参见资源属性			0.6
description	请参见资源属性	是		0.6
zoneUuid	所在区域的uuid，请参见区域(Zone) 和 location	是		0.6
clusterUuid	所在集群的uuid, 请参见集群(Cluster) 和 location	是		0.6
hostUuid	运行云主机当前的物理主机uuid, 请参见物理主机(Host) and location	是		0.6
lastHostUuid	上一次运行云主机的物理主机uuid, 请参见物理主机(Host)and location	是		0.6
imageUuid	用于创建云主机根云盘的镜像uuid，请参见镜像(Image)			0.6
instanceOfferingUuid	计算规格的uuid，请参见计算规格(Instance Offering)			0.6
rootVolumeUuid	云主机根云盘的uuid，请参见云盘(Volume)			0.6
defaultL3NetworkUuid	云主机默认L3网络的uuid，请参见 L3 network和 networks			0.6
cpuSpeed	VCPU速度, 请参见 CPU capacity			0.6
cpuNum	VCPU数目, 请参见 CPU capacity			0.6
allocatorStrategy	主机分配策略, 请参见 allocator strategy		DefaultHostAllocatorStrategy LastHostPreferredAllocatorStrategy LeastVmPreferredHostAllocatorStrategy MinimumCPUUsageHostAllocatorStrategy MinimumMemoryUsageHostAllocatorStrategy MaxInstancePerHostHostAllocatorStrategy	0.6
type	云主机类型 UserVm: 用户创建的云主机 ApplianceVm: ZStack创建的帮助管理云的云主机		UserVm ApplianceVm	0.6
hypervisorType	云主机的虚拟机管理程序类型, 请参见物理主机(Host)和 hypervisor type		KVM	0.6
state	云主机的可用状态, 请参见state		Created Starting Running Stopping Stopped Rebooting Destroying Destroyed Migrating Expunging Pausing Paused Resuming VolumeMigrating Unknown	0.6
vmNics	nic inventory			0.6
allVolumes	volume inventory			0.6
createDate	请参见资源属性			0.6
lastOpDate	请参见资源属性			0.6

示例

{
    "inventories":  {
            "agentPort": 7272,
            "allVolumes": [
                {
                    "actualSize": 293641216,
                    "createDate": "Oct 30, 2017 10:37:51 AM",
                    "description": "Root volume for VM[uuid:0f7730d25fff413d9ab42c174722c9d8]",
                    "deviceId": 0,
                    "format": "qcow2",
                    "installPath": "/zstack_ps/rootVolumes/acct-36c27e8ff05c4780bf6d2fa65700f22e/vol-1f9\
19d46bd7a43689b6401bf82b3e190/1f919d46bd7a43689b6401bf82b3e190.qcow2",
                    "isShareable": false,
                    "lastOpDate": "Oct 30, 2017 10:37:51 AM",
                    "name": "ROOT-for-vrouter.l3.私有云私有网络.ac5c7e",
                    "primaryStorageUuid": "2376c2874ae34e95a2309fa3453c547d",
                    "rootImageUuid": "bca9ad917cf3178281f27bc64d2dc96b",
                    "size": 8589934592,
                    "state": "Enabled",
                    "status": "Ready",
                    "type": "Root",
                    "uuid": "1f919d46bd7a43689b6401bf82b3e190",
                    "vmInstanceUuid": "0f7730d25fff413d9ab42c174722c9d8"
                }
            ],
            "allocatorStrategy": "LeastVmPreferredHostAllocatorStrategy",
            "applianceVmType": "vrouter",
            "clusterUuid": "175a8917ee794b849e4e96f0b680b717",
            "cpuNum": 2,
            "cpuSpeed": 0,
            "createDate": "Oct 30, 2017 10:37:51 AM",
            "defaultRouteL3NetworkUuid": "e315b2cb6151454bbab362a6e92909e7",
            "hostUuid": "232a730a0c9f4280803a8b0eddfebd77",
            "hypervisorType": "KVM",
            "imageUuid": "bca9ad917cf3178281f27bc64d2dc96b",
            "instanceOfferingUuid": "03a0a2b129f547b5bcb0745db8333390",
            "lastHostUuid": "232a730a0c9f4280803a8b0eddfebd77",
            "lastOpDate": "Oct 30, 2017 7:34:35 PM",
            "managementNetworkUuid": "e315b2cb6151454bbab362a6e92909e7",
            "memorySize": 2147483648,
            "name": "vrouter.l3.私有云私有网络.ac5c7e",
            "platform": "Linux",
            "publicNetworkUuid": "e315b2cb6151454bbab362a6e92909e7",
            "rootVolumeUuid": "1f919d46bd7a43689b6401bf82b3e190",
            "state": "Running",
            "status": "Connected",
            "type": "ApplianceVm",
            "uuid": "0f7730d25fff413d9ab42c174722c9d8",
            "vmNics": [
                {
                    "createDate": "Oct 30, 2017 10:37:51 AM",
                    "deviceId": 0,
                    "gateway": "10.0.0.1",
                    "ip": "10.58.22.43",
                    "l3NetworkUuid": "e315b2cb6151454bbab362a6e92909e7",
                    "lastOpDate": "Oct 30, 2017 10:37:51 AM",
                    "mac": "fa:08:2b:92:42:00",
                    "metaData": "3",
                    "netmask": "255.0.0.0",
                    "uuid": "bf1d8e2848fd48e39e71c9f859a2158b",
                    "vmInstanceUuid": "0f7730d25fff413d9ab42c174722c9d8"
                }
            ],
            "zoneUuid": "12489c7dce2b4e73811da4a1d38b53dc"
        }
}

位置（Location）

ZStack通过区域（zones）、集群（clusters）和物理主机（hosts）组织计算资源（computing resources），因此云主机的位置可以通过zoneUuid、 clusterUuid 和hostUuid标识。

当云主机开始运行后，这些UUIDs会被设置为标识云主机当前位置的值；
当云主机停止运行后， hostUuid会被设置为NULL，zoneUuid和clusterUuid会保持不变；
lastHostUuid比较特别，因为它代表了云主机上次运行的物理主机；
对于新创建的云主机， lastHostUuid被设置为NULL；
一旦云主机停止运行, lastHostUuid就被设置为之前的hostUuid值。

网络（Networks）

云主机可以有一个或多个L3网络；vm nics 包含了每个L3网络的IP地址、子网掩码和MAC地址信息。

如果一个云主机有不止一个L3网络，那么它必须设置一个默认的L3网络，这个网络提供默认的路由（routing)、 DNS 和物理主机名；
如果一个云主机只有一个L3网络，那么它就自动成为默认的L3网络。

下面的示例帮助理解什么是默认的L3网络。假设有一个如图 1所示的用户云主机：

云主机所连接的三个L3网络都提供SNAT服务，并且默认的L3网络是10.10.1.0/24：

CIDR: 10.10.1.0/24
Gateway: 10.10.1.1
DNS domain: web.tier.mycompany.com

那么云主机的路由表（routing table）将会是这样：

default via 10.10.1.1 dev eth0
10.10.1.0/24 dev eth0  proto kernel  scope link  src 10.10.1.99
192.168.0.0/24 dev eth1  proto kernel  scope link  src 192.168.0.10
172.16.0.0/24 dev eth2  proto kernel  scope link  src 172.16.0.55

可见，默认路由（default routing）指向了10.10.1.1，也就是默认L3网络的网关；同时云主机的/etc/resolv.conf如下所示：

search web.tier.mycompany.com
nameserver 10.10.1.1

就是说DNS域也是来自默认L3网络； DNS域名服务器（DNS name server）也是设置为10.10.1.1，因为默认L3网络提供了DNS服务器；最终，云主机的FQDN(Full Qualified Domain Name)看起来会像这样：

vm2.web.tier.mycompany.com

它是从DNS域扩展而来的。

云主机网络接口清单（VM Nic Inventory）

名字	描述	可选的	起始支持版本
uuid	请参见资源属性		0.6
vmInstanceUuid	父云主机的uuid		0.6
l3NetworkUuid	网卡所绑定的三层网络UUID		0.6
ip	IP地址		0.6
mac	MAC地址		0.6
netmask	子网掩码		0.6
gateway	网关		0.6
metaData	内部使用的保留域	是	0.6
deviceId	标识网卡在客户操作系统（guest operating system）以太网设备中顺序的整形数字。例如， 0通常代表eth0，1通常代表eth1。		0.6

示例

{
    "inventories": {
            "createDate": "Oct 30, 2017 5:06:34 PM",
            "deviceId": 0,
            "gateway": "192.168.13.1",
            "ip": "192.168.13.161",
            "l3NetworkUuid": "52d8509a19cc4e22a717163d9cb5ee61",
            "lastOpDate": "Oct 30, 2017 5:06:34 PM",
            "mac": "fa:c2:3d:d6:ff:00",
            "netmask": "255.255.255.0",
            "uuid": "e1e4dca977394741804c46a500fe3fa6",
            "vmInstanceUuid": "6db4a412ff764725a7e2077bedfff4e3"
        }
}

云盘（Volumes）

allVolumes域是由Volumes组成的列表，其中包含了根云盘（root volume）和数据云盘（data volumes）。如果要找出其中的根云盘，用户可以通过迭代这个列表，并检查云盘的类型或者使用域`rootVolumeUuid`来匹配云盘的UUID。根云盘会一直伴随云主机，直到云主机被删除。

虚拟机管理程序类型（Hypervisor Type）

根据云主机创建方式的不同，云主机的虚拟机管理程序类型可能是从镜像的虚拟机管理程序类型，或物理主机的虚拟机管理程序类型继承而来的。

从RootVolumeTemplate创建的虚拟机：
由于镜像中已经安装有操作系统，云主机会被创建在和镜像有相同虚拟机管理程序类型的物理主机上，因此云主机的虚拟机管理程序类型是从镜像继承而来的。
从ISO文件创建的虚拟机：
由于会使用ISO安装操作系统到云主机的空白根云盘上，云主机可能被创建在拥有任何类型的虚拟机管理程序的物理主机上，因此云主机的虚拟机管理程序类型是从创建的物理主机上继承而来的。

可用状态（State）

云主机的生命周期中有以下数种可用状态。

Created
在这种状态时，云主机还只是创建于数据库中的一个记录而已，并没有在任何物理主机上启动。这个状态仅在创建一个新的云主机的时候出现。
Starting
在这种状态时，云主机正在一个物理主机上启动。
Runnig
在这种状态时，云主机正在一个物理主机上运行。
Stopping
在这种状态时，云主机正在一个物理主机上停止过程中。
Stopped
在这种状态时，云主机已经停止，没有运行在任何物理主机上。
Rebooting
在这种状态时，云主机正在上次运行的物理主机上重启。
Destroying
在这种状态时，云主机正在被删除。
Destroyed
在这种状态时，云主机已经被删除。
Migrating
在这种状态时，云主机正在被迁移到另一个物理主机上。
Expunging
在这种状态时，云主机的数据库正在被删除。
Pausing
在这种状态时，云主机正在一个物理主机上暂停运行过程中。
Paused
在这种状态时，云主机已经暂停运行。
Resuming
在这种状态时，云主机正在从暂停状态恢复到运行状态的过程中。
VolumeMigrating
在这种状态时，云主机根云盘正在从本地存储迁移到其它物理主机。
Unknown
由于某些原因，例如，由于失去和物理主机的连接，ZStack不能检查物理主机的可用状态。

如图 2所示：

ZStack会使用VmTracer来周期性的跟踪云主机的状态；默认的间隔时间（interval）是60秒。云主机的状态可能会被ZStack之外的因素影响。

例如，物理主机掉电（power outage）会导致所有该物理主机上运行的云主机停止运行；一旦VmTracer检测到云主机的实际状态和数据库中的记录不匹配，数据库会被更新为实际的状态。
如果VmTracer不能成功检查云主机的状态，例如，由于ZStack管理节点和物理主机之间的连接丢失，云主机会被设置为Unknown状态；一旦VmTracer再次成功检测到云主机的状态，例如， ZStack管理节点和物理主机之间的连接恢复之后，云主机的状态也会被更新为实际的状态。

CDROM清单（VmCdRom inventory）

名字	描述	可选的	起始支持版本
uuid	请参见资源属性		3.3.0
name	请参见资源属性		3.3.0
description	请参见资源属性	是	3.3.0
deviceId	标识虚拟光驱在客户操作系统（guest operating system）中顺序的整形数字。例如， 0通常代表CDRO，1通常代表eth1。	是	3.3.0
isoInstallPath	在镜像服务器上的安装路径		3.3.0
isoUuid	ISO的UUID		3.3.0
vmInstanceUuid	云主机UUID		3.3.0
groupBy	以字段分组，相当于MySQL中的group by关键字。例如groupBy=type	是	3.3.0
createDate	请参见资源属性		3.3.0
lastOpDate	请参见资源属性		3.3.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.3.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.3.0

示例

{
    "inventories": [
        {
            "createDate": "Jan 15, 2019 4:59:25 PM",
            "deviceId": 0,
            "lastOpDate": "Jan 15, 2019 4:59:25 PM",
            "name": "vm-6e243d2edf8443a4968d3878a4fed2a6-cdRom",
            "uuid": "29f6e8c277a94e57bd0b7c627bd65e85",
            "vmInstanceUuid": "6e243d2edf8443a4968d3878a4fed2a6"
        }
    ],
    "success": true
}

云主机优先级配置清单(VmPriorityConfig Inventory)

名字	描述	可选的	起始支持版本
uuid	请参见资源属性		3.7.0
accountUuid	账号UUID		3.7.0
cpuShares			3.7.0
level	优先级级别		3.7.0
oomScoreAdj			3.7.0
groupBy	以字段分组，相当于MySQL中的group by关键字。例如groupBy=type	是	3.7.0
createDate	请参见资源属性		3.7.0
lastOpDate	请参见资源属性		3.7.0
userTags	用户标签，请参见创建用户标签(CreateUserTag)	是	3.7.0
systemTags	系统标签，请参见创建系统标签(CreateSystemTag)	是	3.7.0

示例

{
    "inventories": [
        {
            "cpuShares": 512,
            "createDate": "Oct 16, 2019 9:51:40 AM",
            "lastOpDate": "Oct 16, 2019 9:51:40 AM",
            "level": "Normal",
            "oomScoreAdj": 0,
            "uuid": "b29df0c34e874a1c83033a3cfe61f086"
        },
        {
            "cpuShares": 1024,
            "createDate": "Oct 16, 2019 9:51:40 AM",
            "lastOpDate": "Oct 16, 2019 9:51:40 AM",
            "level": "High",
            "oomScoreAdj": -900,
            "uuid": "c804903064f54e36b3a066be0cd24aef"
        }
    ],
    "success": true
}

下一章:操作（Operations）

学习路径

ZStack Cloud 产品学习路径

了解ZStack Cloud

ZStack Cloud 技术白皮书

ZStack Cloud 用户手册

新手快速入门

ZStack Cloud 快速安装使用教程（新手快速入门）

ZStack Cloud 升级教程

基础实践

ZStack Cloud CentOS7系统模板封装教程 ZStack Cloud Windows Server 2008 R2... ZStack Cloud CLI命令使用手册（基础命令） ZStack Cloud 存储部署教程 Shared Block-FC ZStack Cloud 存储部署教程 Shared Block-iSCSI ZStack Cloud 扁平网络使用教程

ZStack Cloud 专有网络VPC使用教程 ZStack Cloud 监控监控报警使用教程 ZStack Cloud 账户管理教程 ZStack Cloud 计费功能使用教程 ZStack Cloud 云主机高可用实践教程 ZStack Cloud 磁盘快照使用教程

进阶实验

ZStack Cloud 运维手册 ZStack Cloud CTL命令使用手册（高级命令） ZStack Cloud 多管理节点物理高可用教程 ZStack Cloud 企业管理使用教程 ZStack Cloud 网络QoS/磁盘QoS 使用教程 ZStack Cloud 亲和组使用教程 ZStack Cloud 弹性伸缩使用教程 ZStack Cloud vCenter环境管理指南

ZStack Cloud 迁移服务使用教程 ZStack Cloud 混合云使用教程 ZStack Cloud 灾备服务使用教程 ZStack Cloud 裸金属管理使用教程 ZStack Cloud 弹性裸金属管理使用教程 ZStack Cloud GPU设备透传使用教程 ZStack Cloud vGPU虚拟化使用教程 ZStack Cloud 资源编排使用教程

开发者资源

ZStack Cloud 开发手册

ZStack Cloud-CLI命令使用手册

常见问题

ZStack Cloud 产品学习路径

快速梳理文档，点击相应文本链接，快速跳转到相应文档的页面，学习 ZStack Cloud 产品。

我知道了

升级提醒

若您选择升级至4.0.0及之后版本，请注意以下功能调整：

1. 云路由器全面升级为VPC路由器，云路由网络全面升级为VPC网络，不再单独设云路由器页面。升级全程无感知，相关业务不受任何影响。

2. 企业管理账号体系取代用户组与用户，不再单独设用户/用户组页面，不可再使用用户/用户组账号登录云平台。升级前，请先将“用户组与用户”纳管的账号数据妥善迁移至“企业管理”纳管，再执行升级操作。注意：对于admin创建并具备admin权限的用户账号同步取消，如有需要，可使用企业管理账号体系中的平台管理员实现相同功能。

3. 调整AD/LDAP与账户的对接管理方式，统一由企业管理纳管，不再单独设AD/LDAP页面。升级前，请先将“账户”对接纳管的AD/LDAP账号数据妥善迁移至“企业管理”纳管，再执行升级操作。

如对上述升级提醒有任何疑问或需要升级帮助，请联系ZStack官方技术支持

下载ZStack企业版

您已填写过基本信息？点击这里

姓名姓名应该不少于两个字符

手机号手机号格式错误

验证码验证码填写错误获取短信验证码 60 秒后可重发

公司公司名称不应该少于4个字符

邮箱邮箱格式错误

下载链接将会通过邮件形式发送至您的邮箱，请谨慎填写。

下载ZStack企业版

还未填写过基本信息？点击这里

邮件或手机号码邮箱或手机号码格式错误账号不存在，请重新填写后提交

验证手机号

手机号手机号格式错误

验证码验证码填写错误获取短信验证码 60 秒后可重发

登录观看培训视频

仅对注册用户开放，请登录或填写资料观看培训视频

填写资料

商务咨询：

400-962-2212 转 1

售后咨询：

400-962-2212 转 2

商务联系：

sales@zstack.io

商务咨询：

400-962-2212 转 1

商务联系：

channel@zstack.io

商务咨询：

400-962-2212 转 1

售后咨询：

400-962-2212 转 2

商务联系：

sales@zstack.io

商务咨询：

400-962-2212 转 1

商务联系：

channel@zstack.io

商务咨询：

400-962-2212 转 1

商务联系：

channel@zstack.io

下载链接已发送至您的邮箱。

如未收到，请查看您的垃圾邮件、订阅邮件、广告邮件。当您收到电子邮件后，请点击 URL 链接，以完成下载。

下载链接已发送至您的邮箱。

如未收到，请查看您的垃圾邮件、订阅邮件、广告邮件。

或点击下方URL链接 (IE内核浏览器请右键另存为), 完成下载：

感谢您使用 ZStack 产品和服务。

成功提交申请。

我们将安排工作人员尽快与您取得联系。

感谢您使用 ZStack 产品和服务。

立即体验

联系我们

商务咨询

400-962-2212 转 1

售后咨询

400-962-2212 转 2

回到顶部

商务咨询：

400-962-2212 转 1

售后咨询：

400-962-2212 转 2

商务联系：

sales@zstack.io

成功提交申请。

我们将安排工作人员尽快与您取得联系。

感谢您使用 ZStack 产品和服务。

清单

属性

示例

位置（Location）

网络（Networks）

云主机网络接口清单（VM Nic Inventory）

示例

云盘（Volumes）

虚拟机管理程序类型（Hypervisor Type）

可用状态（State）

CDROM清单（VmCdRom inventory）

云主机优先级配置清单(VmPriorityConfig Inventory)

客户评论

撰写评论

产品

解决方案

支持

联系

咨询