ngine_io.cloudstack.cs_host 模块 – 管理基于 Apache CloudStack 云的宿主机。

注意

此模块是 ngine_io.cloudstack 集合 (版本 2.5.0) 的一部分。

如果您使用的是 ansible 软件包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install ngine_io.cloudstack。您需要其他要求才能使用此模块，有关详细信息，请参阅要求。

要在剧本中使用它，请指定： ngine_io.cloudstack.cs_host。

ngine_io.cloudstack 0.1.0 中的新增功能

摘要 

创建、更新和删除宿主机。

要求 

在执行此模块的主机上需要以下要求。

python >= 2.6
cs >= 0.9.0

参数 

参数	注释
allocation_state 字符串	宿主机分配状态。选项 `"enabled"` `"disabled"` `"maintenance"`
api_http_method 字符串	用于查询 API 端点的 HTTP 方法。如果没有给出，则考虑 `CLOUDSTACK_METHOD` 环境变量。选项 `"get"` ← (默认) `"post"`
api_key 字符串 / 必需	CloudStack API 的 API 密钥。如果没有给出，则考虑 `CLOUDSTACK_KEY` 环境变量。
api_secret 字符串 / 必需	CloudStack API 的密钥。如果未设置，则考虑 `CLOUDSTACK_SECRET` 环境变量。
api_timeout 整数	HTTP 超时时间（秒）。如果没有给出，则考虑 `CLOUDSTACK_TIMEOUT` 环境变量。默认： `10`
api_url 字符串 / 必需	CloudStack API 的 URL，例如 https://cloud.example.com/client/api。如果没有给出，则考虑 `CLOUDSTACK_ENDPOINT` 环境变量。
api_verify_ssl_cert 字符串	验证 CA 授权证书文件。如果没有给出，则考虑 `CLOUDSTACK_VERIFY` 环境变量。
cluster 字符串	集群名称。
host_tags 别名：host_tag 列表 / 元素=字符串	宿主机标签。
hypervisor 字符串	集群名称。如果 state=present 且宿主机尚不存在，则为必需。可能的值为 `KVM`、`VMware`、`BareMetal`、`XenServer`、`LXC`、`HyperV`、`UCS`、`OVM`、`Simulator`。
name 别名：ip_address 字符串 / 必需	宿主机名称。
password 字符串	宿主机密码。如果 state=present 且宿主机尚不存在，则为必需。
pod 字符串	Pod 名称。如果 state=present 且宿主机尚不存在，则为必需。
state 字符串	宿主机状态。选项 `"present"` ← (默认) `"absent"`
url 字符串	用于创建宿主机的宿主机 URL。如果未提供，则使用 `http://` 和参数 name 作为 URL。仅在 state=present 且宿主机尚不存在时才考虑。
username 字符串	宿主机用户名。如果 state=present 且宿主机尚不存在，则为必需。
validate_certs 布尔值 ngine_io.cloudstack 2.4.0 中新增	如果为 `false`，则不会验证 SSL 证书。如果没有给出，则考虑 `CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY` 环境变量。这只能在使用自签名证书的个人控制站点上使用。选项 `false` `true` ← (默认)
zone 字符串 / 必需	应在其中部署宿主机的区域名称。

注释 

注意

有关 cloudstack 模块的详细指南，请参见 CloudStack 云指南。
此模块支持检查模式。

示例 

- name: Ensure a host is present but disabled
  ngine_io.cloudstack.cs_host:
    name: pod01.zone01.example.com
    cluster: vcenter.example.com/zone01/cluster01
    pod: pod01
    zone: zone01
    hypervisor: VMware
    allocation_state: disabled
    host_tags:
    - perf
    - gpu

- name: Ensure an existing host is disabled
  ngine_io.cloudstack.cs_host:
    name: pod01.zone01.example.com
    zone: zone01
    allocation_state: disabled

- name: Ensure an existing host is enabled
  ngine_io.cloudstack.cs_host:
    name: pod01.zone01.example.com
    zone: zone01
    allocation_state: enabled

- name: Ensure a host is absent
  ngine_io.cloudstack.cs_host:
    name: pod01.zone01.example.com
    zone: zone01
    state: absent

返回值 

常见返回值已在此处记录此处，以下是此模块特有的字段

键	描述
allocation_state 字符串	宿主机分配状态。返回： success 示例： `"enabled"`
capabilities 字符串	宿主机功能。返回： success 示例： `"hvm"`
cluster 字符串	宿主机的集群。返回： success 示例： `"vcenter.example.com/zone/cluster01"`
cluster_type 字符串	宿主机集群的类型。返回： success 示例： `"ExternalManaged"`
cpu_allocated 字符串	当前分配的宿主机 CPU 百分比。返回： success 示例： `"166.25%"`
cpu_number 字符串	宿主机 CPU 数量。返回： success 示例： `"24"`
cpu_sockets 整数	宿主机CPU插槽数量。返回： success 示例： `2`
cpu_speed 整数	CPU速度（MHz）。返回： success 示例： `1999`
cpu_used 字符串	宿主机当前CPU使用量。返回： success 示例： `"33.6%"`
cpu_with_overprovisioning 字符串	应用cpu.overprovisioning.factor后的宿主机CPU数量。返回： success 示例： `"959520.0"`
created 字符串	宿主机创建日期。返回： success 示例： `"2015-05-03T15:05:51+0200"`
disconnected 字符串	宿主机断开连接日期。返回： success 示例： `"2015-05-03T15:05:51+0200"`
disk_size_allocated 整数	宿主机当前已分配的磁盘大小。返回： success 示例： `2593`
disk_size_total 整数	宿主机总磁盘大小。返回： success 示例： `259300`
events 字符串	宿主机可用的事件。返回： success 示例： `"Ping; HostDown; AgentConnected; AgentDisconnected; PingTimeout; ShutdownRequested; Remove; StartAgentRebalance; ManagementServerDown"`
gpu_group 列表 / 元素=字符串	宿主机上存在的GPU卡。返回： success 示例： `[]`
ha_host 布尔值	宿主机是否为高可用性(HA)主机。返回： success 示例： `false`
has_enough_capacity 布尔值	宿主机是否拥有足够的CPU和RAM容量来迁移虚拟机。返回： success 示例： `true`
host_tags 字符串	宿主机标签的逗号分隔列表。返回： success 示例： `"perf"`
host_type 字符串	宿主机类型。返回： success 示例： `"Routing"`
host_version 字符串	宿主机版本。返回： success 示例： `"4.5.2"`
hypervisor 字符串	宿主的虚拟化平台。返回： success 示例： `"VMware"`
hypervisor_version 字符串	虚拟化平台版本。返回： success 示例： `"5.1"`
ip_address 字符串	宿主机IP地址。返回： success 示例： `"10.10.10.1"`
is_local_storage_active 布尔值	本地存储是否可用。返回： success 示例： `false`
last_pinged 字符串	最后一次ping宿主机的时间。返回： success 示例： `"1970-01-17T17:27:32+0100"`
management_server_id 整数	宿主机的管理服务器ID。返回： success 示例： `345050593418`
memory_allocated 整数	宿主机当前已分配的内存量。返回： success 示例： `69793218560`
memory_total 整数	宿主机总内存量。返回： success 示例： `206085263360`
memory_used 整数	宿主机当前使用的内存量。返回： success 示例： `65504776192`
name 字符串	宿主机名称。返回： success 示例： `"esx32.example.com"`
network_kbs_read 整数	宿主机入站网络流量。返回： success 示例： `0`
network_kbs_write 整数	宿主机出站网络流量。返回： success 示例： `0`
os_category 字符串	宿主机操作系统类别名称。返回： success 示例： `"..."`
out_of_band_management 字符串	宿主机带外管理信息。返回： success 示例： `"..."`
pod 字符串	宿主机的Pod名称。返回： success 示例： `"Pod01"`
removed 字符串	宿主机移除的日期和时间。返回： success 示例： `"1970-01-17T17:27:32+0100"`
resource_state 字符串	宿主机的资源状态。返回： success 示例： `"Enabled"`
state 字符串	宿主机状态。返回： success 示例： `"Up"`
suitable_for_migration 字符串	该宿主机是否适合（拥有足够的容量并满足所有条件，例如主机标签、最大虚拟机数量限制等）迁移虚拟机。返回： success 示例： `"True"`
zone 字符串	宿主机的区域。返回： success 示例： `"zone01"`

作者

René Moser (@resmo)